Skip to main content
Möchten Sie das Beste aus Ihren Logs herausholen? Lesen Sie unseren Learning-Center-Artikel zu Best Practices beim Logging für weitere Informationen zur richtigen Nutzung der Logs Ihrer Anwendung.
Die besten Logs sind beschreibend, kontextbezogen und prägnant. Attribute ermöglichen es Ihnen, wichtige kontextbezogene Informationen aus den Logs Ihrer Anwendung schnell zu speichern, abzufragen und zu filtern. Attribute werden mit den Log-Formaten Logfmt, JSON und NDJSON unterstützt.

​
Formatierung

AppSignal parst Logs, die von Ihrer Quelle empfangen werden, basierend auf Schlüssel-Wert-Paaren und speichert jeden Schlüssel und Wert als Attribute der Log-Zeile, sodass Sie Log-Zeilen nach diesen Attributen filtern können. Attribute formatieren mit:

​
Logfmt

In Logfmt können Attribute zu Log-Zeilen hinzugefügt werden:
Text
Die obige Log-Zeile wird beispielsweise zu einer Log-Zeile mit der Nachricht "I am a message" und den folgenden Attributen geparst:
Mehr über die Logfmt-Log-Formatierung lesen.

​
JSON und NDJSON

In JSON können Attribute in einem Hash unter dem Schlüssel attributes hinzugefügt werden:
Text
Die obige Log-Zeile wird beispielsweise zu einer Log-Zeile mit der Nachricht "This is a test message" und den folgenden Attributen geparst:
Mehr über die JSON/NDJSON-Log-Formatierung lesen.

​
Attribute in AppSignal abfragen

In AppSignal können Sie nach Logs suchen, die bestimmte Attributbedingungen erfüllen. Die folgende Abfrage würde beispielsweise alle Logs zurückgeben, die ein article_id-Attribut mit dem Wert 7 enthalten:
Text
Lesen Sie unsere Log-Management-Dokumentation für eine vollständige Erläuterung unserer Logging-Suchsyntax. Wenn ein Log erweitert wird, werden die Attribute unterhalb der Log-Nachricht aufgeführt: Erweiterte Log-Zeile mit Attributtabelle

​
Formatierungsregeln

Attributwerte können einen der folgenden Typen haben:
  • string
  • integer (z. B. 10)
  • double (z. B. 10.01)
  • boolean (true/false)
Attributschlüssel müssen folgende Regeln einhalten:
  • Schlüssel müssen alphanumerisch sein.
  • Schlüssel dürfen keine Leerzeichen enthalten, dürfen aber Punkte (.), Unterstriche (_) und Bindestriche (-) enthalten.
  • Schlüssel dürfen nicht mehr als 50 Zeichen enthalten
  • Werte dürfen nicht länger als 255 Zeichen sein
  • Nicht mehr als 25 Attribute pro Log-Nachricht.
Falls Attributschlüssel und -werte den oben genannten Regeln nicht entsprechen, ist mit folgendem Verhalten zu rechnen:
  • Wenn ein Schlüssel keinen Wert hat, wird er an das message-Feld angehängt.
  • Wenn ein Schlüssel-Wert-Paar einen Schlüssel mit dem Namen msg oder message hat, wird der Wert dieses Schlüssels als Log-Nachricht geparst.
  • Wenn kein message-/msg-Schlüssel verfügbar ist, wird die gesamte Log-Zeile als Nachricht betrachtet.