Datadog-Integrationshandbuch

Vorteile der PagerDuty + Datadog-Integration

• Benachrichtigen Sie diensthabende Helfer anhand von Warnmeldungen, die von Datadog gesendet werden.
• Senden Sie angereicherte Ereignisdaten von Datadog, einschließlich Visualisierungen der Metrik/des Service-Level-Indikators (SLI), der das Ereignis ausgelöst hat.
• Erstellen Sie Vorfälle mit hoher und niedriger Dringlichkeit basierend auf der Schwere des Ereignisses aus der Datadog-Ereignisnutzlast.
• Vorfälle und Eskalationen werden bei der Aktualisierung sowohl über PagerDuty als auch über Datadog synchronisiert.
• Vorfälle werden in PagerDuty automatisch behoben, wenn die Metrik in Datadog mit der bidirektionalen Synchronisierung wieder zum Normalwert zurückkehrt.

Wie es funktioniert

• Datadog-Metriken, die außerhalb eines festgelegten Bereichs liegen, senden ein Ereignis an einen Service in PagerDuty. Ereignisse von Datadog lösen einen neuen Vorfall beim entsprechenden PagerDuty Dienst aus, oder Gruppe als Warnungen in einen bestehenden Vorfall.
• Sobald die Metrik wieder im angegebenen Bereich liegt, lösen Das Ereignis wird an den PagerDuty Dienst gesendet, um den Alarm und den zugehörigen Vorfall bei diesem Dienst zu beheben.

Anforderungen

• PagerDuty Integrationen erfordern eine Basisrolle „Administrator“ zur Kontoautorisierung. Wenn Sie diese Rolle nicht haben, wenden Sie sich bitte an einen Administrator oder Kontoinhaber in Ihrer Organisation, um die Integration zu konfigurieren.

Integrations-Komplettlösung

In PagerDuty

Es gibt zwei Möglichkeiten, Datadog in PagerDuty zu integrieren: über Global Event Routing oder durch eine Integration in einen PagerDuty Dienst.

Wenn Sie Datadog zu einem bestehenden PagerDuty Dienst hinzufügen, fahren Sie bitte mit dem Integration mit einem PagerDuty Dienst dieses Handbuchs.

Integration mit globalem Event Routing

Durch die Integration mit Global Event Routing können Sie Ereignisse basierend auf der Nutzlast des Ereignisses von Datadog an bestimmte Dienste weiterleiten. Wenn Sie mehr erfahren möchten, lesen Sie bitte unseren Artikel über Regelsätze .

1. Aus dem Automatisierung wählen Sie Veranstaltungsregeln und klicken Sie auf Standardmäßiger globaler Regelsatz.

2. Klicken Sie im Bildschirm „Ereignisregeln“ auf den Pfeil neben Eingehende Ereignisquelle , um die Informationen zum Integrationsschlüssel anzuzeigen. Kopieren Sie Integrationsschlüssel . Dies ist derselbe Integrationsschlüssel, den Sie für jedes andere Tool verwenden, das Sie mithilfe von Ereignisregeln integrieren möchten. Wenn Sie die Einrichtung der Integration in Datadog abgeschlossen haben, kehren Sie zu dieser Schnittstelle zurück, um anzugeben, wie Ereignisse von Datadog an Dienste in PagerDuty weitergeleitet werden sollen.

 

Bewahren Sie diesen Schlüssel für spätere Verwendung an einem sicheren Ort auf. Sie können nun mit dem In Datadog Abschnitt weiter unten.

Notiz : Wenn Ihr Team bereits integriert hat mit Veranstaltungsregeln , Sie können dies überprüfen, indem Sie den PagerDuty Event Rules Integration Key in der Registerkarte „Integrationen“ von Datadog nachschlagen. Sie können dann die vorhandene Integration verwenden und Datadog-Ereignisse in Ihren Dienst leiten, indem Sie neue Ereignisregeln für Ihren Dienst schreiben.

Integration mit einem PagerDuty Dienst

Die direkte Integration mit einem PagerDuty Dienst kann von Vorteil sein, wenn Sie keine Warnmeldungen von Datadog an verschiedene Responder basierend auf der Ereignisnutzlast weiterleiten müssen. Sie können weiterhin Service-Level-Ereignisregeln um Aktionen wie das Unterdrücken nicht umsetzbarer Warnungen und das Anpassen des Schweregrads durchzuführen.

