> ## 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.

# Log-Attribute

<Tip>
  Möchten Sie das Beste aus Ihren Logs herausholen? Lesen Sie unseren
  [Learning-Center-Artikel zu Best Practices beim
  Logging](https://www.appsignal.com/learning-center/what-logs-should-i-store)
  für weitere Informationen zur richtigen Nutzung der Logs Ihrer Anwendung.
</Tip>

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][logfmt-docs], [JSON][json-docs] und [NDJSON][ndjson-docs] unterstützt.

<h2 id="formatting">
  Formatierung
</h2>

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](#logfmt)
* [JSON und NDJSON](#json-and-ndjson)

<h3 id="logfmt">
  Logfmt
</h3>

In Logfmt können Attribute zu Log-Zeilen hinzugefügt werden:

```text Text theme={null}
this is foo=bar a duration=10 message message="I am a message"
```

Die obige Log-Zeile wird beispielsweise zu einer Log-Zeile mit der Nachricht `"I am a message"` und den folgenden Attributen geparst:

<CodeGroup>
  ```json JSON theme={null}
  { "foo": "bar", "duration": 10 }
  ```
</CodeGroup>

[Mehr über die Logfmt-Log-Formatierung lesen.](/logging/formatting/logfmt)

<h3 id="json-and-ndjson">
  JSON und NDJSON
</h3>

In JSON können Attribute in einem Hash unter dem Schlüssel `attributes` hinzugefügt werden:

```text Text theme={null}
{
  "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
  }
}
```

Die obige Log-Zeile wird beispielsweise zu einer Log-Zeile mit der Nachricht `"This is a test message"` und den folgenden Attributen geparst:

<CodeGroup>
  ```json JSON theme={null}
  { "org": "appsignal", "step": 1, "seen_terms": true, "entries": 10.01 }
  ```
</CodeGroup>

[Mehr über die JSON/NDJSON-Log-Formatierung lesen.](/logging/formatting/json)

<h2 id="querying-attributes-in-appsignal">
  Attribute in AppSignal abfragen
</h2>

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 Text theme={null}
attributes.article_id=7
```

Lesen Sie unsere [Log-Management-Dokumentation](/logging/query-syntax) für eine vollständige Erläuterung unserer Logging-Suchsyntax.

Wenn ein Log erweitert wird, werden die Attribute unterhalb der Log-Nachricht aufgeführt:

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/logging/formatting/expanded-log-line.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=e6626beedd58d340de11271b643d79d9" alt="Erweiterte Log-Zeile mit Attributtabelle" width="2038" height="1286" data-path="assets/images/screenshots/logging/formatting/expanded-log-line.png" />

<h2 id="formatting-rules">
  Formatierungsregeln
</h2>

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.

[json-docs]: /logging/formatting/json.html#json

[logfmt-docs]: /logging/formatting/logfmt.html

[ndjson-docs]: /logging/endpoints/http-json#ndjson


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.