Zum Hauptinhalt springen
Mit der CLI können Sie Incidents bearbeiten, ohne die Web-UI zu öffnen. Sie können Incidents aller Typen oder nach Typ auflisten, sie nach Zustand, Namespace oder Aktion eingrenzen, die Details eines einzelnen Incidents öffnen, dessen Zustand oder Schweregrad aktualisieren und Notizen hinzufügen. Jeder incidents-Befehl richtet sich an eine Anwendung, die entweder über Name und Umgebung (--app "MyApp" --environment production) oder über ID (--app-id <APP_ID>, die lange hexadezimale App-ID aus appsignal-cli apps list) identifiziert wird. Das Flag --environment wird nur benötigt, wenn mehrere Apps denselben Namen teilen. Fügen Sie --org hinzu, um Ihre Standard-Organisation zu überschreiben. Siehe Apps und Organisationen dazu, wie Apps identifiziert werden.

​
Incidents auflisten

Um aktuelle Incidents aller Typen für eine App aufzulisten:
Shell
appsignal-cli incidents list --app "MyApp" --environment production --limit 5
Standardmäßig geben die List-Befehle die 10 jüngsten Incidents zurück, sortiert nach der neuesten Aktivität.

​
Nach Typ auflisten

Drei Befehle grenzen die Ergebnisse auf einen einzigen Incident-Typ ein:
Shell
# Exception incidents
appsignal-cli incidents list-exceptions --app "MyApp" --environment production

# Performance incidents
appsignal-cli incidents list-performance --app "MyApp" --environment production

# Anomaly detection incidents
appsignal-cli incidents list-anomalies --app "MyApp" --environment production

​
Filtern und suchen

Die List-Befehle teilen sich einen gemeinsamen Satz von Filtern:
FlagBeschreibung
--state <STATE>Nach Zustand filtern: OPEN, CLOSED oder WIP
--order <ORDER>Sortieren nach LAST (neueste Aktivität, der Standard) oder ID (Erstellungsreihenfolge)
--limit <N>Maximale Ergebnisse (Standard: 10)
--offset <N>Anzahl der zu überspringenden Ergebnisse, für Paginierung
incidents list, list-exceptions und list-performance akzeptieren außerdem:
FlagBeschreibung
--namespaces <list>Nach Namespaces filtern, kommagetrennt (z. B. web,background)
--action <name>Nach Aktionsname filtern (z. B. UsersController#show)
Exception- und Performance-Incidents unterstützen eine Textsuche über den Namen oder die Meldung des Incidents mit --query:
Shell
appsignal-cli incidents list-exceptions --app "MyApp" --environment production --query "TimeoutError"
Sie können mehrere Filter in einem Befehl übergeben; sie werden gemeinsam angewendet, um die Ergebnisse einzugrenzen. Listen Sie zum Beispiel nur die offenen Exceptions im Namespace web auf:
Shell
appsignal-cli incidents list-exceptions --app "MyApp" --environment production \
  --state OPEN --namespaces web
Die List-Befehle geben aktuelle Incidents zurück, sodass ältere möglicherweise nicht erscheinen, selbst wenn sie noch offen sind. Um einen bestimmten Incident unabhängig vom Alter zu öffnen, verwenden Sie incidents show mit dessen Nummer.

​
Einen Incident anzeigen

Um die vollständigen Details eines einzelnen Incidents zu sehen, übergeben Sie dessen Nummer:
Shell
appsignal-cli incidents show --number 42 --app "MyApp" --environment production

​
Einen Incident aktualisieren

Aktualisieren Sie den Zustand, den Schweregrad, die Zuständigen oder die Beschreibung eines Incidents anhand seiner Nummer:
Shell
appsignal-cli incidents update --number 42 --app "MyApp" --environment production --state CLOSED
FlagBeschreibung
--state <STATE>Neuer Zustand: OPEN, CLOSED oder WIP
--severity <SEV>Neuer Schweregrad: UNTRIAGED, CRITICAL, HIGH, LOW, NONE oder INFORMATIONAL
--assign <NAMES_OR_IDS>Benutzernamen oder IDs, die als Zuständige hinzugefügt werden, kommagetrennt
--assign-meDen Incident Ihrem authentifizierten Benutzer zuweisen
--unassign <NAMES_OR_IDS>Benutzernamen oder IDs, die aus den Zuständigen entfernt werden, kommagetrennt
--description <text>Neue Beschreibung
Um mehrere Incidents auf einmal zu ändern, übergeben Sie eine kommagetrennte Liste von Nummern. Bulk-Updates unterstützen derzeit nur --state:
Shell
appsignal-cli incidents update --number 41,42,43 --app "MyApp" --environment production --state CLOSED

​
Einen Incident zuweisen

Um sich einen Incident selbst zuzuweisen, verwenden Sie --assign-me. Es wird keine Benutzer-ID benötigt:
Shell
appsignal-cli incidents update --number 42 --app "MyApp" --environment production --assign-me
Um andere Personen zuzuweisen, übergeben Sie deren Namen oder Benutzer-IDs an --assign, kommagetrennt. Eine Benutzer-ID ist eine lange hexadezimale Zeichenkette. Finden Sie Namen und IDs mit apps resources users, was Name, ID und E-Mail-Adresse jedes Benutzers auflistet:
Shell
appsignal-cli apps resources users --app "MyApp" --environment production
Übergeben Sie dann einen oder mehrere davon an --assign:
Shell
appsignal-cli incidents update --number 42 --app "MyApp" --environment production \
  --assign <NAME_OR_ID>
Um Zuständige zu entfernen, übergeben Sie deren Namen oder IDs auf dieselbe Weise an --unassign.

​
Eine Notiz hinzufügen

Um festzuhalten, was Sie zu einem Incident herausgefunden haben:
Shell
appsignal-cli incidents add-note --number 42 --app "MyApp" --environment production \
  --content "Root cause identified."

​
JSON-Ausgabe

Wie jeder Befehl akzeptieren auch die incidents-Befehle das globale Flag --output json (oder --format json), das maschinenlesbare Ausgabe für Skripte und KI-Agenten zurückgibt:
Shell
appsignal-cli --output json incidents list-exceptions --app "MyApp" --environment production --state OPEN
Um einen einzelnen Incident als JSON zurückzugeben, grenzen Sie ihn mit incidents show über seine Nummer ein:
Shell
appsignal-cli --output json incidents show --number 42 --app "MyApp" --environment production

​
Nächste Schritte

Incidents sagen Ihnen, was fehlschlägt. Um die einzelnen Samples dahinter zu sehen, rufen Sie deren Traces ab über die Incident-Nummer. Um die umgebenden Log-Zeilen zu sehen, verfolgen oder durchsuchen Sie Ihre Logs vom Terminal aus.