---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Configure event collection from an Icinga2 connector

# Configure event collection from an Icinga2 connector {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Configure the Icinga 2 (Icinga) connector instance to receive events while monitoring your network resources.{#configure-icinga-connector__Icinga2-connector}

## Before you begin

Role required: evt_mgmt_admin

Supported version: 2.4.1.

## Procedure

1. Navigate to AllEvent ManagementIntegrationsConnector Instances.
2. Click New.
3. On the form, fill in the fields.  
   {#configure-icinga-connector__table_wnl_553_mfb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Descriptive and unique name for the Icinga connector. |
   | Description | Description for the use of the Icinga event collection instance. |
   | Connector definition | Name of the required connector definition. Select Icinga2. |
   | Host IP | IP address where Icinga is installed. |
   | Credential | Permission to connect to Icinga. Click the search icon in the Credential field. Use Basic Authentication credentials. Either select the required credentials from the list or click New and create the required credentials on the Credentials form. If you create the credentials, save them using a unique and recognizable name, for example, ICINGA2CHCK. |
   | Event collection last run time | Last run time value. Automatically updated. |
   | Last event collection status | Last run status. Automatically updated. |
   | Event collection schedule (seconds) | Frequency, in seconds, that the system checks for new events from Icinga. The default value is 120 seconds. |
   | Last error message | Last error message. Automatically updated. |
   [Table 1. Connector Instance form]

   {#configure-icinga-connector__table_wnl_553_mfb}
4. Right-click the form header and select Save.  
   The connector instance values are added to the form and the parameters that are relevant to the connector appear.   

   1. debug: Display debug messages. Default value: false. Specify true to see debug messages.
   2. logPayloadForDebug: Display payload related debug messages. Default value: false. Specify true to see payload related debug messages.
   {#configure-icinga-connector__ol_q5v_2xg_ybc}
5. In the Connector Instance Values section, verify and where required, modify the default connector instance values.  
   {#configure-icinga-connector__table_ynl_553_mfb__entry__2}

   | Field | Description |
   |-|-|
   | debug | Display debug messages. Default value: <kbd class="ph userinput">false</kbd>. Specify <kbd class="ph userinput">true</kbd> to see debug messages. |
   | port | Number of the connector port. Default value: <kbd class="ph userinput">5665</kbd>. |
   | protocol | Type of protocol. Default protocol type: <kbd class="ph userinput">https</kbd>. |
   | alert_type | Provide the Icinga alert type details. There are 2 types of an alert in Icinga2: SOFT and HARD SOFT: Connector instance will pull a soft alert. HARD: Connector instance will pull a hard alert. |
   [ ]

   {#configure-icinga-connector__table_ynl_553_mfb}
6. **Optional:** In the MID Servers for Connectors section, specify a MID Server that is up and is valid.  
   If no MID Server is specified, an available MID Server that has a matching IP range is used.

   You can configure several MID Servers. If the first is down,
   the next MID Server is used. If that MID Server is not available, the next
   is selected, and so on. MID Servers are sorted according to the order that
   their details were entered into the MID Server for Connectors section.
7. Right-click the form header and select Save.
8. Test the connection between the MID Server and the Icinga connector.
   1. Click Test Connector.  
      If the test fails, follow the instructions that the error issues to correct the problem and then run another test.  
      Note:  
      Use a network tool, such as ping, to verify credential correctness and network connectivity from the MID Server to the external monitoring tool.
   2. After a successful test, select the Active check box.
   {#configure-icinga-connector__substeps_znl_553_mfb}
9. Click Update.
{#configure-icinga-connector__steps_vnl_553_mfb}

*[\>]: and then