Integrate > Icinga > Configure > Configuration options

Configuration Options

This appendix describes configurable options for integrating Icinga with OpsCx for Icinga. All options are configured with default values you can modify.

Option Description
Policy Parameters
Icinga_Hostname Icinga Domain Manager host name.
Icinga_Port

Port where the Icinga Domain Manager listens to the REST call.

Default: 5665
Icinga_Username Icinga Domain Manager API user name.
Icinga_Password Icinga Domain Manager API password.
Event Integration Parameters
Copy_XML

If enabled, it will copy the incoming raw data form Icinga domain server in XML format to the OpsCx system. The data files will get created in the location <OvDataDir>/datafiles/Icinga/Icinga_Event.xml

Default: FALSE
Opscx_SSL_Usage

Enable/Disable SSL usage for Event Integration. By default SSL Usage will be true.

Default: TRUE
Opscx_Port

Port Configured for OpsCx.

Default: 30005
UsePersistency *

If set to true, all incoming messages will first be persisted into a file-based store before sending them to the remote host.

Default: TRUE

The directory path, used for the persistence layer is <OvDataDir>/tmp/Icinga/leveldb.dat.

You will find a text file that is prefixed with 0000<number> in the leveldb.dat folder. All incoming messages will be persisted into this file.

Log Level

Log level for Event Integration.

Default: ERROR
Topology Integration
Topology Polling Interval

Interval at which Topology data will be fetched from Icinga Domain Manager. The interval value is in seconds.

Default: 3600
Opscx_SSL_Usage

Enable/Disable SSL usage for Topology Integration. By default SSL Usage will be true.

Default: TRUE
Opscx_Port

Port Configured for OpsCx.

Default: 30005
Copy_XML

If enabled, it will copy the incoming raw data form Icinga domain server in XML format to the OpsCx system. The data files will get created in the location <OvDataDir>/datafiles/Icinga/Icinga_Topology.xml

Default: FALSE
DNS_Lookup

In some cases the Icinga responses may have missing host name or IP address. If enabled, this option will provide a look up of all the missing host name and IP address.

Default: FALSE
Log Level

Log level for Topology Integration.

Default: ERROR
Backward Synchronization Parameters
Icinga_Acknowledge_Comment

Comment for acknowledging the events from OMi.

Value: Acknowledged from OMi
Icinga_Acknowledgement_Author

Author of the event acknowledgment.

Value: icingaadmin
OMi_Base_URL

Set the OMi root URL as value.

Example: https://commons.omiserver.net/

This value will be used to construct the OMi event link and will be sent with the acknowledgment comment. Clicking on the link Click here to go to OMI Event will redirect to the corresponding closed event in OMi.

If this value is not set, the OMi Event id will be sent with the acknowledgment comment.

Value: No default value

*The UsePersistency option is useful when data from OpsCx is not reaching OMi.

About Persistency

If the connection between OpsCx and OMi is interrupted the data cannot reach to OMi. By setting the UsePersistency field to TRUE, a copy of original data is persisted in tmp files. Once the connection is resumed, the data from the persisted files is sent to OMi. The maximum capacity of tmp file is 4 MB. After the file attains the maximum capacity, roll-over happens and a new file is created.

If data from the previous persistency file has not been sent to OMi, there will be a reference to old persistent file in the same folder. Once connection with OMi is resumed, those messages will be sent to OMi along with new messages, from the new file.

Send Help Center feedback