# Instana Integration

## IBM Instana

IBM Instana is a fully automated observability platform built for cloud-native environments. It continuously monitors applications, infrastructure, and services in real time, surfacing issues before they affect users. This integration lets Instana push its alerts directly into ITOC360 via a generic webhook, so your on-call team gets notified through a single pane of glass regardless of where the issue originated.

### In Instana

#### Creating an alert channel

Navigate to **Settings** from the left sidebar, then open **Global settings** and go to **Events & alerts → Alert channels**. Click **Add alert channel** 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%2F4gzqG7T7Ex88F5BcNRBT%2Fimage.png?alt=media&#x26;token=04a0c8e7-59ab-42b5-bb96-6c31dceb495c" alt=""><figcaption></figcaption></figure>

In the dialog that appears, select **Generic webhook** from the list of unidirectional channel types and click **Add alert channel**.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FTvsAJC4hyO97m0dl63oI%2Fimage.png?alt=media&#x26;token=23df54da-f848-4fbf-b84c-cb507791af33" alt=""><figcaption></figcaption></figure>

Give the channel a name, paste your ITOC360 webhook URL into the **Webhook URLs** field, and click **Test channel** to verify the connection. You should see a confirmation that the test alert was delivered successfully.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FreXAp0VKIoG2B25Q1Fnz%2Fimage.png?alt=media&#x26;token=8368e145-d334-44a8-8d6b-4410dd02a28c" alt=""><figcaption></figcaption></figure>

Your webhook URL follows this format:

```
https://<url>?token=<x-itoc360-token>
```

Click **Create** to save the channel.

#### Creating a Smart Alert

With the alert channel in place, head to **Events** in the left sidebar and switch to the **Smart Alerts** tab. Click **Create Smart Alert**.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FWMMztLvjA18h3VGksWeT%2Fimage.png?alt=media&#x26;token=b0e360c1-c20e-4b2e-82c1-2c1fdd255e08" alt=""><figcaption></figcaption></figure>

In the trigger section, select **Erroneous calls** as the blueprint. This instructs Instana to fire an alert whenever the error rate on your monitored services exceeds the threshold you define.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FA6Azre1PFVgkUpcS2mEW%2Fimage.png?alt=media&#x26;token=c8a82806-209e-49aa-abc7-0305407c3108" alt=""><figcaption></figcaption></figure>

On the scope step, leave the defaults as they are — alerts will be scoped per application perspective across inbound calls.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FI8Uo3plKsCuHcfo2DHKW%2Fimage.png?alt=media&#x26;token=35dc3e4a-445a-4e20-9c55-a68d7c3ac69b" alt=""><figcaption></figcaption></figure>

On the threshold step, check **Warning** and set the value to your desired error rate percentage. Any value above zero will cause Instana to fire as soon as errors appear, which is useful for testing the integration.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FmePPiQJwBicTUmCeRaHR%2Fimage.png?alt=media&#x26;token=db62212b-6841-4e3d-959f-db8c1a2d102b" alt=""><figcaption></figcaption></figure>

Scroll down to the **Alert channels** section and click **Select alert channels**. Find the channel you created earlier, check it, and confirm the selection.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FBb3HoenZFC6xaz82ODKG%2Fimage.png?alt=media&#x26;token=63217117-ba03-4d6a-96e6-cf9d7eb42de5" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FqF5SoyOV4lj2yPgDs9C4%2Fimage.png?alt=media&#x26;token=4219d60c-8e71-4745-9990-7b88f080ff96" alt=""><figcaption></figcaption></figure>

Click **Create** to save the Smart Alert. It will immediately appear in the Smart Alerts list with its triggering condition and enabled state.

<figure><img src="https://4108595529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FimJRSa33y5Ej6rwXrBeA%2Fuploads%2FlZ34hiM9LrPnx1WkTzig%2Fimage.png?alt=media&#x26;token=1f4289d8-6858-443f-a318-c0c3680c61b7" alt=""><figcaption></figcaption></figure>

***

### In ITOC360

Go to **Sources**, click **Create Source**, and select **Instana** from the list. Copy the webhook URL shown on the source detail page and use it as the Webhook URL when configuring your alert channel in Instana, as described above.

itoc360 handles all Instana event types automatically. Issues and incidents trigger an alert when their state is `OPEN` and resolve it when the state reaches `CLOSED`. Presence events resolve when the entity comes back online. The severity field maps directly to priority — a severity of `5` (Warning) becomes Medium, while `10` (Critical) becomes Critical. Events that carry no severity, such as change events, default to Medium priority.
