Syntax für Log-Abfragen

Diese Seite beschreibt unsere neueste Abfragesyntax. Für die Syntax mit attributes siehe unsere Legacy-Abfragesyntax.

Das Log-Filtersystem von AppSignal ermöglicht es Ihnen, Ihre Anwendungs-Logs 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 suchen.

Schnellstart

Beginnen Sie mit diesen einfachen Abfragen:

timeout

Sucht im Feld „message” nach „timeout”.

severity=error

Findet alle Logs auf Fehlerebene.

severity=error hostname=production-web-1

Findet Fehler von einem bestimmten Server.

Verfügbare Felder

Sie können die folgenden Felder in Ihren Logs abfragen:

Feld	Beschreibung	Beispiel
`severity`	Log-Level (error, warning, info, debug, trace)	`severity=error`
`hostname`	Anwendungs-Host	`hostname=production-1`
`group`	Für Ihre Anwendung definierter namespace	`group="background jobs"`
`message`	Inhalt der Log-Nachricht	`message:timeout`
Benutzerdefinierte Attribute	Jedes in Ihren Logs definierte benutzerdefinierte Attribut	`duration>10.1`

Wenn kein Feld angegeben wird, durchsucht die Abfrage das Feld „message”.

Abfrageoperatoren

Suchoperatoren

Operator	Syntax	Beschreibung	Beispiel
`:`	`field:value`	Enthält Wert	`message:error`
`!:`	`field!:value`	Enthält Wert nicht	`hostname!:test`
`=`	`field=value`	Exakte Übereinstimmung	`severity=error`
`!=`	`field!=value`	Nicht gleich	`source!=mongodb`

Verwenden Sie Anführungszeichen für Werte mit Leerzeichen: group:"background jobs"

Vergleichsoperatoren

Für numerische Werte:

Operator	Syntax	Beschreibung	Beispiel
`>`	`attribute>value`	Größer als	`duration>100`
`<`	`attribute<value`	Kleiner als	`user_id<1000`
`>=`	`attribute>=value`	Größer oder gleich	`duration>=100`
`<=`	`attribute<=value`	Kleiner oder gleich	`user_id<=1000`

Verschachtelte Attribute

Wir verwenden die folgende Beispiel-JSON-Struktur:

{
  "message": "User logged in",
  "group": "admin",
  "hostname": "production-1",
  "user": {
    "id": 123,
    "name": "John Doe",
    "emails": ["john@example.com", "john@work.com"],
    "location.country": "US"
  }
}

Fragen Sie verschachtelte JSON-Attribute mithilfe der Punktnotation ab:

user.id=123

Greifen Sie auf Eigenschaften verschachtelter Objekte zu.

user.emails.0=john@example.com

Fragen Sie Array-Elemente per Index ab (nullbasiert).

user.location\.country=US

Maskieren Sie Punkte, die Teil des Feldnamens selbst sind, mit einem Backslash.

Abfragen kombinieren

AND-Logik (Standard)

Durch Leerzeichen getrennte Abfragen werden mit AND verknüpft:

severity=error hostname=production-1

Findet Fehler von production-1.

OR-Logik

Verwenden Sie OR, um beliebige Bedingungen abzugleichen:

severity=error OR severity=warning

Findet Fehler oder Warnungen.

Gruppierung mit Klammern

Verwenden Sie Klammern für komplexe Abfragen:

severity=error AND (hostname=web-1 OR hostname=web-2)

Findet Fehler entweder von web-1 oder web-2.

Funktionen

Anwendungszustand

Logs & Metriken

Infrastruktur

Anwendungsanpassung

Schnellstart

Verfügbare Felder

Abfrageoperatoren

Suchoperatoren

Vergleichsoperatoren

Verschachtelte Attribute

Abfragen kombinieren

AND-Logik (Standard)

OR-Logik

Gruppierung mit Klammern

​Schnellstart

​Verfügbare Felder

​Abfrageoperatoren

​Suchoperatoren

​Vergleichsoperatoren

​Verschachtelte Attribute

​Abfragen kombinieren

​AND-Logik (Standard)

​OR-Logik

​Gruppierung mit Klammern

Schnellstart

Verfügbare Felder

Abfrageoperatoren

Suchoperatoren

Vergleichsoperatoren

Verschachtelte Attribute

Abfragen kombinieren

AND-Logik (Standard)

OR-Logik

Gruppierung mit Klammern