> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deductive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Rollbar

> Connect Rollbar to Deductive AI to enable reasoning over your rollbar data.

## Overview

Deductive connects to Rollbar to help you analyze errors, track deployments, and investigate issues across all your Rollbar projects. The setup process automatically creates read-only access tokens for each of your projects, so you only need to configure the connection once—even if you have many projects.

## Step 1: Create an Account Access Token (Temporary)

Generate a temporary Rollbar **account** access token with write scope. Deductive uses this token once to create read-only project tokens for all your projects, then you can delete it.

1. Log in to your Rollbar account
2. Go to **Account Settings** → **Account Access Tokens**
3. Click **Create new access token**
4. Name the token (e.g., `Deductive Setup - Temporary`)
5. Select **write** scope (required to create project tokens) and **read** scope (required to view project tokens)
6. Click **Create** and copy the access token immediately

<Note>
  Rollbar only shows the token value once at creation time. Make sure to copy it before closing the dialog.
</Note>

**Related Documentation**: [Rollbar Access Tokens Documentation](https://docs.rollbar.com/docs/access-tokens)

## Step 2: Generate Project Tokens

In the Deductive integration settings:

1. Paste your account access token
2. Click **Generate Project Tokens**
3. Review the list of projects that were set up (you'll see a success/failure indicator for each)
4. Click **Save** to store the read-only project tokens

Deductive will automatically:

* Discover all projects in your Rollbar account
* Create a dedicated read-only token for each project (named `deductive-{project}`)
* Store only the read-only tokens—the account token is never saved

## Step 3: Delete the Account Token (Recommended)

For security, you can delete the temporary account access token after setup:

1. Return to **Account Settings** → **Account Access Tokens** in Rollbar
2. Find and delete the temporary token you created
3. Your Deductive integration will continue working with the read-only project tokens

<Info>
  Deductive only stores read-only project tokens. These tokens can view error data but cannot modify your Rollbar configuration or create new tokens.
</Info>

## Capabilities

Once connected, Deductive can:

* **View errors and items**: Access error details, stack traces, and metadata
* **Analyze occurrences**: Review individual error occurrences and their context
* **Track deployments**: Correlate errors with deployment events
* **Query with RQL**: Run Rollbar Query Language queries for advanced analysis
* **Access reports**: View top active items and occurrence statistics
* **Check environments**: See which environments are configured

## Field Reference

The following fields are used when configuring this integration:

| Field                    | Description                                                               |
| ------------------------ | ------------------------------------------------------------------------- |
| **Account Access Token** | Temporary token with write scope used only during setup (not stored)      |
| **Project Tokens**       | Auto-generated read-only tokens for each project (stored as JSON mapping) |

## Troubleshooting

### "Invalid access token" during setup

Ensure your account access token has **write** scope. Read-only account tokens cannot create project tokens.

### A project failed to set up

Some projects may have restricted permissions. Check that your Rollbar account has access to all projects you expect to see. Projects that fail will show an error message—you can still use Deductive with the projects that succeeded.

### Need to reconnect or update tokens

Simply repeat the setup process with a new account access token. Deductive will automatically replace any existing project tokens with fresh ones.
