Skip to main content
Stellen Sie sich vor: Ihre Rails-App protokolliert unter mehreren Gruppen, etwa rails, shop und audit. Sie möchten nur die shop-Zeilen sehen, wissen aber nicht mehr, ob das Feld group oder namespace heißt. Die Log-Suchleiste schlägt Ihnen beim Tippen Felder, Operatoren und Schweregrad-Werte vor. Nutzen Sie die Vorschläge, um eine Abfrage zu erstellen, ohne die Syntax auswendig zu kennen. Sie können eine Abfrage auch direkt eingeben und für die Teile, an die Sie sich nicht erinnern, Vorschläge auswählen.

​
Eine Abfrage erstellen

Wählen Sie die Suchleiste aus, um Vorschläge zu öffnen, die unter Fields und Attributes gruppiert sind:
  • Fields sind auf jeder Log-Zeile verfügbar: severity, hostname, group und message.
  • Attributes sind die Schlüssel, die AppSignal im JSON der angezeigten Log-Zeilen findet, etwa amount oder cart_id. Die Liste zeigt fünf Attribute, bis Sie zu tippen beginnen. Geben Sie einen Teil eines Namens ein, um die Liste zu filtern.
Log-Suchleiste mit einer eingegebenen Abfrage, die mit AND endet, und einem Dropdown mit den Feldern severity, hostname, group und message sowie Attributen wie amount, attempt und cart_id

Nach Fields und Attributes gruppierte Vorschläge, angezeigt nach AND für den nächsten Filter

Angenommen, ein Hintergrundjob schlägt fehl und Sie möchten jede Zeile auf Fehlerebene sehen, die Active Job erwähnt. Erstellen Sie severity=error AND message:"ActiveJob" aus den Vorschlägen:
  1. Wählen Sie severity. Severity überspringt den Operator-Schritt und bietet die Schweregrade an, etwa error, warn und info. Diese Vorschläge fügen Text in die Abfrage ein, Sie können ihn aber weiterhin direkt eingeben oder bearbeiten.
  2. Wählen Sie error. Die Leiste zeigt nun severity=error.
  3. Geben Sie ein Leerzeichen ein und wählen Sie AND aus den Verknüpfungsvorschlägen, oder tippen Sie es selbst.
  4. Wählen Sie message und dann einen Operator: contains, is, is not oder does not contain. Wählen Sie contains, und die Leiste zeigt severity=error AND message:.
  5. Geben Sie "ActiveJob" ein und drücken Sie die Eingabetaste, um die Abfrage auszuführen. Anführungszeichen sind bei einem einzelnen Wort optional und erforderlich, sobald der Wert ein Leerzeichen enthält, etwa message:"Error performing".
Die Seite zeigt nun nur noch Zeilen auf Fehlerebene, deren Nachricht ActiveJob enthält. Fügen Sie AND group=shop hinzu, um auf eine Gruppe einzugrenzen. Um mehr als einen Schweregrad abzugleichen, kombinieren Sie Filter mit OR, zum Beispiel (severity=error OR severity=warn). Verwenden Sie die Pfeiltasten, um einen Vorschlag hervorzuheben, und die Eingabetaste, um ihn einzufügen. Ist kein Vorschlag hervorgehoben, führt die Eingabetaste die Abfrage aus. Drücken Sie die Escape-Taste, um die Vorschläge zu schließen. Wählen Sie die Schaltfläche zum Löschen rechts in der Leiste, um die Abfrage zu entfernen und alle Logs anzuzeigen. Solange die Suchleiste fokussiert ist, pausiert das Live-Tailing, damit die aktuellen Zeilen stehen bleiben. Es wird fortgesetzt, sobald Sie die Leiste verlassen.

​
Eine Abfrage direkt eingeben

Die Suchleiste ist ein Textfeld, Sie können eine Abfrage also auch eingeben oder einfügen. Die vollständige Abfragesyntax funktioniert weiterhin in der Leiste, falls Sie mehr benötigen, als die Logs-Autocomplete-Vorschläge bieten. Die Autocomplete-Funktion für Log-Abfragen befindet sich in der Beta-Phase über AppSignal Labs und liegt hinter einem Feature-Flag. Kontaktieren Sie den Support, um sie für Ihre Organisation zu aktivieren. Teilen Sie Ihr Feedback auf unserem Discord-Server. Sobald eine Abfrage die gewünschten Zeilen liefert, können Sie daraus eine log-basierte Metrik erstellen, ohne die Seite zu verlassen.