Zum Hauptinhalt springen
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 sowie Werte für Schweregrad, Hostname und Gruppe 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.

Einen Hostnamen oder eine Gruppe auswählen

Geben Sie auf der Logs-Seite hostname= oder group= in die Suchleiste ein. Die Autocomplete-Funktion schlägt die Werte aus Ihren Logs unter Hostnames oder Groups vor. Geben Sie einen Teil eines Namens ein, um die Liste einzugrenzen, und wählen Sie dann einen Wert aus, um ihn einzufügen. Die anderen Operatoren funktionieren ebenfalls, etwa hostname!= oder group:.
Die Logs-Seite in AppSignal mit hostname= in der Suchleiste. Die Autocomplete-Funktion listet drei Hosts unter Hostnames auf.

Geben Sie hostname= ein, um einen Host aus Ihren Logs auszuwählen.

  • Die Vorschläge stammen aus den Log-Quellen und dem Zeitraum, die Sie gerade ansehen. Wenn nichts passt, zeigt die Liste “No matching values in this time range. You can still type your own.”
  • Die Liste zeigt bis zu 100 Werte. Tippen Sie weiter, um sie einzugrenzen.
  • Nur die Suchleiste der Logs-Seite schlägt Hostnamen und Gruppen vor. Die Formulare für Log-Trigger und Log-Metriken tun das nicht.

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. Dieselbe Autocomplete-Funktion ist auch in den Abfragefeldern für Log-Trigger und Log-Metriken verfügbar. Im Formular für Metriken enthalten die Vorschläge zudem Felder, die für die Metrik-Extraktion und -Gruppierung zur Verfügung stehen.
Log-Suchleiste mit Autocomplete-Feldvorschlägen und vorausgewählten Log-Quellenwerten im Formular für Log-Metriken

Autocomplete-Vorschläge für eine direkt in die Suchleiste eingegebene Abfrage und vorausgewählte Log-Quellenwerte im Formular für Log-Metriken

Sobald eine Abfrage die gewünschten Zeilen liefert, können Sie daraus eine log-basierte Metrik erstellen, ohne die Seite zu verlassen. Anschließend können Sie auch einen Log-Trigger erstellen, um benachrichtigt zu werden, sobald die Abfrage auf neue Zeilen zutrifft. Die Autocomplete-Funktion für Log-Abfragen ist jetzt für alle Kunden allgemein verfügbar. Teilen Sie Ihr Feedback auf unserem Discord-Server.