Anleitung zur Integration von Datadog in Checkmk

Zur Absicherung des Zugangs müssen Sie in der Datadog-App einen API Key und einen Application Key erstellen. Diese sollte anschließend nur Checkmk zum Abrufen der Daten nutzen. Die Erstellung ist mit wenigen Klicks erledigt: Loggen Sie sich mit Ihren Zugangsdaten in die Datadog-App ein. Klicken Sie oben links auf das Suchfenster und suchen Sie nach „API Keys“.

• Im neuen Fenster sehen Sie die bisherigen API-Keys. Klicken Sie rechts oben auf + New Key.
• Vergeben Sie einen Namen für den API-Schlüssel. Ich habe mich für „Checkmk_API“ entschieden. Bestätigen Sie mit Create Key.

• Sie sehen nun ein Fenster mit der Key ID und dem Key. Kopieren Sie den Schlüssel, indem Sie auf „Copy Key“ klicken, die Key ID brauchen Sie nicht. Speichern Sie den Schlüssel und schließen Sie das Fenster.
• Jetzt klicken Sie links in der Menüleiste den Punkt Application Keys direkt unter API Keys.
• Klicken Sie im Fenster Application Keys rechts erneut auf blaue Schaltfläche „+ New Key“.
• Wählen Sie wieder einen beliebigen Namen. Ich habe mich für „Checkmk_App_Key“ entschieden.
• Bestätigen Sie wieder mit Create Key. Kopieren und speichern Sie den Applikationsschlüssel.

In diesem Tutorial erstellen Sie zwei separate Datadog-Hosts in Checkmk. Die Aufteilung auf zwei Hosts vereinfacht die Verwaltung in Checkmk. Mit dem ersten Host übernehmen Sie die Monitors aus Datadog als Monitoring-Services. Den zweiten Host nutzen Sie für die Events aus Datadog. Dieser Host wird später nur einen einzelnen Service für das Anzeigen der übertragenen Events haben.

• Klicken Sie auf Setup -> Hosts, und dann auf Add Host.
• Bei Hostname nutzen Sie einen Namen Ihrer Wahl. Ich habe mich für „datadog_monitors“ entschieden.
• Unter Network address klicken Sie auf „show more“ und aktivieren IP address family. Wählen Sie die Option „No IP“.
• Klicken Sie auf Save & go to folder. Damit haben Sie den Host für Ihre Monitors erstellt.

Da Sie zwei getrennte Hosts für Monitors und Events nutzen, müssen Sie auch die Datadog-Regel für jeden Host einmal aufsetzen. Fangen Sie mit der Regel für die Monitors an:

• Klicken Sie auf Setup und suchen Sie nach „datadog“.
• Unter Other integrations klicken Sie auf Datadog.
• Wählen Sie Add rule, um eine neue Regel zu erstellen.
• Unter Datadog fügen Sie bei Datadog instance den API-Schlüssel und den Applikationsschlüssel ein.
• Prüfen Sie bei API host, ob die URL der Datadog-API zur Hosting-Region Ihrer Datadog-Instanz passt. Details zu den Datadog-Sites finden Sie in der Datadog-Dokumentation. Bei mir stimmte die Voreinstellung.

Die Option HTTP proxy brauchen Sie, wenn die Kommunikation von Checkmk mit Datadog über einen Proxy-Server läuft. Bei mir ist dies nicht der Fall.

Jetzt kommen Sie zum wichtigsten Teil der Regel. Entscheiden Sie, was Checkmk importieren soll:

• Mit Fetch monitors aktivieren Sie den Import von Monitors. Es stehen Ihnen zwei Optionen zur Verfügung, um die Monitors zu filtern:
  • Mit Restrict by tags filtern Sie nach Tags in Datadog. Checkmk überträgt dann die Monitors, in deren Konfiguration ein bestimmter Tag auftaucht.
  • Mit Restrict by monitor tags können Sie Monitors übertragen, die Sie zuvor in Datadog mit einem Tag versehen haben. Ich trage hier „checkmk“ ein, da ich in Datadog alle Monitors, die ich in Checkmk übertragen möchte, mit diesem Tag markiert habe.

Welche Filteroption sich für Sie besser eignet, oder ob Sie beide kombiniert einsetzen sollten, hängt von Ihrer Datadog-Konfiguration ab. Restrict by tags eignet sich zum Beispiel, wenn Sie eine bestimmte Gruppe von Monitors komplett in Checkmk übertragen wollen. Zum Beispiel „linux“ für Linux-Systeme.

In meinem Beispiel habe ich einige Monitors in Datadog mit dem Monitor-Tag „checkmk“ versehen und mit Restrict by monitor tags nur diese zur Übertragung markiert. Gerade in größeren Datadog-Umgebungen ist es sinnvoll, bestehende Tags für einzelne Monitors zu vergeben und Restrict by monitor tags zu nutzen.

• Scrollen Sie nach unten zu Conditions. Aktivieren Sie Explicit hosts und wählen Sie Ihren Datadog-Host für Monitors. Bei mir ist das „datadog_monitors“.
• Speichern Sie die Regel mit Save.

Jetzt erstellen Sie eine neue Datadog-Regel, allerdings für die Datadog-Events.

• Suchen Sie unter Setup nach „datadog“ und klicken unter Other integration auf Datadog. Klicken Sie auf das zweite Symbol von vorne, um die eben erstellte Regel zu klonen.

• Der API-Schlüssel und der Applikationsschlüssel bei Datadog instance sowie die URL bei API host sind durch das Kopieren der Regel bereits richtig. Sie müssen hier nichts ändern.
• Deaktivieren Sie die Checkbox bei Fetch monitors und aktivieren Sie Fetch events, um die Übertragung der Events aus Datadog zu konfigurieren.
  • Bei Maximum age of fetched events empfehle ich die Default-Einstellung von 10 Minuten beizubehalten.
  • Mit Restrict by tags können Sie Tags aus Datadog verwenden, um die Events zu filtern. Ich möchte zum Beispiel sämtliche Events in Checkmk übertragen, die meine Datadog-Site selbst betreffen und nutze daher den Tag „source:datadog“. Damit sehe ich in Checkmk, wenn jemand die Konfiguration von Datadog verändert und beispielsweise einen neuen Monitor hinzufügt.

Möchten Sie zum Beispiel über einen Alert in Datadog informiert werden, müssten Sie bei Restrict by tags „source:alert“ eintragen.

Als letzten Schritt müssen Sie die automatische Service-Erkennung für die Datadog-Hosts starten.

• Gehen Sie auf Setup -> Hosts.
• Klicken Sie zunächst bei einem der Datadog-Hosts auf das gelbe Würfelsymbol. In meinem Beispiel starte ich mit meinem Host „datadog_monitors“.

• Warten Sie auf die automatische Service-Erkennung und überprüfen Sie die Services. Wenn Sie sämtliche Services in Checkmk übernehmen möchten, klicken Sie auf Accept all. Bei mir wurde zum Beispiel ein Service erkannt.