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.
1. Opsgenie konfigurieren
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.
2. Checkmk konfigurieren
Wie Sie Benachrichtigungen im Allgemeinen in Checkmk einrichten, haben Sie bereits im Artikel über Benachrichtigungen erfahren.
In Checkmk genügt es nun, die beiden oben kopierten Daten anzugeben:
Erstellen Sie eine neue Benachrichtigungsregel mit Setup > Events > Notifications > Add rule.
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 — die Checkbox Domain und fügen Sie die kopierte URL ein:
Statt die URL hier direkt einzugeben, können Sie diese auch aus dem Passwortspeicher auslesen — sofern sie vorher dort hinterlegt wurde.
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 das gesamte Opsgenie-Konto integriert haben — was wiederum nur bei bestimmten Subskriptionen möglich ist.
Bei der Kontaktauswahl im folgenden Kasten Contact selection beachten Sie die folgenden beiden Punkte:
Sorgen Sie bei der Kontaktauswahl dafür, dass die Benachrichtigungen nur an einen Kontakt versendet werden, z. B. durch Auswahl eines einzelnen Benutzers. Bei den Benachrichtigungsmethoden zu Ticketsystemen & Co. dient die Kontaktauswahl nur dazu, festzulegen, dass benachrichtigt wird. Die Benachrichtigungen werden aber nicht an den ausgewählten Benutzer, sondern an das Ticketsystem gesendet. Beachten Sie, dass eine Kontaktauswahl über Kontaktgruppen, alle Kontakte eines Objekts oder ähnliches in den meisten Fällen mehrere identische Benachrichtigungen für ein Ereignis generiert, die dann doppelt, dreifach oder noch öfter im Ticketsystem landen.
Wenn der erste Punkt erfüllt ist, der Benutzer aber in mehreren Benachrichtigungsregeln für dieselbe Methode verwendet wird, dann greift jeweils nur die letzte Regel. Es empfiehlt sich daher, für jede dieser Benachrichtigungsregeln einen eigenen funktionalen Benutzer anzulegen.
Wie Sie die neue Benachrichtigungsmethode testen können, erfahren Sie im Artikel zu den Benachrichtigungen.