# Zabbix Integration

[Zabbix](https://www.zabbix.com/) is an enterprise-class open-source monitoring solution for networks, servers, applications, and cloud infrastructure. By importing the ITOC360 Watcher media type into your Zabbix instance, you can automatically forward problem and recovery alerts to ITOC360 and trigger your on-call escalation policies in real time.

### Provider Configuration & Mapping

ITOC360 uses the `status` field from the Zabbix payload to determine the alert type.

| Zabbix Status | ITOC360 Type |
| ------------- | ------------ |
| `PROBLEM`     | ALERT        |
| `RECOVERY`    | RESOLVE      |

Priority is mapped from the Zabbix event severity:

| Zabbix Severity  | ITOC360 Priority |
| ---------------- | ---------------- |
| `NOT_CLASSIFIED` | LOW              |
| `INFORMATION`    | LOW              |
| `WARNING`        | MEDIUM           |
| `AVERAGE`        | MEDIUM           |
| `HIGH`           | HIGH             |
| `DISASTER`       | CRITICAL         |

***

### Setup Instructions

#### Step 1: Get Your Webhook URL and Token

1. Log in to your ITOC360 platform.
2. Go to **Sources → Add Source**.
3. Select **Zabbix** as your provider.
4. Save the configuration and copy the generated **Token**.

#### Step 2: Import the ITOC360 Watcher Media Type

1. Download the ITOC360 Watcher media type file: **ITOC360\_Watcher\_7.0.yaml**

{% file src="<https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FolyLZPpSMX1iqpCViepj%2FITOC360_Watcher_7.0.yaml?alt=media&token=b2334583-742b-42ac-bcde-0ff33a885514>" %}

1. In Zabbix, go to **Alerts → Media types**.
2. Click the **Import** button in the top right corner.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FBZd0bHSRDOxy4tqPCGOE%2Fimage.png?alt=media&#x26;token=1d59e8b5-77bc-4b4d-b363-32ff4d45bb8a" alt=""><figcaption></figcaption></figure>

4. Select the downloaded **ITOC360\_Watcher\_7.0.yaml** file and click **Import**.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FviwcSIi3w3xj8ndZlmTG%2Fimage.png?alt=media&#x26;token=8f67a4dd-ffbe-428b-b09c-8065fbb6ebae" alt=""><figcaption></figcaption></figure>

5. The media type will be imported and opened automatically. Find the **token** parameter and replace `<PLACE TOKEN>`with the token you copied in Step 1.
6. Click **Update** to save.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FAXEBuNqx6lwS4lEPaSTM%2Fimage.png?alt=media&#x26;token=1e2f211f-24b7-41bc-b4cc-cea24da0b002" alt=""><figcaption></figcaption></figure>

***

#### Step 3: Create a User Group

1. Go to **Users → User groups**.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FKbk2LEcJItEz5x0InBQQ%2Fimage.png?alt=media&#x26;token=3e41d6d0-bce1-499f-8cc9-5d2d9b7b3cfa" alt=""><figcaption></figcaption></figure>

2. Click **Create user group**.
3. Set the **Group name** to `ITOC360`.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2F8gLqos1hmZlBgN5UZNpF%2Fimage.png?alt=media&#x26;token=b380d40a-06a3-45fa-a5ba-ad5e16c1945d" alt=""><figcaption></figcaption></figure>

4. Switch to the **Host permissions** tab.
5. Click **Select**, choose the host groups you want ITOC360 to receive alerts for, and set permission to **Read**.
6. Click **Update** to save.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2F7R4IS1Mjz6sODsHPcT97%2Fimage.png?alt=media&#x26;token=bb8669ec-0d71-4b46-b5de-f4124e1ced49" alt=""><figcaption></figcaption></figure>

#### Step 4: Create a User

1. Go to **Users → Users**.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FaCqxER6AcMVXOorYu8Gc%2Fimage.png?alt=media&#x26;token=209cbbfc-838d-4931-b13e-11bb51dd8302" alt=""><figcaption></figcaption></figure>

2. Click **Create user** and fill in the form:
   * **Username:** `ITOC360`
   * **Groups:** Add the `ITOC360` group you created above.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FVTVjrlIQ12TAzXcbkLsT%2Fimage.png?alt=media&#x26;token=1014640d-3a79-4311-9189-73e9caab2ccf" alt=""><figcaption></figcaption></figure>

3. Switch to the **Media** tab and click **Add**:
   * **Type:** `ITOC360 Watcher`
   * **Send to:** `ITOC360`
   * Leave all severity checkboxes enabled.
   * Click **Add**.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2F5z0kUCqfOKJjBNrQMKLE%2Fimage.png?alt=media&#x26;token=d2de2f05-3f19-473e-8963-6a31e4e7bff4" alt=""><figcaption></figcaption></figure>

4. Switch to the **Permissions** tab and set **Role** to `Super admin role`.
5. Click **Add** to save the user.

#### Step 5: Create a Trigger Action

1. Go to **Alerts → Actions → Trigger actions**.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2F3jRANzXowPoBAQ4g8KhA%2Fimage.png?alt=media&#x26;token=e38d2353-be53-4c19-b527-b2c810a345b4" alt=""><figcaption></figcaption></figure>

2. Click **Create action**
3. Switch to the **Operations** tab:
   * Click **Add** under Operations.
   * Set **Send to user groups** to `ITOC360`.
   * Click **Add**.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FRuj0KVdiFBtlTVsGi0rZ%2Fimage.png?alt=media&#x26;token=797f3765-d1e3-4c7b-a693-d45ca561af3f" alt=""><figcaption></figcaption></figure>

4. Switch to the **Recovery operations** tab and repeat the same configuration.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FRGqYNzUrxEcFXCBLyIfV%2Fimage.png?alt=media&#x26;token=3c533a89-e3af-46c9-aa80-dfe08417b106" alt=""><figcaption></figcaption></figure>

5. Click **Add** to save the action.

***

#### Step 6: Verify the Integration

Once a problem is detected in Zabbix, it will automatically be sent to ITOC360 as an alert. When the problem is resolved in Zabbix, the corresponding alert in ITOC360 will be automatically closed.

To test the integration, you can add a host with an unreachable IP address — Zabbix will detect it as down and trigger an alert to ITOC360.