1. Aus dem Dienstleistungen wählen Sie Serviceverzeichnis .

2. Wenn Sie Ihre Integration zu einem bestehenden Dienst hinzufügen , klicken Sie auf den Namen des Dienstes, zu dem Sie die Integration hinzufügen möchten. Wählen Sie dann die Registerkarte „Integrationen“ und klicken Sie auf das Eine Integration hinzufügen .

Wenn Sie einen neuen Dienst erstellen für Ihre Integration lesen Sie bitte unsere Dokumentation im Abschnitt Konfigurieren von Diensten und Integrationen und befolgen Sie die Schritte im Neuen Dienst erstellen Wählen Sie Datadog als Integrationstyp in Schritt 4. Fahren Sie mit dem In Datadog (unten), sobald Sie diese Schritte abgeschlossen haben.

3. S wählen Datenhund von dem Integrationstyp Speisekarte.

4. Klicken Hinzufügen , um Ihre neue Integration zu speichern. Sie werden zur Registerkarte „Integrationen“ für Ihren Dienst weitergeleitet.

5. Suchen Sie Ihre Integration in der Liste und klicken Sie rechts auf ∨. Der Integrationsschlüssel Die hier generierten Daten werden verwendet, wenn Sie im nächsten Abschnitt die Integration mit Datadog konfigurieren.

In Datadog

Wenn Sie Datadog bereits installiert haben, fahren Sie bitte mit Schritt 6 fort.

1. Navigieren Sie in Ihrem Datadog-Konto zur Menüleiste Integrationen und klicken Sie auf Integrationen .

2. Suchen Sie nach PagerDuty und fahren Sie mit der Maus über das Symbol, um zu klicken Installieren .

3. Wählen Sie auf dem PagerDuty Integration-Bildschirm die Aufbau und klicken Sie dann auf Alarmierung mit PagerDuty .

4. Sie werden zu einem PagerDuty Autorisierungsbildschirm weitergeleitet. Es gibt zwei Möglichkeiten, die Integration zu autorisieren:

A. Geben Sie Ihre PagerDuty Anmeldeinformationen ein und klicken Sie auf Integration autorisieren .

B. Wenn Ihr Konto einen Single Sign-On-Anbieter verwendet, geben Sie Ihre Subdomäne ein und klicken Sie auf Melden Sie sich mit Ihrem Identitätsanbieter an .

5. Auf dem nächsten Bildschirm werden Ihnen mehrere Optionen angezeigt, die mit der Art Ihrer Integration korrelieren:

A. Wenn du bist Integration mit einem PagerDuty Dienst : wählen Verwenden einer Integration für einen vorhandenen Dienst und wählen Sie Ihren Dienst aus dem Dropdown-Menü aus.

B. Wenn du bist Integration mit Global Event Routing : wählen Erstellen Sie einen neuen Dienst mit einer Integration für Datadog Geben Sie einen Platzhalter ein Dienstname Und Eskalationsrichtlinie — dieser Dienst und alle seine Einstellungen werden in Schritt 6 (unten) durch Ihren Global Event Routing Integration-Schlüssel ersetzt.

C. Wenn Sie Ihre Auswahl getroffen haben, klicken Sie auf Integration abschließen .

6. Sie werden zurück zum PagerDuty Integrationsbildschirm in Datadog geleitet und Ihre neue Integration wird autorisiert. Auf diesem Bildschirm haben Sie mehrere Optionen, um Vorfälle in PagerDuty Diensten mit Datadog-Metriken zu korrelieren:

A. Benachrichtigen Sie PagerDuty mit @Erwähnungen: Wenn Sie Vorfälle in PagerDuty über den Datadog-Ereignisstrom auslösen, bestätigen oder beheben möchten, müssen Sie Ihren Integrationsschlüssel eingeben:

ich. Wenn du bist Integration mit Global Event Routing : Löschen Sie die vorab ausgefüllten Informationen im Dienst-/Regeltabellenname Und Felder „Integrationsschlüssel“/„Routingschlüssel“ und geben Sie einen Namen und den in Schritt 2 des Integration mit Global Event Routing Abschnitt.

ii. Wenn du bist Integration mit einem PagerDuty Dienst : Der Servicename und der Integrationsschlüssel, die in Schritt 5 des Integration mit einem PagerDuty Dienst Abschnitt wird für Sie vorab ausgefüllt und es ist keine Aktion erforderlich. Wenn Sie Ihrem Ereignisstrom mehrere Dienste hinzufügen möchten, geben Sie den Namen und den Integrationsschlüssel jedes Dienstes in das Feld
Dienst-/Regeltabellenname Und Felder „Integrationsschlüssel“/„Routingschlüssel“ .

