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

# Sentry

> Steadwing pulls error events, stack traces, and performance data from Sentry to correlate them with production incidents during root cause analysis.

## What does the Sentry integration do?

Steadwing connects to Sentry to pull error events, stack traces, and performance monitoring data from your Sentry projects. During root cause analysis, Steadwing correlates error patterns, stack traces, and performance issues with production incidents to identify the underlying causes.

## Why use Sentry with Steadwing?

<CardGroup cols={2}>
  <Card title="Error Correlation" icon="bug">
    Link production errors to specific incidents automatically
  </Card>

  <Card title="Stack Trace Analysis" icon="code">
    Analyze error stack traces to identify problematic code paths
  </Card>

  <Card title="Performance Insights" icon="gauge">
    Detect performance degradation patterns before and during incidents
  </Card>

  <Card title="Error Trends" icon="chart-line">
    Identify error spikes and anomalies that correlate with incidents
  </Card>
</CardGroup>

## Connection Methods

There are two ways to connect Sentry to Steadwing. You can use one or both together.

| Method                       | Best For                                      |
| ---------------------------- | --------------------------------------------- |
| **Marketplace App (OAuth)**  | Auto-triggering RCA when a Sentry alert fires |
| **API Token (Bearer Token)** | Querying Sentry as a data source during RCA   |

***

## Method 1: Sentry App (OAuth)

Connect the Steadwing Sentry App to enable automatic RCA triggers. Once installed, Steadwing launches root cause analysis the moment a Sentry alert fires no manual intervention needed.

<CardGroup cols={3}>
  <Card title="1-Click Installation" icon="mouse-pointer">
    Install directly from Steadwing Settings no manual Sentry configuration needed.
  </Card>

  <Card title="Auto-Trigger on Alerts" icon="bell">
    Steadwing automatically kicks off root cause analysis whenever a Sentry alert fires.
  </Card>

  <Card title="In-Depth Analysis & Noise Reduction" icon="magnifying-glass-chart">
    Get comprehensive analysis of every alert while filtering out noise.
  </Card>
</CardGroup>

### Step 1: Install Steadwing from the Sentry Marketplace

1. Go to the **Sentry Marketplace** (Sentry → Settings → Integrations)
2. Search for **Steadwing** and click **Install**
3. Authorize the connection it will redirect you back to Steadwing

### Step 2: Link to your Steadwing organization

1. After the redirect, select your Steadwing organization from the dropdown
2. Click **Complete Setup**
3. The app status will show **App installed** on the Sentry integration card

<Note>
  The Sentry App handles webhook delivery automatically. Steadwing receives Sentry alert events without any additional configuration.
</Note>

***

## Method 2: API Token (Bearer Token)

Connect Sentry as a **data source**, allowing Steadwing to query error tracking and performance data during root cause analysis.

### Step 1: Create a Sentry auth token

1. Log in to your Sentry account at [sentry.io](https://sentry.io)
2. Navigate to **Settings** → **Account** → **API** → **Auth Tokens**
   * Direct link: [https://sentry.io/settings/account/api/auth-tokens/](https://sentry.io/settings/account/api/auth-tokens/)
3. Click **Create New Token**
4. Configure the token:
   * **Name:** Steadwing Integration
   * **Scopes:** Select the following permissions:
     * `org:read` - Read organization information
     * `project:read` - Read project details
     * `event:read` - Read error events and issues
5. Click **Create Token**
6. Copy the generated token (it starts with `sntrys_`)

<Warning>
  Save your token immediately! Sentry only shows it once. If you lose it, you'll need to create a new token.
</Warning>

### Step 2: Connect Sentry in Steadwing

1. Navigate to [Steadwing Settings](https://app.steadwing.com/settings)
2. Find the **Sentry** integration card
3. Click **Connect via API Token**
4. Fill in the required fields:
   * **Bearer Token:** Your Sentry auth token (starts with `sntrys_`)
   * **Organization Slug:** Your Sentry organization slug
5. Click **Connect**

***

## What data does Steadwing pull from Sentry?

Steadwing queries Sentry for:

* **Error Events** - All errors and exceptions logged in your projects
* **Issue Details** - Stack traces, error messages, and affected users
* **Performance Data** - Transaction traces and slow queries
* **Event Metadata** - Tags, breadcrumbs, and environment information

## What permissions does the Sentry integration need?

The Sentry auth token must have these scopes:

* **org:read** - Read organization and team information
* **project:read** - Access project configuration and settings
* **event:read** - Read error events, issues, and performance data

### Limitations

* Historical data is limited to your Sentry plan's retention period
* API rate limits apply based on your Sentry plan tier
* Source map access requires separate configuration in Sentry

## FAQs

<AccordionGroup>
  <Accordion title="Do I need both connection methods?">
    No. The Marketplace App auto-triggers RCA when alerts fire. The API Token lets Steadwing query Sentry as a data source during analysis. Using both together gives you full coverage — automatic triggers plus deep data access.
  </Accordion>

  <Accordion title="What Sentry data does Steadwing access?">
    Steadwing reads error events, issues, stack traces, and performance data. Steadwing does NOT access user PII or session replays, and Steadwing never modifies any Sentry data.
  </Accordion>

  <Accordion title="Can I limit Steadwing's access to specific Sentry projects?">
    Yes, when creating the auth token, you can scope it to specific organizations and projects instead of granting global access.
  </Accordion>

  <Accordion title="Can I use Sentry Self-Hosted with Steadwing?">
    Currently, Steadwing supports Sentry SaaS (sentry.io). Self-hosted Sentry support is on our roadmap.
  </Accordion>

  <Accordion title="What if my Sentry auth token expires?">
    Sentry auth tokens do not expire unless manually revoked. If the integration is disconnected, create a new auth token and update it in Steadwing Settings.
  </Accordion>

  <Accordion title="Can I see which Sentry errors Steadwing analyzed?">
    Yes, the RCA report includes links to relevant Sentry issues, stack traces, and error events that were analyzed.
  </Accordion>
</AccordionGroup>

Need additional help? Please reach out to us at [hello@steadwing.com](mailto:hello@steadwing.com)