In this article, the screenshots and the GUI navigation described are not yet updated to Checkmk version 2.0.0. However, nothing fundamental has changed in the described functions themselves and most of the functions can be found quickly with the Monitor or Setup menu search of the Checkmk 2.0.0 user interface. We will update this article as soon as possible.
Opsgenie, now a part of Atlassian, as an incident management platform provides alerting and escalation for support teams, and can integrate many external tools, including Checkmk. The basic connection requires only an API key and a URL, but you can also specify other options in Checkmk, such as additional information depending on the notification’s source type.
2. Configuring Opsgenie
You can find a short guide on how to integrate Checkmk directly within Opsgenie — but this is based on an older Checkmk version where you had to pass a complete URL including API key. In current versions, you enter the URL and key separately. In addition, the URL is only required for accounts hosted in Europe.
Create a team or call up an existing one.
Choose the entry Checkmk under Integrations/Add Integration.
In the displayed — now incorrect instructions — you will find a URL under Paste, including options and API key. Copy the domain part of the URL (api.eu.opsgenie.com).
Next copy the API key and save the integration.
3. Configuration in Checkmk
For the connection it is now sufficient to specify the two copied data in Checkmk:
For the Notification Method choose the item Opsgenie.
Enter the copied key in API Key to use..
Activate — as an EU user — the option Domain, and paste the copied domain there.
You can test the connection using the commands, and set a host to DOWN via Fake check results. The Custom notification function will not generate an alert in Opsgenie at this point.
The configuration of the Opsgenie notification method provides you with all kinds of additional options, especially for enriching and changing the default contents of the notifications. In addition, you can use the Responsible teams item to specify the Opsgenie team if you have not specifically integrated for one team as described here, but for the entire Opsgenie account — which is only possible with certain subscriptions.