Icinga

Learn how to connect Icinga to ZigiOps. Supported versions, integration user setup, connected system configuration, and available templates.

What is Icinga integration in ZigiOps?

Icinga is an open-source monitoring platform used to supervise infrastructure, services, hosts, and applications.

ZigiOps enables secure, agentless integration between Icinga and ITOM, ITSM, and monitoring platforms. Using ZigiOps, Icinga service status problems, metrics, host data, and topology information can be synchronized with downstream systems to support centralized monitoring and automated incident workflows.

With ZigiOps, Icinga can:

• Send service status problems as events to monitoring platforms

• Synchronize metrics to centralized observability systems

• Share host and hostgroup topology data

• Participate in end-to-end monitoring-to-resolution workflows

Which Icinga versions are supported?

Using a supported version is mandatory.

Product	Supported Deployment Types	Supported Versions
Icinga	All	2.x (or newer)

Are there any environmental prerequisites for Icinga?

The environmental prerequisites for this product are listed below.

Confirm the prerequisites of the corresponding integration template before continuing further, as some templates may not require all environmental prerequisites.

How do I prepare an Icinga integration user?

To ensure proper authentication and access control, it is recommended to create a dedicated integration user in Icinga.

Steps:

1. Log in to your Icinga instance.

2. Navigate to Icinga > Configuration > Access Control > Users.

3. Click Add a New User.

4. Enter the required details.

5. Click Add to create the user.

6. Navigate to Icinga > Configuration > Access Control > Roles.

7. Select the Administrators role.

8. Add the username of the newly created integration user to the Users field.

9. Click Update Role.

The integration user must have sufficient privileges to retrieve monitoring data.

How do I connect Icinga to ZigiOps?

Icinga - Connected System Configuration

Follow the steps below to add Icinga as a connected system in ZigiOps.

1

Log in to your ZigiOps instance

Log in to your ZigiOps instance.

2

Navigate to the Icinga connected system

Navigate to Connected Systems > Add New System > Icinga.

3

Configure the required parameters

Configure the following parameters:

Server URL Input the URL of your Icinga instance. Example: https://icinga.example.com:5665

Username Input the username of the Icinga integration user.

Password Input the password of the Icinga integration user.

Proxy Settings (optional) Enables the usage of a proxy server if required.

4

Save the system

If the settings are correct, click Save to store the system.

Once saved, Icinga becomes available for use in ZigiOps integration templates.

What are the most common Icinga integration use cases?

Use case 1: Sending service status problems to event management platforms

Icinga service status problems can be forwarded to event management systems such as OBM, enabling centralized event correlation.

Use case 2: Synchronizing Icinga metrics

Icinga metrics can be synchronized with monitoring platforms for unified visibility across infrastructure layers.

Use case 3: Topology synchronization

Icinga hosts and hostgroups topology can be synchronized with downstream systems to enrich topology models and support root-cause analysis.

What integration templates are available for Icinga?

ZigiOps provides prebuilt integration templates for Icinga.

Related Templates

• Icinga hostgroups topology - OBM topology

• Icinga hosts topology - OBM topology

• Icinga metrics - OBM metrics

• Icinga service status problems - OBM events

Each template includes:

• Predefined entity mappings

• Direction of synchronization

• Entity-specific logic and filtering rules

Templates are documented individually in the Integration Catalog.

Summary

The Icinga integration in ZigiOps enables:

• Secure, agentless connectivity to Icinga

• Support for Icinga 2.x and newer versions

• Authentication using a dedicated integration user

• Optional proxy configuration

• Ready-to-use templates for metrics, events, and topology synchronization