> ## Documentation Index > Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt > Use this file to discover all available pages before exploring further. # Incidents > Listen, durchsuchen, prüfen und triagieren Sie Exception-, Performance- und Anomalie-Incidents vom Terminal aus. 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 `, 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](/cli/apps) dazu, wie Apps identifiziert werden. ## Incidents auflisten Um aktuelle Incidents aller Typen für eine App aufzulisten: ```sh Shell theme={null} 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: ```sh Shell theme={null} # 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 ` | Nach Zustand filtern: `OPEN`, `CLOSED` oder `WIP` | | `--order ` | Sortieren nach `LAST` (neueste Aktivität, der Standard) oder `ID` (Erstellungsreihenfolge) | | `--limit ` | Maximale Ergebnisse (Standard: 10) | | `--offset ` | Anzahl der zu überspringenden Ergebnisse, für Paginierung | `incidents list`, `list-exceptions` und `list-performance` akzeptieren außerdem: | Flag | Beschreibung | | --------------------- | --------------------------------------------------------------- | | `--namespaces ` | Nach Namespaces filtern, kommagetrennt (z. B. `web,background`) | | `--action ` | 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`: ```sh Shell theme={null} 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: ```sh Shell theme={null} 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: ```sh Shell theme={null} 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: ```sh Shell theme={null} appsignal-cli incidents update --number 42 --app "MyApp" --environment production --state CLOSED ``` | Flag | Beschreibung | | --------------------------- | -------------------------------------------------------------------------------------- | | `--state ` | Neuer Zustand: `OPEN`, `CLOSED` oder `WIP` | | `--severity ` | Neuer Schweregrad: `UNTRIAGED`, `CRITICAL`, `HIGH`, `LOW`, `NONE` oder `INFORMATIONAL` | | `--assign ` | Benutzernamen oder IDs, die als Zuständige hinzugefügt werden, kommagetrennt | | `--assign-me` | Den Incident Ihrem authentifizierten Benutzer zuweisen | | `--unassign ` | Benutzernamen oder IDs, die aus den Zuständigen entfernt werden, kommagetrennt | | `--description ` | Neue Beschreibung | Um mehrere Incidents auf einmal zu ändern, übergeben Sie eine kommagetrennte Liste von Nummern. Bulk-Updates unterstützen derzeit nur `--state`: ```sh Shell theme={null} 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: ```sh Shell theme={null} 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`](/cli/apps), was Name, ID und E-Mail-Adresse jedes Benutzers auflistet: ```sh Shell theme={null} appsignal-cli apps resources users --app "MyApp" --environment production ``` Übergeben Sie dann einen oder mehrere davon an `--assign`: ```sh Shell theme={null} appsignal-cli incidents update --number 42 --app "MyApp" --environment production \ --assign ``` 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: ```sh Shell theme={null} 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: ```sh Shell theme={null} 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: ```sh Shell theme={null} 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](/cli/traces) über die Incident-Nummer. Um die umgebenden Log-Zeilen zu sehen, [verfolgen oder durchsuchen Sie Ihre Logs](/cli/logs) vom Terminal aus.