Skip to main content
Die logs-Befehle bringen die Logs Ihrer Anwendung in das Terminal: verfolgen Sie sie, sobald sie eintreffen, durchsuchen Sie einen Zeitbereich und verwalten Sie die aus Logs abgeleiteten Metriken und log-basierten Triggers, die daraus erstellt werden.

Allgemeine Optionen

Jeder logs-Befehl identifiziert eine Anwendung und verwendet Ihre Standard-Organisation, sofern Sie es ihm nicht anders mitteilen:

Logs verfolgen

Streamen Sie Log-Zeilen, sobald sie eintreffen (die CLI fragt jede Sekunde ab):
Shell

Logs durchsuchen

Durchsuchen Sie vergangene Log-Zeilen und drucken Sie die Treffer. Zum Beispiel, finden Sie aktuelle Zeilen auf Fehler-Level:
Shell
Standardmäßig gibt search bis zu 100 der jüngsten Treffer zurück. Zusätzlich zu den allgemeinen Optionen und Filtern bietet er: Um jede Zeile in einem Fenster als JSON abzurufen, für ein Skript oder einen Agent:
Shell

Filter

tail und search teilen sich diese Filter: Listen Sie die für eine App verfügbaren Views mit appsignal-cli logs views auf und übergeben Sie dann einen an --view per Name oder ID. --query und --source-ids ersetzen die gespeicherten Werte des Views, und --severities grenzt die Query des Views weiter ein. Zum Beispiel, wenden Sie einen View an, grenzen ihn aber auf kritische Zeilen ein:
Shell

Query-Syntax

Das Flag --query verwendet AppSignals Log-Query-Syntax. Häufige Muster:
  • severity=error: exakte Feldübereinstimmung
  • message:timeout: Nachricht enthält “timeout”
  • group=notifiers: exakte Gruppenübereinstimmung
  • hostname:web-1: Hostname enthält “web-1”
  • Leerzeichengetrennte Begriffe werden mit AND kombiniert; verwenden Sie OR für Alternativen
Eckige Klammern haben im Parser eine besondere Bedeutung, also setzen Sie sie in Anführungszeichen, um sie wörtlich abzugleichen: message:"[Email]".

Strukturierte Metadaten

tail und search enthalten die strukturierten Metadaten jeder Log-Zeile, etwa eine Request-ID oder Benutzer-ID:
  • Die menschenlesbare Ausgabe fügt die Felder am Ende der Zeile als [key=value ...] hinzu.
  • Die JSON-Ausgabe legt sie in einem json-Objekt auf jeder Zeile ab, wobei jeder Wert seinen JSON-Typ behält. Metadaten, die ein Logger als reinen Text sendet, erscheinen unter einem raw-Schlüssel.
Verwenden Sie die JSON-Ausgabe, wenn ein Skript oder ein Agent die Metadaten lesen muss. Sie können auch nach Metadatenfeldern in --query filtern, einschließlich verschachtelter Felder, die mit Punkten geschrieben werden. Siehe verschachtelte Attribute in der Query-Syntax-Referenz.
Shell

Gespeicherte Views und Sources

Listen Sie die gespeicherten Log Views (Filter-Voreinstellungen) und die Log Sources einer App auf:
Shell
Übergeben Sie den Namen oder die ID eines Views an --view und die ID einer Source an --source-ids.

Aus Logs abgeleitete Metriken

logs metrics verwandelt passende Log-Zeilen in Metriken, mit list, create, update und delete:
Shell
create und update teilen sich diese Flags (create erfordert --name, --query und mindestens ein --metric): update kann die folgenden zusätzlichen Flags annehmen. Die --clear-*-Flags leeren Felder, anstatt sie zu aktualisieren. delete nimmt nur --id.
Eine aus Logs abgeleitete Metrik beginnt erst dann mit der Datenerfassung, wenn sie auf eine Log-Source eingegrenzt ist, also übergeben Sie --source-id (finden Sie IDs mit appsignal-cli logs sources). Die CLI kann den Severity-Filter einer Metrik nicht setzen; wenn Ihre Metrik einen benötigt, setzen Sie das Severity-Feld in der AppSignal-App-UI nach dem Erstellen.

Log-basierte Triggers

logs triggers alarmiert bei passenden Log-Zeilen, mit list, create, update und delete:
Shell
create und update teilen sich diese Flags (create erfordert --name und --query): update kann die folgenden zusätzlichen Flags annehmen. Die --clear-*-Flags leeren Felder, anstatt sie zu aktualisieren. delete nimmt nur --id.
Dies sind log-basierte Triggers, die aus Log-Zeilen erstellt werden. Für Anomaly-Detection-Triggers auf Metriken siehe Triggers.

Nächste Schritte

Etwas in den Logs gefunden? Öffnen Sie die zugehörigen Incidents oder richten Sie Anomaly-Detection-Triggers ein.