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
Jederlogs-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
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übereinstimmungmessage:timeout: Nachricht enthält “timeout”group=notifiers: exakte Gruppenübereinstimmunghostname:web-1: Hostname enthält “web-1”- Leerzeichengetrennte Begriffe werden mit
ANDkombiniert; verwenden SieORfür Alternativen
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 einemraw-Schlüssel.
--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
--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.