1. Funktion
Opsgenie, mittlerweile Teil von Atlassian, bietet als Incident-Management-Plattform Benachrichtigungen und Eskalationen für Teams und kann dabei viele externe Tools integrieren, darunter auch Checkmk. Die grundsätzliche Anbindung benötigt lediglich einen API-Schlüssel und eine URL. Sie können in Checkmk jedoch auch weitere Optionen festlegen, beispielsweise zusätzliche Informationen je nach Art der Quelle der Benachrichtigung.
2. Konfiguration Opsgenie
Zur Integration von Checkmk finden Sie direkt innerhalb von Opsgenie eine kurze Anleitung — die sich jedoch auf eine ältere Checkmk-Version bezieht, in der Sie noch eine komplette URL samt API-Schlüssel übergeben mussten. In aktuellen Versionen geben Sie URL und Schlüssel separat ein. Zudem ist die URL nur für in Europa gehostete Accounts nötig.
Legen Sie ein Team an oder rufen Sie ein bestehendes auf.
Wählen Sie unter Integrations/Add Integration den Eintrag Checkmk.
In der nun angezeigten, fehlerhaften Anleitung finden Sie unter dem Punkt Paste eine URL samt Optionen und API-Key. Kopieren Sie den Domain-Teil der URL (
https://api.eu.opsgenie.com).Kopieren Sie anschließend noch den API-Schlüssel und speichern Sie die Integration.
3. Konfiguration Checkmk
Wie Sie Benachrichtigungen im Allgemeinen in Checkmk einrichten, haben Sie bereits im Artikel über Benachrichtigungen erfahren. Für die Anbindung genügt in Checkmk nun die Angabe der beiden kopierten Daten:
Wählen Sie als Notification Method den Eintrag Opsgenie.
Geben Sie unter API Key to use den kopierten Schlüssel ein.
Aktivieren Sie — als EU-Nutzer — den Punkt Domain und fügen Sie die kopierte URL ein.
Zum Testen können Sie das Kommando Fake check results verwenden und etwa einen Host auf DOWN setzen. Das Kommando Custom notification generiert an dieser Stelle hingegen keine Benachrichtigung in Opsgenie.
Die Konfiguration der Benachrichtigungsmethode Opsgenie bietet Ihnen allerlei weitere Optionen, insbesondere zum Anreichern und Ändern der Standardinhalte der Benachrichtigungen. Darüber hinaus können Sie über den Punkt Responsible teams das Opsgenie-Team festlegen, wenn Sie nicht wie hier beschrieben speziell für ein Team, sondern für den gesamten Opsgenie-Account integriert haben — was wiederum nur bei bestimmten Subskriptionen möglich ist.