Automatisieren mit PagerDuty

Dieser Artikel ist für alle, die InfraNest automatisch mit PagerDuty kommunizieren lassen möchten — die Bereitschaft für mehr als nur einen ausgefallenen Monitor alarmieren und reagieren, wenn ein Responder auf einen Vorfall reagiert. Er ist für Sie, wenn Sie eigene Regeln in Automatisierungen erstellen.

Übersicht

• Ermöglicht Ihren Automatisierungen, PagerDuty-Incidents auszulösen, zu bestätigen oder aufzulösen, und auf Statusänderungen von Incidents in PagerDuty zu reagieren.
• Funktioniert parallel zu, aber unabhängig von, Monitor-basierter Alarmierung.
• Erfordert eine einmalige PagerDuty-Verbindung, die im Automatisierungs-Baukasten eingerichtet wird.

NoteAlarmierung durch einen Monitor benötigt nichts davon — dafür wird das PagerDuty-Alarmziel verwendet. Siehe Connect PagerDuty für diese Einrichtung. Dieser Artikel behandelt Automatisierungen, die Sie selbst in Automatisierungen erstellen.

PagerDuty mit einer Automatisierung verbinden

1. Öffnen Sie Ihre Automatisierung in Automations und fügen Sie eine PagerDuty-Aktion oder einen -Auslöser hinzu.
2. Wenn Sie nach einer Verbindung gefragt werden, wählen Sie Verbindung hinzufügen.
3. Wählen Sie eine von zwei Verbindungsarten:
   • oder ein Token verwenden — fügen Sie denselben 32-stelligen Events API v2 Integration Key ein, den das Alarmziel verwendet, entnommen aus einem PagerDuty-Service. Dies ist die einfachste Option und diejenige, die Sie beim Self-Hosting verwenden sollten.
   • Mit {provider} verbinden — melden Sie sich bei PagerDuty an und verwenden Sie dann PagerDuty-Service wählen, um den Service auszuwählen, den Sie alarmieren möchten. InfraNest liest den Schlüssel dieses Services automatisch aus, sodass Sie nichts kopieren müssen.
4. Speichern Sie die Verbindung. Bis ein Service ausgewählt ist, werden Aktionen mit dieser Verbindung nicht ausgeführt, und der Baukasten weist Sie darauf hin.

NoteEine Verbindung alarmiert einen PagerDuty-Service. Fügen Sie eine weitere Verbindung hinzu, wenn Sie einen anderen Service oder ein anderes Team alarmieren müssen.

Auf PagerDuty reagieren (Auslöser)

1. Legen Sie in Ihrer Automatisierung Wenn das passiert fest und wählen Sie einen der PagerDuty-Auslöser:
   • PagerDuty-Incident ausgelöst
   • PagerDuty-Incident bestätigt — ein Responder hat ihn übernommen
   • PagerDuty-Incident aufgelöst
   • PagerDuty-Incident eskaliert — er ging an den nächsten Responder oder die nächste Ebene
   • PagerDuty-Incident wieder geöffnet
2. Verwenden Sie die vom Auslöser bereitgestellten Daten — Titel des Incidents, Service, Dringlichkeit, den handelnden Responder, einen Link zum Incident und dessen PagerDuty-Incident-ID — in Ihren weiteren Schritten.

3. Stellen Sie sicher, dass der Webhook in PagerDuty eingerichtet ist (derselbe, der für die bidirektionale Synchronisierung verwendet wird — siehe Set up PagerDuty two-way sync). Abonnieren Sie beim Erstellen zusätzlich incident.triggered, incident.escalated und incident.reopened, neben dem bestätigt/aufgelöst-Paar, das die bidirektionale Synchronisierung bereits verwendet.

PagerDuty alarmieren (Aktionen)

1. Wählen Sie in Ihrer Automatisierung unter Das tun die Option Aktion hinzufügen.
2. Fügen Sie eine oder mehrere der folgenden Aktionen hinzu:
   • PagerDuty-Incident auslösen — geben Sie eine Zusammenfassung ein, wählen Sie einen Schweregrad (critical, error, warning oder info) und legen Sie optional einen Gruppierungsschlüssel fest.
   • PagerDuty-Incident bestätigen — geben Sie den Gruppierungsschlüssel des zu bestätigenden Incidents ein.
   • PagerDuty-Incident auflösen — geben Sie den Gruppierungsschlüssel des aufzulösenden Incidents ein.

Zum Gruppierungsschlüssel

PagerDuty gruppiert wiederholte Alarmierungen zum selben Problem unter einem Incident mithilfe des sogenannten Dedup Keys. Er ist der Anknüpfungspunkt für alles, was nach der Alarmierung passiert:

• Lassen Sie ihn beim Auslösen leer, und InfraNest generiert einen — spätere Schritte in derselben Regel können dann genau diesen Incident bestätigen oder auflösen.
• Legen Sie ihn selbst fest (ein Platzhalter aus dem Auslöser funktioniert gut — eine Monitor-ID, ein Domainname, ein Job-Name), wenn eine spätere, separate Regel den von einer früheren Regel geöffneten Incident auflösen muss.

TipLösen Sie denselben Gruppierungsschlüssel zweimal aus, und PagerDuty aktualisiert den offenen Incident, anstatt erneut zu alarmieren — nützlich, um doppelte Alarmierungen zum selben Problem zu vermeiden.

Beispiele

• Ein Zertifikat läuft in 3 Tagen ab → PagerDuty-Incident auslösen mit Schweregrad warning, verknüpft mit der Domain — damit die Verlängerung einen Verantwortlichen hat.
• Ein Backup-Job ist fehlgeschlagen → Bereitschaft alarmieren; wenn der nächste Lauf erfolgreich ist, PagerDuty-Incident auflösen mit demselben Schlüssel.
• Ein PagerDuty-Incident wurde bestätigt → Statusseiten-Ankündigung posten, dass sich jemand darum kümmert.
• Ein PagerDuty-Incident wurde eskaliert → Benachrichtigung senden an Ihren Team-Kanal, damit das breitere Team es sieht, bevor es weiter eskaliert.
• Eine Domain läuft bald ab und die automatische Verlängerung ist deaktiviert → Bereitschaft alarmieren, anstatt eine weitere E-Mail zu senden, die niemand öffnet.

Tipps

• Der Schweregrad wird pro Aktion von Ihnen gewählt. Monitor-gesteuerte Alarmierung leitet den Schweregrad stattdessen aus dem Status des Monitors ab.
• Automatisierungen alarmieren über denselben Events API v2-Schlüssel wie das Alarmziel — der Alarmierungspfad benötigt niemals einen PagerDuty-REST-Schlüssel. Die Verbindung mit PagerDuty dient nur dazu, Ihnen das Kopieren eines Schlüssels zu ersparen.

Fehlerbehebung

• Ein PagerDuty-Auslöser feuert nie — prüfen Sie, ob der Webhook in PagerDuty diesen Ereignistyp abonniert hat.
• Eine Aktion wird nicht ausgeführt — wenn Sie sich mit PagerDuty verbunden haben, stellen Sie sicher, dass Sie einen Service unter PagerDuty-Service wählen ausgewählt haben; Aktionen werden erst ausgeführt, wenn einer gewählt wurde.
• Eine Aktion zeigt ein Pro-Badge — einige PagerDuty-Aktionen erfordern möglicherweise einen höheren Plan.