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.

Sie müssen diese Syntax nicht von Hand eingeben. Wählen Sie die Log-Suchleiste, und die Autocomplete-Funktion schlägt Felder, Operatoren und Schweregrade aus Ihren Logs vor. Vorschläge fügen Text in die Abfrage ein, und Sie drücken die Eingabetaste, um sie auszuführen. Den vollständigen Ablauf finden Sie unter Autocomplete für Log-Abfragen.

Schnellstart

Beginnen Sie mit diesen einfachen Abfragen:

timeout

Findet Logs, deren Nachricht „timeout” enthält.

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	`severity!=info`

Verwenden Sie Anführungszeichen für Werte mit Leerzeichen: group:"background jobs" Vergleichen Sie ein Feld mit einem leeren String, um leere und nicht leere Werte zu filtern:

code="" findet Log-Zeilen, in denen code leer ist.
code!="" findet Log-Zeilen, in denen code einen nicht leeren Wert hat.

Teilweise Übereinstimmungen und Wildcards

Der Operator : passt, wenn der Wert an beliebiger Stelle im Feld vorkommt. message:timeout findet „Request timeout” und „timeout after 30s”. Der Abgleich berücksichtigt Groß-/Kleinschreibung, daher findet er „Timeout” nicht. Es gibt kein Wildcard-Zeichen. Ein Sternchen wird wörtlich gesucht, daher passt message:error* nur auf Nachrichten, die den Text error* enthalten. Um Nachrichten zu finden, die „error” enthalten, verwenden Sie message:error. Auch die Zeichen % und _ werden wörtlich abgeglichen. Verwenden Sie =, wenn das gesamte Feld übereinstimmen muss. Auch exakte Übereinstimmungen berücksichtigen Groß-/Kleinschreibung.

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

Apps optimieren

Schnellstart

Verfügbare Felder

Abfrageoperatoren

Suchoperatoren

Teilweise Übereinstimmungen und Wildcards

Vergleichsoperatoren

Verschachtelte Attribute

Abfragen kombinieren

AND-Logik (Standard)

OR-Logik

Gruppierung mit Klammern

​Schnellstart

​Verfügbare Felder

​Abfrageoperatoren

​Suchoperatoren

​Teilweise Übereinstimmungen und Wildcards

​Vergleichsoperatoren

​Verschachtelte Attribute

​Abfragen kombinieren

​AND-Logik (Standard)

​OR-Logik

​Gruppierung mit Klammern

Schnellstart

Verfügbare Felder

Abfrageoperatoren

Suchoperatoren

Teilweise Übereinstimmungen und Wildcards

Vergleichsoperatoren

Verschachtelte Attribute

Abfragen kombinieren

AND-Logik (Standard)

OR-Logik

Gruppierung mit Klammern