Triggers - AppSignal Documentation

Les commandes triggers gèrent les déclencheurs de Anomaly detection : des alertes qui s’ouvrent 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 Anomaly detection 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

Filtrez la liste par nom de métrique ou par tags lorsque vous passez en revue un groupe précis de déclencheurs :

Shell

appsignal-cli triggers list --app "MyApp" --environment production --metric-name response_time
appsignal-cli triggers list --app "MyApp" --environment production --tag hostname=web-1

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 :

Option	Description
`--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 minutes la métrique doit rester au-dessus ou en dessous du seuil avant d’ouvrir une alerte
`--cooldown-duration <minutes>`	Combien de minutes la métrique doit rester revenue à la normale avant de fermer une alerte

Ces options sont facultatives :

Option	Description
`--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>`	Dashboard à lier depuis les notifications
`--no-match-is-zero`	Traiter 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 issu de triggers list. Une mise à jour archive le déclencheur existant et crée un remplaçant qui lui est lié. Passez la définition complète du déclencheur lors d’une mise à jour. Partez des valeurs actuelles de triggers list, puis modifiez les champs que vous voulez réajuster :

Shell

appsignal-cli triggers update --id <TRIGGER_ID> --app "MyApp" --environment production \
  --name "Slow web requests" \
  --metric-name response_time --kind Advanced --field mean \
  --comparison-operator ">" --condition-value 750 \
  --warmup-duration 5 --cooldown-duration 2 \
  --notifier-ids <NOTIFIER_ID>

update accepte les mêmes options que create. Incluez les valeurs optionnelles que vous souhaitez conserver, comme --notifier-ids, --tag, --dashboard-id et --description.

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 lorsque la métrique franchit son seuil. Inspectez ces incidents avec les commandes incidents.

​Lister les déclencheurs

​Créer un déclencheur

​Mettre à jour un déclencheur

​Archiver un déclencheur

​Prochaines étapes

Lister les déclencheurs

Créer un déclencheur

Mettre à jour un déclencheur

Archiver un déclencheur

Prochaines étapes