Icinga Integration Guide

Icinga is an open source computer system and network monitoring application. Integrate AlertOps’ alert management platform with Icinga to receive and respond to critical alerts through email, SMS, push notification, and phone alerts. AlertOps ensures that alerts received from Airbrake always reach the correct, available team member by utilizing escalation policies and on-call schedules.

AlertOps Configuration

Step 1: From the main menu, hover over Integrations and then select Inbound Integrations from the sub menu.

Step 2: Select the Add Web API Integration button.

Step 3: You should now be on the Web API Integration Detail page. Select Icinga2 Hosts OR Icinga2 Services from the Integration Template dropdown menu. 

Step 4: Enter a name for the integration. Select a message rule to determine the integration's escalation policy. And, enter the names of recipient user(s) and recipient group(s). Click 'Save Changes.' Then, click 'Copy URL' to copy the URL endpoint to be used in the Icinga configuration.

Icinga Configuration

Step 1: Refer to Documentation on GitHub. Click here to view documentation.

Alert Triggering Information

Icinga2 Hosts: AlertOps will automatically create an incident when a new alert is received from Icinga with an IncidentStatus status of “DOWN.” If an alert with status “DOWN” matches an existing Open Alert, AlertOps will recognize the new alert as a duplicate and ignore the alert. The alert will be recorded in the Inbound Messages table as “Mapped Appended.”AlertOps will automatically close the same incident when an alert with an IncidentStatus status “UP” is received.

Icinga2 Services: AlertOps will automatically create an incident when a new alert is received from Icinga with an IncidentStatus status of “CRITICAL.” If an alert with status “CRITICAL” matches an existing Open Alert, AlertOps will recognize the new alert as a duplicate and ignore the alert. The alert will be recorded in the Inbound Messages table as “Mapped Appended.” AlertOps will automatically close the same incident when an alert with an IncidentStatus status “OK” is received.

Testing and Troubleshooting

Click here to read about Web API Testing and Troubleshooting. 

Did this answer your question?