> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logfmt-Log-Formatierung

<Warning>
  🔐 Senden Sie keine <strong>personenbezogenen Daten (Personal Identifiable Information, PII)</strong> 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. <br /> <br /> Für **HIPAA-pflichtige Stellen** finden Sie weitere Informationen zum Abschluss eines Business Associate Agreement (BAA) in unserer [Business Add-Ons-Dokumentation](/support/business-add-ons).
</Warning>

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](/logging/platforms/heroku) 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

<CodeGroup>
  ```shell Shell theme={null}
  this is foo=bar duration=10 a value="with spaces" message
  ```
</CodeGroup>

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

<CodeGroup>
  ```shell Shell theme={null}
  this is foo=bar a duration=10 message message="I am a message"
  ```
</CodeGroup>

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

<CodeGroup>
  ```shell Shell theme={null}
  foo=bar duration=100
  ```
</CodeGroup>

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.