Zum Hauptinhalt springen
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.
Dies sind Anomaly-Detection-Triggers auf Metriken. Für Triggers, die aus Log-Zeilen erstellt werden, siehe Logs.

​
Triggers auflisten

Shell
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:
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"
Diese Flags sind erforderlich:
FlagBeschreibung
--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:
FlagBeschreibung
--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-zeroFehlende 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:
Shell
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:
Shell
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-Befehlen.