;
};
Deze documentatie beschrijft hoe u logging configureert met de AppSignal for Node.js-integratie.
## Logging configureren
🔐 Stuur geen Persoonlijk Identificeerbare Informatie (PII) naar AppSignal. Filter PII (bijv. namen, e-mailadressen) uit logs en gebruik in plaats daarvan een ID, hash of gepseudonimiseerde identificator.
Voor **onder HIPAA vallende entiteiten** vindt u meer informatie over het ondertekenen van een Business Associate Agreement (BAA) in onze [documentatie over Business Add-Ons](/support/business-add-ons).
U hoeft geen logbron aan te maken om logs te versturen vanuit de AppSignal for Node.js-integratie. Er wordt automatisch een "application"-logbron aangemaakt.
### Zelfstandig gebruik
Om de logger te gebruiken, moet u AppSignal importeren en de logger instellen met de functie `.logger()`.
De functie `.logger()` accepteert twee argumenten: `group` en optioneel `severityThreshold`. Als `severityThreshold` niet wordt opgegeven, is de standaardwaarde `info`.
```javascript Node.js theme={null}
const { Appsignal } = require("@appsignal/nodejs");
const logger = Appsignal.logger("app");
// with a severity threshold:
const logger = Appsignal.logger("app", "info");
```
Er zijn zes severity-niveaus beschikbaar: `trace`, `debug`, `info`, `log`, `warn` en `error`, elk met zijn eigen functie met dezelfde naam. Deze functies accepteren twee argumenten: `message` en `attributes`. Attributes wordt gebruikt voor metadata en is optioneel.
Berichten worden alleen gelogd als hun severity-niveau boven de severity-drempel ligt.
```javascript Node.js theme={null}
logger.info("Log message line");
logger.debug("User logged in", { user_id: 123 });
```
Houd er rekening mee dat als de severity van het bericht onder de severity-drempel ligt die is ingesteld bij het initialiseren van de logger, het niet naar AppSignal wordt verstuurd.
U kunt op berichtinhoud en attribuutwaarden filteren en opvragen met behulp van onze [zoeksyntaxis](/logging/query-syntax).
#### Meerdere logging-backends gebruiken
Het is momenteel niet mogelijk om logs naar meerdere backends te sturen met de standaard logger van Node.js. Voor complexere opstellingen raden wij u aan een logging-bibliotheek zoals Winston of Pino te gebruiken.
### Gebruik met Winston
Als u Winston gebruikt om berichten in uw applicatie te loggen, kunt u onze Winston-transport gebruiken om die logs naar AppSignal te sturen. Nadat u de transport vanuit de AppSignal-integratie hebt geïmporteerd, voegt u deze toe aan de lijst met transports in uw Winston-logger:
```javascript Node.js theme={null}
const winston = require("winston");
const { WinstonTransport } = require("@appsignal/nodejs");
const logger = winston.createLogger({
transports: [new WinstonTransport({ group: "app" })],
});
```
#### Child Logger
U kunt een child logger gebruiken om aanvullende tags aan logberichten toe te voegen. U definieert tags bij het aanmaken van de child logger-constante of geeft tags als metadata door bij het schrijven van een logbericht. Stel dat wij meer context willen in onze logs van de acties van een bepaalde gebruiker binnen een specifieke sessie. In het onderstaande voorbeeld wordt een child logger voor de `background`-groep gebruikt om `sessionID` toe te voegen met de aanvullende tags `drinkID` en `paymentID` die als metadata worden verstrekt bij het aanmaken van een logbericht, en als een groep aan de child wordt meegegeven, overschrijft die de groep die in de transport is ingesteld.
```javascript Node.js theme={null}
const logger = winston.createLogger({...});
const sessionLogger = logger.child({
group: "background",
sessionID: user.id,
});
sessionLogger.debug("User logged in");
sessionLogger.info("User ordered coffee", { drinkID: 30, paymentID: 20082 });
sessionLogger.debug("User logged out");
```
#### Meerdere logging-backends gebruiken
Om logs naar zowel de logger van AppSignal als naar `STDOUT` te sturen, voegt u nog een transport toe:
```javascript JavaScript theme={null}
const winston = require("winston");
const { WinstonTransport } = require("@appsignal/nodejs");
const logger = winston.createLogger({
transports: [
new WinstonTransport({ group: "app" }),
new winston.transports.Console(),
],
});
```
### Gebruik met Pino
Als Pino uw voorkeur logging-bibliotheek is, kunt u de AppSignal Pino-transport gebruiken om logs naar AppSignal te sturen.
Het group-argument is standaard "app" als het niet wordt opgegeven.
```javascript Node.js theme={null}
import pino from "pino";
const logger = pino({
transport: {
targets: [
{ target: "@appsignal/nodejs/pino", options: { group: "my-group" } }
],
},
});
```
#### Meerdere logging-backends gebruiken
Om logs naar zowel de logger van AppSignal als naar `STDOUT` te sturen, voegt u nog een target toe:
```javascript Node.js theme={null}
import pino from "pino";
const logger = pino({
transport: {
targets: [
{ target: "@appsignal/nodejs/pino", options: { group: "my-group" } },
{ target: 'pino/file', options: {destination: 1} }
],
},
});
```
## Formaten
### Automatisch gedetecteerd formaat
Het AppSignal for Node.js-pakket detecteert het formaat van de logregel standaard automatisch als JSON, Logfmt of plaintext en parseert er attributen uit.
U hoeft het logformaat niet handmatig in te stellen, tenzij het niet correct wordt gedetecteerd.
[Laat het ons ook weten](mailto:support@appsignal.com?subject=Log%20format%20auto%20detection%20not%20working) als dit niet automatisch werkt.
```javascript Node.js theme={null}
const { Appsignal } = require("@appsignal/nodejs");
// Plaintext format
const logger = Appsignal.logger("app", "info");
logger.info("This is about the blog");
// Logfmt format
const logger = Appsignal.logger("app", "info");
logger.info("category=blog This is about the blog");
// JSON format
const logger = Appsignal.logger("app", "info");
logger.info('{"category": "blog", "message": "This is about the blog"}');
```
### Logfmt
De AppSignal Logger kan expliciet worden geconfigureerd om te verwachten dat de regel in Logfmt-formaat is en hier attributen uit te parsen.
Gebruik deze optie wanneer u een oudere versie van het AppSignal for Node.js-pakket gebruikt die geen [automatische formaatdetectie](#auto-detected-format) ondersteunt.
Het logformaat kan worden opgegeven bij het aanmaken van een logger.
Geef bij het initialiseren van de AppSignal-logger de waarde `"logfmt"` als derde argument door.
```javascript Node.js theme={null}
const { Appsignal } = require("@appsignal/nodejs");
const logger = Appsignal.logger("app", "info", "logfmt");
logger.info("category=blog this is about the blog");
```
In het bovenstaande voorbeeld wordt een filterbaar category-attribuut met de waarde "blog" gelogd.
### JSON
De AppSignal Logger kan expliciet worden geconfigureerd om te verwachten dat de regel in JSON-formaat is en hier attributen uit te parsen.
Gebruik deze optie wanneer u een oudere versie van het AppSignal for Node.js-pakket gebruikt die geen [automatische formaatdetectie](#auto-detected-format) ondersteunt.
Het logformaat kan worden opgegeven bij het aanmaken van een logger.
Geef bij het initialiseren van de AppSignal-logger de waarde `"json"` als derde argument door.
```javascript Node.js theme={null}
const { Appsignal } = require("@appsignal/nodejs");
const logger = Appsignal.logger("app", "info", "json");
logger.info('{"category": "blog", "message": "this is about the blog"}');
```
In het bovenstaande voorbeeld wordt een filterbaar category-attribuut met de waarde "blog" gelogd.
## Logs filteren
U kunt [de configuratieoptie `ignoreLogs`](/nodejs/3.x/configuration/options#option-ignorelogs) gebruiken om logregels op basis van hun bericht te negeren. Zie [onze gids Logs negeren](/guides/filter-data/ignore-logs) voor meer informatie.
## Hulp nodig?
Nadat u uw Node.js-applicatie hebt geconfigureerd om logs te versturen, zouden er logs in AppSignal moeten verschijnen. Als u twijfelt over deze stap of AppSignal geen logs ontvangt, kunt u altijd [contact opnemen](mailto:support@appsignal.com) voor hulp. Wij helpen u graag weer op weg!