Triggers - AppSignal Documentation

Die triggers-Befehle verwalten Anomaly-Detection-Triggers: Alerts, die geöffnet 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

Filtern Sie die Liste nach Metrikname oder Tags, wenn Sie eine bestimmte Gruppe von Triggern prüfen:

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

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:

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 viele Minuten die Metrik über oder unter dem Schwellenwert bleiben muss, bevor ein Alert geöffnet wird
`--cooldown-duration <minutes>`	Wie viele Minuten die Metrik erholt bleiben 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 archiviert den bestehenden Trigger und erstellt einen damit verknüpften Ersatz. Übergeben Sie beim Aktualisieren die vollständige Trigger-Definition. Beginnen Sie mit den aktuellen Werten aus triggers list und ändern Sie dann die Felder, die Sie neu justieren möchten:

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 akzeptiert dieselben Flags wie create. Geben Sie optionale Werte an, die Sie behalten möchten, etwa --notifier-ids, --tag, --dashboard-id und --description.

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 die Metrik den Trigger-Schwellenwert überschreitet. Inspizieren Sie diese Incidents mit den incidents-Befehlen.

​Triggers auflisten

​Einen Trigger erstellen

​Einen Trigger aktualisieren

​Einen Trigger archivieren

​Nächste Schritte

Triggers auflisten

Einen Trigger erstellen

Einen Trigger aktualisieren

Einen Trigger archivieren

Nächste Schritte