PagerDuty verbinden

Alarmiere dein Bereitschaftsteam über PagerDuty, sobald ein Monitor ausfällt — direkt aus InfraNest.

Überblick

• Ein ausgefallener Monitor löst automatisch einen PagerDuty-Vorfall aus; wenn er sich erholt, löst InfraNest denselben Vorfall auf.
• Ein Bestätigen oder Auflösen in einem Tool aktualisiert das andere, sobald du verbunden bist.
• Du brauchst nur einen PagerDuty-Integrationsschlüssel — kein REST-API-Schlüssel oder OAuth erforderlich.

Bevor du beginnst

Du benötigst einen PagerDuty-Integrationsschlüssel (manchmal auch Routing-Key genannt). Dieser stammt von einer Events API v2-Integration eines deiner PagerDuty-Services — es ist kein „API Access Key“.

1. Gehe in PagerDuty zu Services und öffne den Service, für den du alarmiert werden möchtest (oder erstelle einen neuen).
2. Öffne den Reiter Integrations des Services und wähle Add integration.
3. Suche nach Events API v2 und füge sie hinzu.
4. Kopiere den angezeigten Integration Key — einen 32-stelligen Schlüssel. Das ist der Wert, den InfraNest benötigt.

WarningVerwende nicht den API Access Key aus Integrations → API Access Keys (Schlüssel wie PSOJL90…). Dieser ist für die REST-API von PagerDuty gedacht, und InfraNest wird ihn ablehnen. Verwende immer den Events API v2 Integration Key eines Services.

PagerDuty verbinden

1. Gehe zu Benachrichtigungen, dann Ziele.
2. Wähle Ziel hinzufügen und dann PagerDuty.
3. Füge den Schlüssel in Integrationsschlüssel (Routing-Key) ein. InfraNest prüft ihn beim Speichern: Ein PagerDuty-Integrationsschlüssel besteht aus 32 Buchstaben und Ziffern, alles andere wird sofort abgelehnt, statt gespeichert zu werden und später zu scheitern.
4. Wähle Test senden, um einen Testalarm auszulösen und zu bestätigen, dass ein Vorfall in PagerDuty erscheint (du kannst ihn danach auflösen).
5. Wähle Speichern und testen.

Meldungen an PagerDuty senden

Sobald das Ziel gespeichert ist, wähle PagerDuty aus, wenn du entscheidest, welche Meldungen wohin gehen. Ein ausgefallener Monitor löst einen PagerDuty-Vorfall (kritisch) aus; wenn er sich erholt, löst InfraNest denselben Vorfall auf.

Bestätigen und Auflösen — in beide Richtungen

• Bestätigen oder Auflösen in InfraNest → der verknüpfte PagerDuty-Vorfall wird ebenfalls bestätigt/aufgelöst.
• Bestätigen oder Auflösen in PagerDuty → der InfraNest-Vorfall wird entsprechend aktualisiert.

Die zweite Richtung (PagerDuty → InfraNest) ist eine optionale, einmalige Einrichtung an deinem PagerDuty-Ziel — suche nach Zwei-Wege-Sync einrichten beim Ziel. Alarmierung und ausgehende Updates funktionieren sofort, allein mit dem Integrationsschlüssel.

Tipps

• Der Integrationsschlüssel wird sicher gespeichert und nach dem Speichern verborgen.
• Ein Ziel alarmiert einen PagerDuty-Service. Füge ein weiteres Ziel hinzu, um einen anderen Service oder ein anderes Team zu alarmieren.
• Automatisierungen können ebenfalls PagerDuty alarmieren, für Dinge, die ein Monitor nie sieht — ein ablaufendes Zertifikat, ein fehlgeschlagener Job.

NoteFür Alarmierung oder Zwei-Wege-Sync benötigst du keinen PagerDuty-REST-API-Schlüssel oder OAuth — nur den Integrationsschlüssel.

Fehlerbehebung

InfraNest akzeptiert den Schlüssel nicht. Der eingefügte Schlüssel hat nicht das richtige Format für einen Integrationsschlüssel, der immer aus 32 Buchstaben und Ziffern besteht. Meist handelt es sich um einen REST-API-Access-Key (diese sehen aus wie PSOJL90… und sind viel kürzer) oder einen Schlüssel mit einem Bindestrich. Folge dem Abschnitt Bevor du beginnst oben, um den Integrationsschlüssel aus dem Reiter Integrations deines Services zu holen, und füge diesen stattdessen ein.

Test fehlgeschlagen mit der Meldung „invalid routing key“. Dies ist dasselbe Problem von der anderen Seite — ein Ziel, das gespeichert wurde, bevor InfraNest mit der Schlüsselprüfung begann. Öffne das Ziel, füge den Events API v2 Integration Key deines Services ein und speichere.

Test senden meldet Test erfolgreich gesendet, aber in PagerDuty kommt nichts an. Ein Schlüssel mit korrektem Format, der aber zu einer gelöschten Integration gehört, wird von PagerDuty akzeptiert und führt dann ins Leere — PagerDuty antwortet in beiden Fällen mit „received“, sodass unsere Seite den Unterschied nicht erkennen kann. Öffne den Reiter Integrations des Services in PagerDuty, bestätige, dass die Events API v2-Integration noch vorhanden ist, und kopiere den Schlüssel erneut.

Es kommt keine Alarmierung an. Prüfe, ob das Ziel Aktiviert ist und ob die Meldungen des Monitors dorthin geleitet werden. Wähle erneut Test senden, um zu bestätigen, dass der Schlüssel funktioniert.

Eine echte Meldung hat keinen neuen PagerDuty-Vorfall erstellt. PagerDuty gruppiert wiederholte Meldungen zum selben Problem in einem offenen Vorfall, bis dieser aufgelöst wird — ein instabiler Monitor aktualisiert also den bestehenden Vorfall, statt eine neue Alarmierung auszulösen. Das ist das erwartete Verhalten; löse den Vorfall auf (oder warte auf die Wiederherstellung), und das nächste Vorkommnis löst eine neue Alarmierung aus.