About this page
This integration will provide the reader with information on how to integrate the Enterprise Alert® 2019 software with CheckMK. After consulting this article, the reader should have a clear understanding of how CheckMK forwards Events to Enterprise Alert , how to set up the CheckMK plugin in order to allow a connection between the two systems, and how to configure the connection itself in Enterprise Alert.
Enterprise Alert
Enterprise Alert is a software package you need to install along with your CheckMK system. CheckMK connect to Enterprise Alert via REST API. A free trial version of the software is available. The accompanying mobile apps are available in the appstores at no charge.
Integration Capabilities
Enterprise Alerts integration with CheckMK enables alert/incident status alerts. Active Directory-based user management. And more.
- Uses Enterprise Alert standard REST API to retrieve incidents
- Staff can acknowledge and take ownership for critical incidents that occur
- Alerts are escalated in case of no response
- On-call scheduling to alert the right people at the right time
- Execute remediation actions from your smart device
Scenarios
- Network Monitoring
- Database Monitoring
- Server Monitoring
- Application Monitoring
- And much more!
How to Integrate
In the following we describe the setup and configuration of the Enterprise Alert Package for Checkmk. You can find our official listing on the checkmk exchange
- Create a new REST API event source in Enterprise Alert.
- Get the Enterprise Alert package (EnterpriseAlert-1.0.mkp) for checkmk from GitHub (https://github.com/derdack/derdack-integration-checkmk).
- Upload the .mkp file in the checkmk portal under Extension Packages.
- Create a Notification Rule and configure Enterprise Alert as Notification Method. You would need to set the REST API URL and your API Key. Also select one user in order to trigger the rule.
- The alert notification is sent as an event to Enterprise Alert. and can be found under Incoming Events.
- Based on this event you can start to build an alert policy.
- Now you can test it by simulating an alert in checkmk. When checkmk detects an issue, the information is forwarded as an event to Enterprise Alert where your alert policy can then trigger the alert.
Extended 2-Way Integration
If you want to go beyond the integration as it has been described above. You will need an updated CheckMK system (version 2.0) and updated Enterprise Alert (version 9.0). Beside that you have just a couple of steps to go through. This includes activating the outbound webhook, getting a custom Main.JS file provided by us and replacing the default file. The detailed steps you can find below:
- Navigate to System -> Event Sources ->
and check the flag for “Enable outbound REST”
- Populate the Target URL with http://
- Download the checkMK sample Main.JS file from https://github.com/Derdack/derdack-2wayREST-samples
- Open the downloaded Main.JS file and update the parameters for user, password and URL
- Stop the Connector Host module from the Services.msc
- Go to …Enterprise AlertConnectorHostOutboundWebhooks
and replace the Main.JS file with the edited file - Start the Connector Host module from the Services.msc
This should be all that is necessary to get the status updates from Enterprise Alert9 to CheckMK2.0 going. From now on you will find the alert status updates for raised alerts in the comments of the affected system.
Any questions? Feel free to contact us directly.
