Passer au contenu principal
Les commandes triggers gèrent les déclencheurs de détection d’anomalies : des alertes qui se déclenchent lorsqu’une métrique franchit un seuil que vous définissez. Chaque commande cible une application, par nom et environnement (--app "MyApp" --environment production) ou par ID (--app-id <APP_ID>, le long ID hexadécimal de l’application provenant de appsignal-cli apps list). L’option --environment n’est nécessaire que lorsque plusieurs applications partagent un nom, et chaque commande utilise votre organisation par défaut sauf si vous passez --org. Voir Applications et organisations.
Ce sont des déclencheurs de détection d’anomalies sur les métriques. Pour les déclencheurs construits à partir de lignes de journal, voir Journaux.

​
Lister les déclencheurs

Shell
appsignal-cli triggers list --app "MyApp" --environment production

​
Créer un déclencheur

Un déclencheur surveille un champ de métrique et ouvre une alerte lorsqu’il franchit un seuil :
Shell
appsignal-cli triggers create --app "MyApp" --environment production \
  --name "Slow web requests" \
  --metric-name response_time --kind Advanced --field mean \
  --comparison-operator ">" --condition-value 500 \
  --warmup-duration 5 --cooldown-duration 2 \
  --description "Alert when mean response time stays above 500ms"
Ces options sont requises :
OptionDescription
--metric-name <name>La métrique à surveiller
--kind <kind>Type de déclencheur, par exemple Advanced, Performance, ou HostCPUUsage
--field <field>Champ à comparer : count, counter, gauge, mean, p90, ou p95
--comparison-operator <op>L’un de >, >=, <, <=, ==, ou !=
--condition-value <number>Seuil de comparaison
--warmup-duration <minutes>Combien de temps la condition doit tenir avant d’ouvrir une alerte
--cooldown-duration <minutes>Combien de temps elle doit récupérer avant de fermer une alerte
Ces options sont facultatives :
OptionDescription
--name <text>Nom d’affichage (par défaut le nom de la métrique)
--description <text>Description affichée avec le déclencheur
--notifier-ids <list>IDs de notifiers à attacher, séparés par des virgules
--tag <key=value>Filtre de tag (répéter l’option, ou séparer par des virgules)
--dashboard-id <id>Tableau de bord à lier depuis les notifications
--no-match-is-zeroTraiter les points de données manquants comme 0
--format <format>Format de valeur, par exemple duration, number, ou percent
--format-input <unit>Unité d’entrée pour les formats de taille, par exemple byte ou kilobyte

​
Mettre à jour un déclencheur

Mettez à jour un déclencheur par son --id (depuis triggers list). Une mise à jour crée une nouvelle version liée au déclencheur existant :
Shell
appsignal-cli triggers update --id <TRIGGER_ID> --app "MyApp" --environment production \
  --condition-value 750
update accepte les mêmes options que create.

​
Archiver un déclencheur

L’archivage d’un déclencheur ferme également ses alertes et incidents associés :
Shell
appsignal-cli triggers archive --id <TRIGGER_ID> --app "MyApp" --environment production

​
Prochaines étapes

Un déclencheur ouvre un incident lorsqu’il se déclenche. Inspectez-les avec les commandes incidents.