Passer au contenu principal
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 :
DrapeauDescription
--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 :
DrapeauDescription
--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
DrapeauDescription
--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-meAssigner 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.