> ## 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 |

> [!NOTE]
>
> Use the API **auth token**, not a DSN. The DSN is the write-only SDK ingestion key and will not authorize reads.

## Setup

> [tab] Internal integration (recommended)
>
> An internal integration is org-scoped, least-privilege, and survives people leaving the team.
>
> **1. Create an internal integration**
>
> 1. In Sentry, go to **Settings** → **Custom Integrations** → **Create New Integration** → **Internal**
> 2. Give it a name (for example, `traversal-prod`)
> 3. Grant read access on the [scopes listed above](#required-scopes)
> 4. Copy the generated auth token
>
> **2. Configure in Traversal**
>
> Go to **Integrations**, select **Sentry**, and enter:
>
> * **Auth Token**: the internal-integration token you just created
> * **Organization Slug**: the org segment in your Sentry URLs (for example, `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 or self-hosted Sentry
>
> Click **Save**.

> [tab] Personal access token
>
> A personal auth token is tied to an individual account. Use it as a fallback if you can't create an internal integration.
>
> **1. Create a personal auth token**
>
> 1. In Sentry, go to **Settings** → **Auth Tokens** → **Create New Token**
> 2. Give it a name (for example, `traversal-prod`)
> 3. Select the read [scopes listed above](#required-scopes)
> 4. Make it non-expiring and copy the token. Sentry shows it only once
>
> **2. Configure in Traversal**
>
> Go to **Integrations**, select **Sentry**, and enter:
>
> * **Auth Token**: the personal auth token you just created
> * **Organization Slug**: the org segment in your Sentry URLs (for example, `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 or self-hosted Sentry
>
> Click **Save**.

## Private network access

If the service endpoint isn't directly reachable by Traversal (as is common with self-hosted services), deploy a [Traversal Connector](https://docs.traversal.com/architecture/connector.md) in a network that can reach it. When configuring the integration, select that connector under **Network Access Needed**. The service endpoint doesn't need public internet exposure.

See [Set up the Traversal Connector](https://docs.traversal.com/setup/connector.md) for deployment and network requirements.

## More information

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.