Incidents - AppSignal Documentation

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:

Flag	Beschreibung
`--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:

Flag	Beschreibung
`--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

Flag	Beschreibung
`--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-me`	Den 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.

​Incidents auflisten

​Nach Typ auflisten

​Filtern und suchen

​Einen Incident anzeigen

​Einen Incident aktualisieren

​Einen Incident zuweisen

​Eine Notiz hinzufügen

​JSON-Ausgabe

​Nächste Schritte

Incidents auflisten

Nach Typ auflisten

Filtern und suchen

Einen Incident anzeigen

Einen Incident aktualisieren

Einen Incident zuweisen

Eine Notiz hinzufügen

JSON-Ausgabe

Nächste Schritte