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

# Triggers

> Listen, erstellen, aktualisieren und archivieren Sie Anomaly-Detection-Triggers vom Terminal aus.

Die `triggers`-Befehle verwalten Anomaly-Detection-Triggers: Alerts, die ausgelöst werden, wenn eine Metrik einen von Ihnen definierten Schwellenwert überschreitet.

Jeder Befehl zielt auf eine Anwendung, nach Name und Umgebung (`--app "MyApp" --environment production`) oder nach ID (`--app-id <APP_ID>`, die lange hexadezimale App-ID aus `appsignal-cli apps list`). Das Flag `--environment` wird nur benötigt, wenn mehrere Apps einen Namen teilen, und jeder Befehl verwendet Ihre Standard-Organisation, sofern Sie nicht `--org` übergeben. Siehe [Apps und Organisationen](/cli/apps).

<Note>
  Dies sind Anomaly-Detection-Triggers auf Metriken. Für Triggers, die aus Log-Zeilen erstellt werden, siehe [Logs](/cli/logs).
</Note>

## Triggers auflisten

```sh Shell theme={null}
appsignal-cli triggers list --app "MyApp" --environment production
```

## Einen Trigger erstellen

Ein Trigger überwacht ein Metrikfeld und öffnet einen Alert, wenn es einen Schwellenwert überschreitet:

```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"
```

Diese Flags sind erforderlich:

| Flag                            | Beschreibung                                                                  |
| ------------------------------- | ----------------------------------------------------------------------------- |
| `--metric-name <name>`          | Die zu überwachende Metrik                                                    |
| `--kind <kind>`                 | Trigger-Art, z. B. `Advanced`, `Performance` oder `HostCPUUsage`              |
| `--field <field>`               | Zu vergleichendes Feld: `count`, `counter`, `gauge`, `mean`, `p90` oder `p95` |
| `--comparison-operator <op>`    | Eines von `>`, `>=`, `<`, `<=`, `==` oder `!=`                                |
| `--condition-value <number>`    | Schwellenwert für den Vergleich                                               |
| `--warmup-duration <minutes>`   | Wie lange die Bedingung erfüllt sein muss, bevor ein Alert geöffnet wird      |
| `--cooldown-duration <minutes>` | Wie lange er sich erholen muss, bevor ein Alert geschlossen wird              |

Diese Flags sind optional:

| Flag                    | Beschreibung                                                   |
| ----------------------- | -------------------------------------------------------------- |
| `--name <text>`         | Anzeigename (Standard ist der Metrikname)                      |
| `--description <text>`  | Mit dem Trigger angezeigte Beschreibung                        |
| `--notifier-ids <list>` | Kommagetrennte Notifier-IDs zum Anhängen                       |
| `--tag <key=value>`     | Tag-Filter (Flag wiederholen oder kommagetrennt)               |
| `--dashboard-id <id>`   | Dashboard, das aus Benachrichtigungen verlinkt wird            |
| `--no-match-is-zero`    | Fehlende Datenpunkte als 0 behandeln                           |
| `--format <format>`     | Wertformat, z. B. `duration`, `number` oder `percent`          |
| `--format-input <unit>` | Eingabeeinheit für Größenformate, z. B. `byte` oder `kilobyte` |

## Einen Trigger aktualisieren

Aktualisieren Sie einen Trigger über seine `--id` (aus `triggers list`). Ein Update erstellt eine neue Version, die mit dem bestehenden Trigger verknüpft ist:

```sh Shell theme={null}
appsignal-cli triggers update --id <TRIGGER_ID> --app "MyApp" --environment production \
  --condition-value 750
```

`update` akzeptiert dieselben Flags wie `create`.

## Einen Trigger archivieren

Das Archivieren eines Triggers schließt auch seine zugehörigen Alerts und Incidents:

```sh Shell theme={null}
appsignal-cli triggers archive --id <TRIGGER_ID> --app "MyApp" --environment production
```

## Nächste Schritte

Ein Trigger öffnet einen Incident, wenn er ausgelöst wird. Inspizieren Sie diese mit den [incidents](/cli/incidents)-Befehlen.