> ## 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.

# Déclencheurs

> Listez, créez, mettez à jour et archivez des déclencheurs de détection d'anomalies depuis le terminal.

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](/cli/apps).

<Note>
  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](/cli/logs).
</Note>

## Lister les déclencheurs

```sh Shell theme={null}
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 :

```sh Shell theme={null}
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 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 :

| 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>`   | Tableau de bord à 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` (depuis `triggers list`). Une mise à jour crée une nouvelle version liée au déclencheur existant :

```sh Shell theme={null}
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 :

```sh Shell theme={null}
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](/cli/incidents).