> ## 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 > Listez, recherchez, inspectez et triez les incidents d'exception, de performance et d'anomalie depuis le terminal. La CLI vous permet de traiter les incidents sans ouvrir l'interface web. Vous pouvez lister les incidents tous types confondus ou par type, les restreindre par état, namespace ou action, ouvrir les détails d'un incident, mettre à jour son état ou sa sévérité, et ajouter des notes. Chaque commande `incidents` cible une application, identifiée soit par nom et environnement (`--app "MyApp" --environment production`), soit par ID (`--app-id `, l'identifiant hexadécimal long de l'application obtenu via `appsignal-cli apps list`). Le drapeau `--environment` n'est nécessaire que lorsque plusieurs applications partagent le même nom. Ajoutez `--org` pour remplacer votre organisation par défaut. Voir [Applications et organisations](/cli/apps) pour savoir comment les applications sont identifiées. ## Lister les incidents Pour lister les incidents récents de tous types pour une application : ```sh Shell theme={null} appsignal-cli incidents list --app "MyApp" --environment production --limit 5 ``` Par défaut, les commandes de listage renvoient les 10 incidents les plus récents, classés par activité la plus récente. ### Lister par type Trois commandes restreignent les résultats à un seul type d'incident : ```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 ``` ## Filtrer et rechercher Les commandes de listage partagent un ensemble de filtres : | Drapeau | Description | | ----------------- | ----------------------------------------------------------------------------------- | | `--state ` | Filtrer par état : `OPEN`, `CLOSED` ou `WIP` | | `--order ` | Trier par `LAST` (activité la plus récente, par défaut) ou `ID` (ordre de création) | | `--limit ` | Nombre maximum de résultats (par défaut : 10) | | `--offset ` | Nombre de résultats à ignorer, pour la pagination | `incidents list`, `list-exceptions` et `list-performance` acceptent aussi : | Drapeau | Description | | --------------------- | ------------------------------------------------------------------------------- | | `--namespaces ` | Filtrer par namespaces, séparés par des virgules (par exemple `web,background`) | | `--action ` | Filtrer par nom d'action (par exemple `UsersController#show`) | Les incidents d'exception et de performance prennent en charge une recherche textuelle sur le nom ou le message de l'incident avec `--query` : ```sh Shell theme={null} appsignal-cli incidents list-exceptions --app "MyApp" --environment production --query "TimeoutError" ``` Vous pouvez passer plusieurs filtres dans une seule commande, ils s'appliquent tous ensemble pour restreindre les résultats. Par exemple, pour lister uniquement les exceptions ouvertes dans le namespace `web` : ```sh Shell theme={null} appsignal-cli incidents list-exceptions --app "MyApp" --environment production \ --state OPEN --namespaces web ``` Les commandes de listage renvoient les incidents récents, donc les plus anciens peuvent ne pas apparaître même s'ils sont encore ouverts. Pour ouvrir un incident spécifique quel que soit son âge, utilisez `incidents show` avec son numéro. ## Afficher un incident Pour voir tous les détails d'un incident, passez son numéro : ```sh Shell theme={null} appsignal-cli incidents show --number 42 --app "MyApp" --environment production ``` ## Mettre à jour un incident Mettez à jour l'état, la sévérité, les assignés ou la description d'un incident par son numéro : ```sh Shell theme={null} appsignal-cli incidents update --number 42 --app "MyApp" --environment production --state CLOSED ``` | Drapeau | Description | | --------------------------- | ------------------------------------------------------------------------------------- | | `--state ` | Nouvel état : `OPEN`, `CLOSED` ou `WIP` | | `--severity ` | Nouvelle sévérité : `UNTRIAGED`, `CRITICAL`, `HIGH`, `LOW`, `NONE` ou `INFORMATIONAL` | | `--assign ` | Noms d'utilisateurs ou IDs à ajouter comme assignés, séparés par des virgules | | `--assign-me` | Assigner l'incident à votre utilisateur authentifié | | `--unassign ` | Noms d'utilisateurs ou IDs à retirer des assignés, séparés par des virgules | | `--description ` | Nouvelle description | Pour modifier plusieurs incidents à la fois, passez une liste de numéros séparés par des virgules. Les mises à jour groupées prennent actuellement en charge uniquement `--state` : ```sh Shell theme={null} appsignal-cli incidents update --number 41,42,43 --app "MyApp" --environment production --state CLOSED ``` ### Assigner un incident Pour vous assigner un incident, utilisez `--assign-me`. Aucun ID utilisateur n'est nécessaire : ```sh Shell theme={null} appsignal-cli incidents update --number 42 --app "MyApp" --environment production --assign-me ``` Pour assigner d'autres personnes, passez leurs noms ou IDs utilisateur à `--assign`, séparés par des virgules. Un ID utilisateur est une longue chaîne hexadécimale. Trouvez les noms et IDs avec [`apps resources users`](/cli/apps), qui liste le nom, l'ID et l'e-mail de chaque utilisateur : ```sh Shell theme={null} appsignal-cli apps resources users --app "MyApp" --environment production ``` Ensuite, passez-en un ou plusieurs à `--assign` : ```sh Shell theme={null} appsignal-cli incidents update --number 42 --app "MyApp" --environment production \ --assign ``` Pour retirer des assignés, passez leurs noms ou IDs à `--unassign` de la même manière. ## Ajouter une note Pour consigner ce que vous avez trouvé sur un incident : ```sh Shell theme={null} appsignal-cli incidents add-note --number 42 --app "MyApp" --environment production \ --content "Root cause identified." ``` ## Sortie JSON Comme toutes les commandes, les commandes `incidents` acceptent le drapeau global `--output json` (ou `--format json`), qui renvoie une sortie lisible par machine pour les scripts et les agents IA : ```sh Shell theme={null} appsignal-cli --output json incidents list-exceptions --app "MyApp" --environment production --state OPEN ``` Pour renvoyer un seul incident au format JSON, restreignez par son numéro avec `incidents show` : ```sh Shell theme={null} appsignal-cli --output json incidents show --number 42 --app "MyApp" --environment production ``` ## Étapes suivantes Les incidents vous indiquent ce qui échoue. Pour voir les échantillons individuels derrière l'un d'eux, [récupérez ses traces](/cli/traces) par numéro d'incident. Pour voir les lignes de log environnantes, [suivez ou recherchez vos logs](/cli/logs) depuis le terminal.