B. Zeigen Sie in Ihrem Event-Stream an, wer Bereitschaft hat : Wenn Sie Ihre PagerDuty -Bereitschaftspläne in Ihrem Datadog-Ereignisstream anzeigen möchten, müssen Sie die PagerDuty Plan-URL abrufen. Navigieren Sie in PagerDuty zu Aufbau und wählen Sie Zeitpläne , klicken Sie dann auf den gewünschten Zeitplan und kopieren Sie dessen URL, die folgendermaßen aussehen sollte: https://YOURSUBDOMAIN.pagerduty.com/schedules#PXXXXXX . Fügen Sie dies in Datadog in das Zeitplan-URL Feld.

C. Sie haben dann zwei Möglichkeiten, Informationen von PagerDuty in Ihren Ereignisstream zu ziehen:

ich. API-Token : Um begrenzte Informationen über PagerDuty Vorfälle in Ihren Datadog-Ereignisstrom zu ziehen, geben Sie den PagerDuty REST-API-Schlüssel Hier.

ii. Zeigen Sie PagerDuty Vorfälle in Ihrem Ereignisstream an : (Empfohlen) Um Informationen zu PagerDuty in Ihren Datadog-Ereignisstream zu ziehen, befolgen Sie die in diesem Abschnitt beschriebenen Schritte.

D. Nachdem Sie diese Anmeldeinformationen eingegeben haben, klicken Sie auf Konfiguration aktualisieren am unteren Bildschirmrand.

 

7. Um die Integration zu testen, navigieren Sie zu Veranstaltungen → Strom im linken Menü und verfassen Sie dann einen Beitrag im Hinterlassen Sie ein Statusupdate … Feld mit @pagerduty-[Dienstname] (dh @pagerduty-Shopping-Cart Juhu, das ist mein erster Datadog-Alarm! ). Klicken Post und dieser Beitrag wird in Ihrem Datadog-Ereignisstream angezeigt und erstellt einen Vorfall in PagerDuty.

8. Sie können den PagerDuty Vorfall auch in Datadog bestätigen oder beheben, indem Sie Folgendes erwähnen: @pagerduty-bestätigen oder @pagerduty-entschlossen .

9. Notiz: Sie müssen diese Erwähnungen als Kommentar auf dem ursprünglichen Beitrag in Ihrem Ereignis-Stream. Sie können diese Erwähnungen einfach verwenden und/oder Kommentare hinzufügen, die als Teil der Bestätigungs- oder Lösungsnachricht im PagerDuty Vorfall angezeigt werden. Registerkarte „Zeitleiste“ :

FAQ

Ist es möglich, durch eine Datadog-Integration Warnmeldungen an mehrere Dienste weiterzuleiten?

Ja. Sie haben zwei Möglichkeiten: Integration mit globalem Event-Routing oder Hinzufügen mehrerer Dienste zur Konfiguration. Wenn Sie der Konfiguration mehrere Dienste hinzufügen, finden Sie in der PagerDuty -Integrationskonfiguration Ihren vorhandenen integrierten Dienst zusammen mit seinem Integrationsschlüssel. Klicken Sie darunter auf Zeile hinzufügen und Sie können eine andere Datadog-Integration in einen anderen Dienst eingeben.

Den zweiten Service können Sie dann referenzieren unter Benachrichtigen Sie Ihr Team in einem Datadog-Monitor, um Warnungen speziell für diesen Monitor an den anderen Dienst zu senden.

Sie können auch auf das klicken Sie hier Schaltfläche, um denselben Integrations-Setup-Workflow zu verwenden, der für die erste Integration verwendet wurde.

 

Ich sehe Ereignisse in meinem Datadog-Newsfeed von PagerDuty -Diensten, die ich nicht für die Integration auswählen; wie behebe ich das?

Standardmäßig ist die Alle verfügbaren PagerDuty Vorfälle anzeigen? Option in den PagerDuty Integrationseinstellungen in Datadog ausgewählt ist. Wenn Sie nur Ereignisse von den Diensten sehen möchten, die Sie in der Ereignisse nach Service filtern Einstellung sollten Sie diese Option in Ihrem Integrations-Setup deaktivieren.