> For the complete documentation index, see [llms.txt](https://docs.itoc360.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.itoc360.com/integrations/inbound-integrations/error-tracking-and-uptime/rollbar-integration.md).

# Rollbar Integration

### Overview

[Rollbar](https://rollbar.com/) is an error monitoring and tracking platform that captures exceptions, errors, and log messages from your applications in real time. By configuring a webhook notification channel in Rollbar, you can forward error alerts directly to ITOC360 and trigger your on-call escalation policies the moment a new issue is detected.

### Provider Configuration & Mapping

ITOC360 uses the `event_name` field from the Rollbar webhook payload to determine the alert type.

| Rollbar Event      | ITOC360 Type |
| ------------------ | ------------ |
| `new_item`         | ALERT        |
| `reactivated_item` | ALERT        |
| `reopened_item`    | ALERT        |
| `occurrence`       | ALERT        |
| `item_velocity`    | ALERT        |
| `exp_repeat_item`  | ALERT        |
| `resolved_item`    | RESOLVE      |

Priority is mapped from the `level` field on the item:

| Rollbar Level   | ITOC360 Priority |
| --------------- | ---------------- |
| `20` (debug)    | LOW              |
| `30` (warning)  | MEDIUM           |
| `40` (error)    | HIGH             |
| `50` (critical) | 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 **Rollbar** as your provider.
4. Save the configuration and copy the generated **Token**.

#### Step 2: Open Your Rollbar Project

1. Log in to your Rollbar account.
2. From the left sidebar, click **Projects** and select your project.

<figure><img src="/files/YK4SyiLdnlOlWblQqeLe" alt=""><figcaption></figcaption></figure>

#### Step 3: Configure the Webhook

1. Inside your project, go to **Settings → Notifications**.
2. Under **Available Channels**, click **Webhook**.

<figure><img src="/files/FmJLHqw7YfR35boNxvj1" alt=""><figcaption></figcaption></figure>

3. In the **URL** field, paste your ITOC360 webhook URL in the following format:

   ```
   https://api.itoc360.app/functions/v1/events?token=<x-itoc360-token>
   ```
4. Click **Save Settings**. The webhook status will change to **Enabled**.

<figure><img src="/files/KyFS4S2WGcNIxFrCqHEm" alt=""><figcaption></figcaption></figure>

#### Step 4: Verify the Rules

Rollbar automatically creates default notification rules when you enable the webhook. Make sure the following rules are active:

* **New Item → Post to Webhook** — triggers when a new error is detected
* **Item Reactivated → Post to Webhook** — triggers when a previously resolved error recurs
* **Item Resolved → Post to Webhook** — triggers when an item is resolved, which automatically closes the alert in ITOC360

You can add, edit, or remove rules from the same Webhook settings page based on your team's alerting preferences.

#### Step 5: Verify the Integration

Trigger a test error in your application or use Rollbar's **Send Test Notification** button on the Webhook settings page. The alert should appear in ITOC360 under the source you created.

When the item is resolved in Rollbar, ITOC360 will automatically close the corresponding alert.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.itoc360.com/integrations/inbound-integrations/error-tracking-and-uptime/rollbar-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
