# Icinga

### 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.

{% hint style="info" %}
Confirm the prerequisites of the corresponding integration template before continuing further, as some templates may not require all environmental prerequisites.
{% endhint %}

### 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.

{% stepper %}
{% step %}
Log in to your ZigiOps instance

Log in to your **ZigiOps** instance.
{% endstep %}

{% step %}
Navigate to the Icinga connected system

Navigate to **Connected Systems > Add New System > Icinga**.
{% endstep %}

{% step %}
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.
{% endstep %}

{% step %}
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.
{% endstep %}
{% endstepper %}

### 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigiwave.com/available-systems/icinga.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.