Vorfälle gemeinsam in PagerDuty und InfraNest bearbeiten

Bearbeite einen Vorfall in PagerDuty oder InfraNest, je nachdem, welches Tool du gerade geöffnet hast — das ist für Teams gedacht, die PagerDuty verbunden haben und wollen, dass Updates synchron bleiben.

#Übersicht

• Bestätigen, Lösen und Hinzufügen von Notizen in einem Tool erscheint im anderen.
• Funktioniert automatisch, wenn du mit einem Klick verbunden hast; benötigt einen zusätzlichen Einrichtungsschritt, wenn du dich mit einem Integrationsschlüssel verbunden hast.
• Hält deine Statusseite und die Notizen deines Response-Teams sauber getrennt.

#Bevor du beginnst

Du brauchst ein unter Integrationen verbundenes PagerDuty-Konto. Wenn du mit einem Klick verbunden hast, ist der Zwei-Wege-Sync bereits aktiv. Wenn du einen Integrationsschlüssel eingefügt hast, lies zuerst den Abschnitt „Wenn du dich mit einem Integrationsschlüssel verbunden hast” weiter unten, bevor du fortfährst.

#In beiden Tools bestätigen und lösen

1. Bestätige oder löse den Vorfall in PagerDuty wie gewohnt. Innerhalb von Sekunden zeigt der passende InfraNest-Vorfall denselben Status an, zusammen mit dem Namen des Verantwortlichen (sofern dessen PagerDuty-E-Mail-Adresse mit der InfraNest-Adresse übereinstimmt).
2. Bestätige oder löse den Vorfall stattdessen in InfraNest, wenn du das bevorzugst — PagerDuty übernimmt das automatisch.
3. Sobald sich das zugrunde liegende Problem erholt, löst InfraNest den PagerDuty-Vorfall für dich. Teams, die Vorfälle lieber manuell schließen, können das in den PagerDuty-Paging-Einstellungen abschalten.

NoteEin Ausfall, eine Meldung. Wenn mehrere Monitore auf demselben Server gleichzeitig ausfallen, erhält PagerDuty einen einzigen Vorfall für den gesamten Ausfall. Das Bestätigen oder Lösen davon gilt für jeden InfraNest-Vorfall in diesem Ausfall.

Ein paar Sonderfälle, die man kennen sollte:

• Zusammenführen in PagerDuty: Wenn du dort Vorfälle zusammenführst, folgen die InfraNest-Vorfälle demjenigen, in den zusammengeführt wurde, und bleiben offen, bis dieser gelöst ist oder sich das Problem erholt.
• Erneut unbestätigt: Wenn eine Bestätigung in PagerDuty abläuft und es erneut alarmiert, hält InfraNest seinen eigenen Vorfall weiterhin als bestätigt. Eine Automatisierung kann trotzdem auf die neue Meldung reagieren.

#Vorfall-Notizen

1. In PagerDuty geschriebene Notizen erscheinen im Zeitverlauf des InfraNest-Vorfalls, markiert mit dem Verfasser und PagerDuty — zum Beispiel „Dana · PagerDuty”. Das sieht nur dein Team; sie erscheinen nie auf deiner Statusseite oder erreichen Abonnenten.
2. Updates, die du in InfraNest postest, werden zu einer PagerDuty-Notiz, die mit From InfraNest beginnt, zusammen mit deinem Namen und dem Status des Updates. Dafür ist ein mit einem Klick verbundenes Konto nötig.

Jede Notiz wird einmal kopiert und kommt nie zurück. Notizen werden nur für Vorfälle geteilt, die InfraNest ausgelöst hat, und nur bei Diensten mit aktiviertem Sync notes. Um das Teilen für einen Dienst zu beenden, gehe zu Integrationen, suche PagerDuty, finde den Dienst und schalte Sync notes aus.

#Sehen, wer Bereitschaft hat

Wenn du mit einem Klick verbunden hast, zeigt InfraNest, wen PagerDuty gerade alarmieren würde — zum Beispiel „On call: Dana Reyes (level 1) · Sam Ito (level 2)”:

• im PagerDuty-Konto, unter jedem Dienst;
• auf der Seite eines Monitors, für jeden Dienst, den dessen Meldungen erreichen;
• bei einem Vorfall, sobald PagerDuty dazu zurückgemeldet hat.

Die Namen sind höchstens wenige Minuten alt. Beim ersten Öffnen einer Seite wird womöglich kurz nichts angezeigt — öffne sie erneut, dann erscheinen die Namen. Ein mit einem Integrationsschlüssel verbundenes Konto zeigt keine Bereitschaftsnamen an, da ein Schlüssel keine Zeitpläne lesen kann.

#PagerDuty-Statusupdates auf deiner Statusseite veröffentlichen

Ein Status-Update in PagerDuty ist die Nachricht, die du für Personen außerhalb des Response-Teams schreibst. InfraNest kann es automatisch auf deiner Statusseite veröffentlichen, damit du es nicht zweimal schreiben musst.

1. Gehe zu Integrationen, suche PagerDuty und finde den Dienst.
2. Schalte Publish PagerDuty status updates on the status page ein. Das ist standardmäßig für jeden Dienst deaktiviert, da ein Status-Update oft Kunden oder interne Systeme nennt, während eine Statusseite öffentlich ist und deine Abonnenten per E-Mail benachrichtigt.

