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.
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?
Error Correlation
Link production errors to specific incidents automatically
Stack Trace Analysis
Analyze error stack traces to identify problematic code paths
Performance Insights
Detect performance degradation patterns before and during incidents
Error Trends
Identify error spikes and anomalies that correlate with incidents
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.1-Click Installation
Install directly from Steadwing Settings no manual Sentry configuration needed.
Auto-Trigger on Alerts
Steadwing automatically kicks off root cause analysis whenever a Sentry alert fires.
In-Depth Analysis & Noise Reduction
Get comprehensive analysis of every alert while filtering out noise.
Step 1: Install Steadwing from the Sentry Marketplace
- Go to the Sentry Marketplace (Sentry → Settings → Integrations)
- Search for Steadwing and click Install
- Authorize the connection it will redirect you back to Steadwing
Step 2: Link to your Steadwing organization
- After the redirect, select your Steadwing organization from the dropdown
- Click Complete Setup
- The app status will show App installed on the Sentry integration card
The Sentry App handles webhook delivery automatically. Steadwing receives Sentry alert events without any additional configuration.
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
- Log in to your Sentry account at sentry.io
- Navigate to Settings → Account → API → Auth Tokens
- Direct link: https://sentry.io/settings/account/api/auth-tokens/
- Click Create New Token
- Configure the token:
- Name: Steadwing Integration
- Scopes: Select the following permissions:
org:read- Read organization informationproject:read- Read project detailsevent:read- Read error events and issues
- Click Create Token
- Copy the generated token (it starts with
sntrys_)
Step 2: Connect Sentry in Steadwing
- Navigate to Steadwing Settings
- Find the Sentry integration card
- Click Connect via API Token
- Fill in the required fields:
- Bearer Token: Your Sentry auth token (starts with
sntrys_) - Organization Slug: Your Sentry organization slug
- Bearer Token: Your Sentry auth token (starts with
- 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
Do I need both connection methods?
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.
What Sentry data does Steadwing access?
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.
Can I limit Steadwing's access to specific Sentry projects?
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.
Can I use Sentry Self-Hosted with Steadwing?
Can I use Sentry Self-Hosted with Steadwing?
Currently, Steadwing supports Sentry SaaS (sentry.io). Self-hosted Sentry support is on our roadmap.
What if my Sentry auth token expires?
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.
Can I see which Sentry errors Steadwing analyzed?
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.