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

# Sentry

> Connect Sentry for error tracking and issue context during investigations.

Connecting Sentry lets Traversal pull error context and issue information so it can reference ongoing and past incidents during investigations.

## What Traversal reads

* **Events** — error and performance events
* **Issues** — grouped errors with status and metadata
* **Releases** — release metadata used to correlate errors with deploys

Traversal only ever reads from Sentry — every scope below is read-only.

## Required scopes

Grant the following read-only scopes. If your Sentry instance offers Read / Write / Admin access per resource, set everything to **Read**.

| Scope              | Used for                                                      |
| ------------------ | ------------------------------------------------------------- |
| `event:read`       | Reading error and performance events                          |
| `project:read`     | Resolving projects to scope queries                           |
| `project:releases` | Reading release metadata to correlate errors with deploys     |
| `org:read`         | Reading organization metadata                                 |
| `member:read`      | Resolving members referenced on issues                        |
| `team:read`        | Resolving teams that own projects                             |
| `alerts:read`      | Reading alert rules to correlate issues with triggered alerts |

<Info>
  Use the API **auth token**, not a DSN — the DSN is the write-only SDK ingestion key and will not authorize reads.
</Info>

## Setup

<Tabs>
  <Tab title="Internal Integration (Recommended)">
    An internal integration is org-scoped, least-privilege, and survives people leaving the team.

    <Steps>
      <Step title="Create an internal integration">
        1. In Sentry, go to **Settings → Custom Integrations → Create New Integration → Internal**
        2. Give it a name (e.g. `traversal-prod`)
        3. Grant read access on the [scopes listed above](#required-scopes)
        4. Copy the generated auth token
      </Step>

      <Step title="Configure in Traversal">
        Go to **Company Knowledge → Integrations**, select **Sentry**, and enter:

        * **Auth Token** — the internal-integration token you just created
        * **Organization Slug** — the org segment in your Sentry URLs (e.g. `my-org` in `sentry.io/organizations/my-org`)
        * **Base URL** *(optional)* — leave blank for `sentry.io`. Set `https://de.sentry.io` for the EU region, or your instance URL for single-tenant / self-hosted Sentry

        Click **Save**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Personal Access Token">
    A personal auth token is tied to an individual account — use it as a fallback if you cannot create an internal integration.

    <Steps>
      <Step title="Create a personal auth token">
        1. In Sentry, go to **Settings → Auth Tokens → Create New Token**
        2. Give it a name (e.g. `traversal-prod`)
        3. Select the read [scopes listed above](#required-scopes)
        4. Make it non-expiring and copy the token — it is only shown once
      </Step>

      <Step title="Configure in Traversal">
        Go to **Company Knowledge → Integrations**, select **Sentry**, and enter:

        * **Auth Token** — the personal auth token you just created
        * **Organization Slug** — the org segment in your Sentry URLs (e.g. `my-org` in `sentry.io/organizations/my-org`)
        * **Base URL** *(optional)* — leave blank for `sentry.io`. Set `https://de.sentry.io` for the EU region, or your instance URL for single-tenant / self-hosted Sentry

        Click **Save**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## More information

* [Sentry API authentication](https://docs.sentry.io/api/auth/)
* [Sentry internal integrations](https://docs.sentry.io/organization/integrations/integration-platform/internal-integration/)