Sobald es aktiviert ist:

• Das Update erscheint auf der Statusseite des passenden Vorfalls, und Abonnenten werden per E-Mail benachrichtigt, genau wie wenn du selbst eines postest.
• Der Status des Vorfalls ändert sich nicht.
• Für einen Vorfall, der nicht auf einer Statusseite steht oder bereits gelöst ist, wird nichts gepostet.
• Ein langes, von PagerDuty gekürztes Update wird gekürzt veröffentlicht und endet mit „…”

Updates, die du in InfraNest schreibst, gehen als Notizen an PagerDuty, nicht als Status-Updates.

#Wenn du dich mit einem Integrationsschlüssel verbunden hast

Ein eingefügter Schlüssel kann alarmieren, aber er kann nicht den Webhook erstellen, den PagerDuty zum Zurückmelden verwendet. Erstelle ihn selbst:

1. Gehe in InfraNest zu Integrationen, suche PagerDuty und kopiere die auf dem Konto angezeigte Webhook-Adresse. Behandle sie wie ein Passwort.

2. Gehe in PagerDuty zu Integrations → Generic Webhooks (v3) und wähle New.

3. Füge die Adresse ein und abonniere mindestens incident.acknowledged und incident.resolved. Füge incident.annotated für Notizen und incident.status_update_published für Status-Updates hinzu.

4. Speichere. PagerDuty zeigt einmalig ein Signatur-Geheimnis an — kopiere es jetzt.

   

5. Füge es zurück in InfraNest in Signatur-Geheimnis ein und wähle Speichern. Die Zeile Inbound updates des Kontos zeigt Ready an.

#Wenn du kein PagerDuty-Admin bist

Nur ein PagerDuty Admin oder Account Owner kann den Webhook erstellen. Alles andere funktioniert auch ohne, richte also den Rest selbst ein und bitte einen Admin um diesen einen Schritt:

1. Wähle im Konto unter Integrationen, unter PagerDuty, Ask a PagerDuty admin.
2. Kopiere den Link, oder gib die E-Mail-Adresse des Admins ein und wähle Email it.
3. Der Admin öffnet ihn und meldet sich bei PagerDuty an. Er braucht kein InfraNest-Konto, und der Link zeigt ihm sonst nichts.

TipDer Link funktioniert einmal, für drei Tage, und nur für dein PagerDuty-Konto. InfraNest nutzt die Anmeldung des Admins einmal und vergisst sie danach. Du erhältst eine Benachrichtigung, sobald der Zwei-Wege-Sync aktiv ist.

#Gut zu wissen

• Ältere Einrichtungen. Wenn dein Workspace den Zwei-Wege-Sync eingerichtet hat, bevor jedes PagerDuty-Konto seinen eigenen Webhook hatte, zeigt die PagerDuty-Seite einen Hinweis an. Wähle Move to my account, und InfraNest verschiebt dich und entfernt den alten Webhook. Falls er den alten nicht findet, lösche ihn selbst unter Integrations → Generic Webhooks (v3) in PagerDuty.
• Nur dein PagerDuty-Konto kann deine Vorfälle aktualisieren. Jedes Update muss die Signatur von PagerDuty tragen, und jedes PagerDuty-Konto hat seinen eigenen Webhook und sein eigenes Geheimnis.
• Das Pausieren des Kontos stoppt Updates in beide Richtungen, bis du es fortsetzt.

#Fehlerbehebung

PagerDuty-Aktionen aktualisieren InfraNest nicht. Prüfe, ob die Zeile Inbound updates des Kontos Ready anzeigt. Wenn du mit einem Klick verbunden hast und das nicht der Fall ist, wähle Enable inbound synchronization. Prüfe bei einem Integrationsschlüssel, ob der Webhook incident.acknowledged und incident.resolved abonniert hat, ob die Adresse genau der von InfraNest angezeigten entspricht und ob das Geheimnis dasjenige ist, das PagerDuty diesem Webhook gegeben hat. Die Aktivität auf der PagerDuty-Seite listet jedes von PagerDuty gesendete Update auf und, wenn eines nicht angewendet wurde, den Grund dafür.

Ein manuell in PagerDuty erstellter Vorfall ist nicht in InfraNest erschienen. Das ist zu erwarten — nur von InfraNest ausgelöste Vorfälle sind verknüpft. Er kann trotzdem eine Automatisierung starten.

Eine Meldung hat keinen neuen PagerDuty-Vorfall eröffnet. PagerDuty gruppiert wiederholte Meldungen zum selben Problem in den bereits offenen Vorfall, sodass ein flatternder Monitor diesen aktualisiert, statt erneut zu alarmieren.

Ein Update ist nicht als Notiz in PagerDuty erschienen. Prüfe, ob Sync notes für den Dienst aktiviert ist, ob das Konto mit einem Klick verbunden wurde und ob nicht angezeigt wird, dass PagerDuty die Anmeldung nicht mehr akzeptiert. Falls doch, wähle Connect again.

Du findest nicht, wo du ein Geheimnis in PagerDuty festlegen kannst. Es gibt keins zum Festlegen: PagerDuty erstellt es und zeigt es einmal an, wenn du den Webhook erstellst. Falls du es verpasst hast, lösche den Webhook und erstelle ihn erneut.