Incidents

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 <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 pour savoir comment les applications sont identifiées.

Lister les incidents

Pour lister les incidents récents de tous types pour une application :

Shell

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 :

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

Filtrer et rechercher

Les commandes de listage partagent un ensemble de filtres :

Drapeau	Description
`--state <STATE>`	Filtrer par état : `OPEN`, `CLOSED` ou `WIP`
`--order <ORDER>`	Trier par `LAST` (activité la plus récente, par défaut) ou `ID` (ordre de création)
`--limit <N>`	Nombre maximum de résultats (par défaut : 10)
`--offset <N>`	Nombre de résultats à ignorer, pour la pagination

incidents list, list-exceptions et list-performance acceptent aussi :

Drapeau	Description
`--namespaces <list>`	Filtrer par namespaces, séparés par des virgules (par exemple `web,background`)
`--action <name>`	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 :

Shell

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 :

Shell

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 :

Shell

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 :

Shell

appsignal-cli incidents update --number 42 --app "MyApp" --environment production --state CLOSED

Drapeau	Description
`--state <STATE>`	Nouvel état : `OPEN`, `CLOSED` ou `WIP`
`--severity <SEV>`	Nouvelle sévérité : `UNTRIAGED`, `CRITICAL`, `HIGH`, `LOW`, `NONE` ou `INFORMATIONAL`
`--assign <NAMES_OR_IDS>`	Noms d’utilisateurs ou IDs à ajouter comme assignés, séparés par des virgules
`--assign-me`	Assigner l’incident à votre utilisateur authentifié
`--unassign <NAMES_OR_IDS>`	Noms d’utilisateurs ou IDs à retirer des assignés, séparés par des virgules
`--description <text>`	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 :

Shell

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 :

Shell

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, qui liste le nom, l’ID et l’e-mail de chaque utilisateur :

Shell

appsignal-cli apps resources users --app "MyApp" --environment production

Ensuite, passez-en un ou plusieurs à --assign :

Shell

appsignal-cli incidents update --number 42 --app "MyApp" --environment production \
  --assign <NAME_OR_ID>

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 :

Shell

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 :

Shell

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 :

Shell

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 par numéro d’incident. Pour voir les lignes de log environnantes, suivez ou recherchez vos logs depuis le terminal.

AppSignal API

Serveur MCP

AppSignal CLI

Lister les incidents

Lister par type

Filtrer et rechercher

Afficher un incident

Mettre à jour un incident

Assigner un incident

Ajouter une note

Sortie JSON

Étapes suivantes

​Lister les incidents

​Lister par type

​Filtrer et rechercher

​Afficher un incident

​Mettre à jour un incident

​Assigner un incident

​Ajouter une note

​Sortie JSON

​Étapes suivantes

Lister les incidents

Lister par type

Filtrer et rechercher

Afficher un incident

Mettre à jour un incident

Assigner un incident

Ajouter une note

Sortie JSON

Étapes suivantes