Zum Hauptinhalt springen
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. Screenshot eines erweiterten Logs

​
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:
FeldBeschreibungBeispiel
severityLog-Level (error, warning, info, debug, trace)severity=error
hostnameAnwendungs-Hosthostname=production-1
groupFür Ihre Anwendung definierter Namensraumgroup="background jobs"
messageInhalt der Log-Nachrichtmessage:timeout
Benutzerdefinierte AttributeJedes in Ihren Logs definierte benutzerdefinierte Attributduration>10.1
Wenn kein Feld angegeben wird, durchsucht die Abfrage das Feld „message”.

​
Abfrageoperatoren

​
Suchoperatoren

OperatorSyntaxBeschreibungBeispiel
:field:valueEnthält Wertmessage:error
!:field!:valueEnthält Wert nichthostname!:test
=field=valueExakte Übereinstimmungseverity=error
!=field!=valueNicht gleichsource!=mongodb
Verwenden Sie Anführungszeichen für Werte mit Leerzeichen: group:"background jobs"

​
Vergleichsoperatoren

Für numerische Werte:
OperatorSyntaxBeschreibungBeispiel
>attribute>valueGrößer alsduration>100
<attribute<valueKleiner alsuser_id<1000
>=attribute>=valueGrößer oder gleichduration>=100
<=attribute<=valueKleiner oder gleichuser_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.