Integrate > Icinga

Icinga

Icinga is an open source monitoring system which checks the availability of your network resources, notifies users of outages, and generates performance data for reporting. Operations Connector for Icinga (OpsCx for Icinga) integrates Icinga and Operations Manager i (OMi) so that the gathered systems-management data about the events and topology in an Icinga environment is made available to the OMi solution. Such data can then be monitored and processed properly within OMi. OpsCx for Icinga therefore enables you to establish a link between an Icinga environment and operations management in OMi.

For a list of the OpsCx for Icinga products and their release versions that Operations Connector supports, see Supported Icinga Versions topic.

For information about Icinga products, their individual releases and features, see the documentation on the Icinga website.

Key concepts

OpsCx for Icinga is a product complementary to Operations Connector (OpsCx). It enhances OpsCx to provide the following functionality:

  • Collection of Icinga events and topology data from an Icinga environment.

  • Mapping of the collected data to an OMi-compliant form.

  • Customization of the data collection and data mapping.

  • Acknowledgment of Icinga events from OMi by using backward synchronization of the event resolution states.

OpsCx for Icinga supports cluster environment of OpsCx system. For more information on OpsCx cluster environment, see Operations Connector User section.

Event Collection and Forwarding

OpsCx for Icinga makes Icinga events available to OMi as follows:

  1. Events are received from Icinga through the icinga web service via REST API.

  2. In OpsCx for Icinga, the received events are processed and sent to the REST Web Service endpoint of OpsCx.

  3. The collected events are mapped with a OpsCx for Icinga policy of the REST Web Service Listener type, and then forwarded to OMi.

  4. The Event Alerts from Icinga with event type Statechange are collected and forwarded to OMi.

OpsCx for Icinga enables tracing of Icinga alert that triggers an OMi event. It also supports close-state propagation of events. Whenever an alert is closed in Icinga, the corresponding event in OMi is also closed. Additionally, if backward synchronization of event resolution states is enabled, for each event that you close in OMi the corresponding Icinga alert is acknowledged. Other alert updates are not propagated back to Icinga.

Topology Collection and Forwarding

OpsCx for Icinga makes Icinga topology available to OMi as follows:

  1. Topology data are received from Icinga through the icinga web service through REST API.

    OpsCx for Icinga identifies hostnames and IP addresses from the REST API and forwards topology data to OMi.

  2. The constructed topology data is mapped by using a OpsCx policy, and then forwarded to OMi.

The following CI types are created by default:

  • Nodes: UNIX, Linux, or Windows systems are node CIs that are discovered by Icinga.
  • IP addresses: By default, CIs are created for the IPv4 or IPv6 address of a node.

The following table shows how Icinga topology data is mapped:

Icinga Type OMi CI Type Topology Map
Host Group CI Collection
Host Computer
IPaddress attribute of a Host IP address

Product Limitations

This section describes known limitations in OpsCx for Icinga:

Event forwarding to OMi

During downtime of OpsCx server, the Icinga alerts generated are not collected and forwarded to OMi even after the OpsCx server is restarted. However, new alerts generated gets forwarded.

Related topics

Supported Icinga Versions