Zum Hauptinhalt springen
Diese Abfragesyntax wird in Zukunft veraltet sein. Wechseln Sie zu unserer neuen Abfragesyntax. Wenn Sie zur neuen Abfragesyntax wechseln möchten, kontaktieren Sie den Support.
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 AppSignal unterstützt die Log-Filterung nach:

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

Übersicht der Suchabfragen

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:
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