Endpunkt
Sie können Logs perPOST an AppSignal senden. Ihre Logs müssen im NDJSON-Format formatiert und an den folgenden Endpunkt gesendet werden:
NDJSON
Unser HTTP-JSON-Endpunkt erwartet, dass die Logs imNDJSON-Format an unseren Endpunkt gesendet werden.
NDJSON steht für Newline Delimited JSON, was bedeutet, dass jede Log-Zeile ein eigenes JSON-Objekt ist, zum Beispiel:
Erforderliche Daten
Unten sehen Sie ein Beispiel einer (formatierten)NDJSON-Nachricht. Mehr über die von AppSignal benötigten Daten erfahren Sie im Abschnitt Erforderliche Felder.
Beispielnachricht
Erforderliche Felder
DieNDJSON-Payload, die Sie an AppSignal senden, muss die folgenden Felder enthalten:
timestamp
Ein nachRFC 3339 formatierter Zeitstempel mit 3-stelliger Nanosekundengenauigkeit.
YAML
group
Eine einwortige Zeichenkette, mit der der Benutzer Log-Zeilen nach einem bestimmten Kontext trennen kann (z. B. Logs für einen bestimmten Teil Ihrer Anwendung; group könnte “admin”, “payments”, “database” oder “background” sein).severity
Das Feld severity akzeptiert die folgenden Werte:unknown, trace, debug, info, notice, warn, error, critical, alert und fatal.
message
Plaintext-Nachricht.
hostname
Hostname des Servers, der die Nachricht sendet.Optionale Felder
Die folgenden Felder sind optional, werden aber für umfangreichere Log-Daten empfohlen:attributes
Attribute, die zum Filtern oder Suchen der Nachricht verwendet werden können, mit den folgenden Regeln:- Attribute dürfen nicht verschachtelt sein oder Arrays enthalten
- Die maximale Schlüssellänge beträgt
50Zeichen - Die maximale Anzahl an Attributen beträgt
100 - Die folgenden Primitive werden als Werte akzeptiert:
- String: idealerweise als “Tags” verwendet, z. B. einwortige Werte, mit maximal
100Zeichen - Integer:
10 - Double:
0.01 - Boolean:
true/false
- String: idealerweise als “Tags” verwendet, z. B. einwortige Werte, mit maximal
format
Überschreibt das konfigurierte Format der Log-Quelle beim Parsen dermessage. Akzeptiert plaintext, logfmt, json oder autodetect; unbekannte Werte werden ignoriert.