Sentry
Connect Sentry to build dashboards on issues and error trends, with OAuth through the Flitch integration or a personal token.
Read only access to one Sentry organization. Connect with OAuth by installing the Flitch integration in your organization, or paste a personal token. Flitch reads issues, projects, teams, and members, and never resolves, assigns, or deletes anything.
Objects
| Object | Fields |
|---|---|
| Issues (last 90 days) | ID, short ID, title, culprit, level, status, project, first seen, last seen, event count, user count, permalink |
| Projects | ID, slug, name, platform, created, team |
| Teams | ID, slug, name, member count, created |
| Members | ID, email, name, role, pending, created |
Issues include every status, resolved as well as unresolved, across every project the connection can see.
Scopes
Both methods need Read on:
project:read
team:read
event:read
org:read
member:readNo write scopes. Organization auth tokens cannot be used: Sentry limits them to CI tasks, so they cannot read issues.
Connect
Find your region and organization slug
Your region is where your organization stores its data: US or EU. The slug is in your Sentry address, acme in acme.sentry.io or sentry.io/organizations/acme.
Find your user ID (OAuth only)
To connect with OAuth, open User settings → Account details and copy your User ID. Sentry reports it when you install, which is how Flitch matches the install to your connection.
Create a token (personal token only)
To use a token, in Sentry open User settings → Personal Tokens → Create New Token. Grant Read on Project, Team, Issue & Event, Organization, and Member, and copy the sntryu_… token. Permissions cannot be changed after it is created.
Open Data
In app.flitch.io, open the Data page.
Add Sentry
Top right, click Add, pick Sentry.
Choose a method and connect
Pick OAuth or Personal token, choose the region, and enter the organization slug.
- OAuth: enter your user ID and connect, then open Sentry, find Flitch, and click Accept & Install. Flitch continues once Sentry reports the install.
- Personal token: paste the token and connect.
Pick objects and save
Tick the objects you want. Set a name. Save.
Each object becomes a dataset.
Refresh
Refresh is off by default. Every dashboard load runs a live query against Sentry. Enable refresh to schedule a background refresh and serve from cache between runs. See Refresh.
Disconnect
- In Flitch: open the connection from the Data page and delete it. Cache cleared.
- In Sentry: revoke the personal token in User settings → Personal Tokens, or uninstall Flitch in Settings → Integrations, to cut off access immediately.
Troubleshooting
Connecting with the integration never finishes. Sentry has not reported the install. Check that you clicked Accept & Install, and that the user ID you entered is your own.
Every object fails. The organization slug or region is wrong. An EU organization must use the EU region.
Issues are empty but projects are not. The token or integration is missing Issue & Event read access, or you are not a member of any team with projects.
Authentication failed. The token was revoked or the integration was uninstalled. Reconnect from the connection's settings.