Zum Hauptinhalt springen
🔐 Senden Sie keine personenbezogenen Daten (Personal Identifiable Information, PII) an AppSignal. Filtern Sie PII (z. B. Namen, E-Mail-Adressen) aus Logs und verwenden Sie stattdessen eine ID, einen Hash oder einen pseudonymisierten Bezeichner.

Für HIPAA-pflichtige Stellen finden Sie weitere Informationen zum Abschluss eines Business Associate Agreement (BAA) in unserer Business Add-Ons-Dokumentation.
Logfmt ist ein Log-Format, das für Menschen leicht zu lesen und zu schreiben ist und von AppSignal unterstützt wird. Es wurde ursprünglich als Format für die Heroku Logdrains verwendet und wird inzwischen von vielen anderen Logging-Anbietern eingesetzt. Die meisten unserer Plattformen und Endpunkte unterstützen das Logfmt-Nachrichtenformat, das wir im Folgenden näher beschreiben.

​
Format

Logfmt ist ein Schlüssel-Wert-Format, bei dem jedes Schlüssel-Wert-Paar durch ein Leerzeichen getrennt ist. Schlüssel und Wert werden durch ein Gleichheitszeichen (=) getrennt. Die Schlüssel-Wert-Paare werden am Ende der Log-Zeile an die Nachricht angehängt. Alle Schlüssel-Wert-Paare, die nicht dem Logfmt-Format entsprechen, werden an die Nachricht der Log-Zeile angehängt.

​
Beispiele

Die folgenden Beispiele zeigen, wie AppSignal Logs im Logfmt-Format parst:

​
Nachricht mit Attributen

this is foo=bar duration=10 a value="with spaces" message
Dies wird zu einer Log-Zeile mit der Nachricht "this is a message" und den folgenden Attributen geparst: { "foo": "bar", "duration": 10, "value": "with spaces"}

​
Nachricht mit Überschreibung

this is foo=bar a duration=10 message message="I am a message"
Dies wird zu einer Log-Zeile mit der Nachricht "I am a message" und den folgenden Attributen geparst: { "foo": "bar", "duration": 10 }. Der Rest der ursprünglichen Nachricht wird zugunsten des message-Schlüssels ignoriert.

​
Nur Attribute

foo=bar duration=100
Dies wird zu einer Log-Zeile mit der Nachricht "foo=bar duration=100" und den folgenden Attributen geparst: { "foo": "bar", "duration": 100 }

​
Formatierungsregeln

  • 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 müssen mit einem alphanumerischen Zeichen beginnen und dürfen nicht länger als 100 Zeichen sein
  • Nicht mehr als 25 Attribute pro Log-Nachricht.
Schlüssel-Wert-Paare, die diesen Regeln nicht entsprechen, werden an die Nachricht eines Logs angehängt. Verhalten von Schlüsseln:
  • 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.