Naar hoofdinhoud gaan
🔐 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.

​
Endpoint

U kunt logs naar AppSignal POST-en. Uw logs moeten geformatteerd zijn in NDJSON en naar het volgende endpoint worden gestuurd: 
https://appsignal-endpoint.net/logs/json?api_key=YOUR_LOG_SOURCE_API_KEY

​
NDJSON

Ons HTTP-JSON-endpoint verwacht dat de logs in een NDJSON-formaat naar ons endpoint worden gestuurd. NDJSON staat voor Newline Delimited JSON, wat betekent dat elke logregel zijn eigen JSON-object is, bijvoorbeeld: 
{"timestamp": "2022-06-02T04:17:25.783Z", "message": "foo", [...]}
{"timestamp": "2022-06-02T04:17:26.000Z", "message": "bar", [...]}

​
Vereiste gegevens

Hieronder staat een voorbeeld van een (verfraaid) NDJSON-bericht. U kunt meer lezen over de gegevens die AppSignal vereist in de sectie Vereiste velden.

​
Voorbeeldbericht

Waarschuwing: Dit is geformatteerd met nieuwe regels voor de leesbaarheid. Uw client moet de logregel als één regel versturen, zonder nieuwe regels.
{
  "timestamp": "2022-06-02T04:17:25.783Z",
  "group": "organisations",
  "severity": "warn",
  "message": "This is a test message",
  "hostname": "frontend1",
  "attributes": {
    "org": "appsignal",
    "step": 1,
    "seen_terms": true,
    "entries": 10.01
  }
}

​
Vereiste velden

AppSignal zal stilzwijgend elk bericht negeren dat niet de hieronder vereiste velden of onjuiste waarden bevat.
De NDJSON-payload die u naar AppSignal stuurt, moet de volgende velden bevatten:

​
timestamp

Een RFC 3339-geformatteerde tijdstempel met een nanoseconde-precisie van 3 cijfers.
YAML
YYYY-MM-DDThh:mm:ss.sss
2022-01-12T07:20:50.520Z

​
group

String van één woord waarmee de gebruiker logregels op een bepaalde context kan scheiden (bijv. logs voor een specifiek deel van uw applicatie, group kan “admin”, “payments”, “database” of “background” zijn).

​
severity

Het severity-veld accepteert de volgende waarden: unknown, trace, debug, info, notice, warn, error, critical, alert en fatal.

​
message

Plaintext-bericht.

​
hostname

Hostname van de server die het bericht verstuurt.

​
Optionele velden

De volgende velden zijn optioneel maar worden aanbevolen voor rijkere loggegevens:

​
attributes

Attributen die kunnen worden gebruikt om het bericht te filteren of doorzoeken, met de volgende regels:
  • Attributen kunnen niet genest zijn of arrays bevatten
  • De maximale sleutelgrootte is 50 tekens
  • Het maximale aantal attributen is 100
  • De volgende primitieven worden als waarden geaccepteerd:
    • String: idealiter gebruikt als “tags”, bijv. waarden van één woord, met een maximum van 100 tekens
    • Integer: 10
    • Double: 0.01
    • Boolean: true/false

​
format

Overschrijft het geconfigureerde formaat van de logbron bij het parsen van het message. Accepteert plaintext, logfmt, json of autodetect; onbekende waarden worden genegeerd.