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

# Legacy-Syntax für Log-Abfragen

> Abfragesyntax für Logs mit dem attributes.-Präfix und Typ-Suffixen, für Accounts, die noch nicht auf die aktuelle Syntax migriert sind.

> [!WARNING]
>
> Diese Abfragesyntax wird in Zukunft veraltet sein. Wechseln Sie zu unserer
> [neuen Abfragesyntax](https://docs.appsignal.com/logging/query-syntax.md). Wenn Sie zur neuen Abfragesyntax
> wechseln möchten, [kontaktieren Sie den Support](mailto:support@appsignal.com).

Das leistungsstarke Log-Filtersystem von AppSignal ermöglicht es Ihnen, Ihre Anwendungs-Logs schnell mit einer intuitiven Abfragesyntax zu durchsuchen und zu filtern. Egal, ob Sie bestimmte Fehlermeldungen finden, nach Schweregraden filtern oder benutzerdefinierte Attribute durchsuchen möchten – mit unserer Abfragesprache können Sie genau das finden, wonach Sie in Ihren Logs suchen.

Stellen Sie sich das wie eine Suchmaschine für die Logs Ihrer Anwendung vor. Hier ist ein einfaches Beispiel:

Wenn Sie alle Fehler-Logs finden möchten, können Sie verwenden:
`severity=error`

Oder wenn Sie Logs finden möchten, die das Wort „timeout" enthalten:
`message:timeout`

![Screenshot eines erweiterten Logs](https://mintcdn.com/appsignal-715f5a51/g-Xvhfxoo9Zu0ive/assets/images/screenshots/logging/all-logs.png?fit=max\&auto=format\&n=g-Xvhfxoo9Zu0ive\&q=85\&s=294a9482dd18a89b870da2f9f8f13055)

AppSignal unterstützt die Log-Filterung nach:

| Filterfeld | Beschreibung | Beispielabfrage |
| - | - | - |
| `severity` | Log-Schweregrad. Akzeptierte Werte sind: error, warning, info, debug und trace | `severity=error` |
| `hostname` | Anwendungs-Host (über Suche) | `hostname=appsignal` |
| `group` | Für Ihre Anwendung definierte namespaces (über Suche) | `group=users` |
| `message` | Inhalt der Log-Nachricht (über Suche) | `message:error` |
| `attributes` | In Ihren Logs definierte Attribute (über Suche) | `attributes.duration_double>10.1` (siehe [Attributtypen](#attribute-types)) |

## Erklärung der Suchsyntax

Die folgende Tabelle erklärt die aktuelle Syntax für Suchabfragen in AppSignal Logs.

Abfragen können durch ein Leerzeichen zwischen ihnen kombiniert werden (siehe „Kombinierte Abfragen" unter [Mehrere Abfragen kombinieren](#combining-multiple-queries)).

### Übersicht der Suchabfragen

| Abfragename | AppSignal-Syntax | Beschreibung |
| - | - | - |
| Wildcard | `Foo` | Gibt alle Logs zurück, die einen Wert wie `Foo` enthalten |
| Mehrere Wildcards | `Foo Bar` | Gibt alle Logs zurück, die einen Wert wie `Foo` und einen Wert wie `Bar` enthalten |
| Wildcard für Wörter mit Leerzeichen | `"Foo Bar"` | Gibt alle Logs zurück, die einen Wert wie `"Foo Bar"` enthalten |
| Feldsuche | `hostname:foo` | Gibt alle Logs zurück, bei denen das Feld hostname wie `Foo` ist |
| Feldsuche mit mehreren Wörtern | `hostname:"foo bar"` | Gibt alle Logs zurück, bei denen das Feld hostname wie `"Foo Bar"` ist |
| Exakte Übereinstimmung | `hostname=foo` | Gibt alle Logs zurück, bei denen das Feld hostname `Foo` ist |
| Negation einer exakten Abfrage | `hostname!=foo` | Gibt alle Logs zurück, bei denen das Feld hostname nicht `Foo` ist |
| Negation einer Wildcard-Abfrage | `hostname!:foo` | Gibt alle Logs zurück, bei denen das Feld hostname nicht wie `Foo` ist |
| Übereinstimmung mit einem Listenelement | `hostname=[\"frontend1\", frontend2]"` | Gibt alle Logs zurück, die mit einem der Elemente der Liste `["frontend1", "frontend2"]` übereinstimmen |
| Keine Übereinstimmung in Liste | `group!=[\"app\", unix]"` | Gibt alle Logs zurück, die mit keinem der Elemente der Liste `["app", "unix"]` übereinstimmen |
| Attributspezifische Abfrage | `attributes.attribute_name` | Fragt Log-Attribute ab. Ersetzen Sie `attribute_name` durch das Attribut, das Sie abfragen (einschließlich Typ-Suffix). Sie können jeden gültigen AppSignal-Operator in dieser Tabelle verwenden. |
| Größer als | `attributes.duration_double>100` | Gibt alle Logs zurück, bei denen `duration` größer als 100 ist |
| Kleiner als | `attributes.duration_double<100` | Gibt alle Logs zurück, bei denen `duration` kleiner als 100 ist |

Die oben stehenden Wildcard-Abfragen stimmen mit dem angegebenen Text an einer beliebigen Stelle im Wert überein. Es gibt kein Wildcard-Zeichen. Ein Sternchen wird wörtlich gesucht, sodass `hostname:web*` nur Hostnamen findet, die den Text `web*` enthalten.

### Mehrere Abfragen kombinieren

Sie können mehrere Abfragen kombinieren, indem Sie sie mit Leerzeichen aneinanderreihen.

1. Logs finden, die „error" enthalten:
   `message:error`

2. Filterung nach einer bestimmten Gruppe hinzufügen:
   `message:error group="background jobs"`

3. Bestimmte Hostnamen ausschließen:
   `message:error group="background jobs" hostname!:test-server`

### Attributtypen

Beim Filtern benutzerdefinierter Log-Attribute mit Vergleichsoperatoren (`>`, `<`, `>=`, `<=`) **müssen** Sie ein Typ-Suffix im Attributnamen angeben. Ohne das korrekte Typ-Suffix schlägt die Abfrage fehl.

Die unterstützten Typ-Suffixe sind:

| Suffix | Typ | Beispiel |
| - | - | - |
| `_int` | Integer | `attributes.user_id_int>1000` |
| `_double` | Float | `attributes.duration_double>5.65` |
| `_bool` | Boolean | `attributes.success_bool=true` |
| `_string` | String | `attributes.region_string=eu` |

> [!WARNING]
>
> **Wichtig:** Verwenden Sie keine Leerzeichen um Vergleichsoperatoren, wenn Sie
> Attribute abfragen. Verwenden Sie zum Beispiel `attributes.duration_double>5.65`
> – **nicht** `attributes.duration_double > 5.65`. Leerzeichen führen dazu, dass
> die Abfrage fehlschlägt.

### Häufige Anwendungsfälle

1. Alle Fehler von einem bestimmten Server finden:
   `severity=error hostname=production-web-1`

2. Langsame Datenbankabfragen finden:
   `source=PostgreSQL attributes.duration_double>100.0`

3. Fehlgeschlagene Background-Jobs debuggen:
   `group="background jobs" message:failed`


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