Documentation & setup
Vedetta is a native iOS and Android client for Sentry that turns issue alerts into real-time push notifications you can triage from your phone. This page covers what the Sentry integration does, what it needs, how to install and connect it, and a changelog of changes.
What Vedetta is
Vedetta is an independent, native mobile client for Sentry.io. It delivers a Sentry issue to your phone the moment it fires, and lets you act on it on the spot: read the stack trace, event details, tags, breadcrumbs, and release health, then assign, resolve, ignore, or comment, the same triage you would do at your desk, without opening a laptop.
Vedetta is not affiliated with, endorsed by, or sponsored by Functional Software, Inc. (Sentry). "Sentry" is a trademark of its respective owner, used here only to describe compatibility. You connect Vedetta to your own Sentry organization with your own authorization.
What the Sentry integration does
The Vedetta integration is what makes real-time push work. When you install it on your Sentry
organization, it subscribes to your organization's issue webhook and links your
Sentry account to your specific device. From then on, when an issue is created in a project you
have selected, Sentry notifies Vedetta's push relay, which forwards the alert to your device
through Apple Push Notification service (iOS) or Firebase Cloud Messaging (Android).
Routing is per user and per organization. Alerts are scoped to the organizations and projects you pick, and they reach only the devices linked to your account. Every user authenticates individually through the integration; there is no shared secret and no shared inbox, and one organization's alerts are never visible to another.
What you need
- An iPhone on iOS 17 or later, or an Android device on Android 9 (API 28) or later.
- A Sentry account, and a Sentry User Auth Token to connect it (the app links you straight to the page that creates one).
- Notifications enabled for Vedetta on your device, so push alerts can be delivered.
You do not need to create a separate Vedetta account. You connect Vedetta to your own Sentry account with your own User Auth Token, which stays on your device. Self-hosted Sentry is supported with a custom base URL.
Install and connect
- Install the app. Get Vedetta from the App Store or Google Play. On first launch the app opens in demo mode on built-in sample data, so you can explore the full feature set before connecting anything.
-
Create a Sentry User Auth Token. On the Connect screen, tap
Create a User Auth Token in Sentry. Give it the read scopes
org:read,project:read, andevent:read. Addevent:write,member:read, andteam:readtoo if you want to resolve, assign, and comment from the app. - Paste the token and connect. Paste the token into the Connect screen and tap Connect. For self-hosted Sentry or a custom region, open Self-hosted / custom region and set your base URL first.
- You are connected. Your real projects and issues replace the demo data. Turn on notifications in Settings and new issues start arriving as push you can triage immediately, delivered by the Vedetta relay.
To connect a different organization, or to disconnect, open Settings in the app. Deleting the token in your Sentry account settings also revokes Vedetta's access at any time.
Using Vedetta
- Push to triage: tap an alert to jump straight to the issue, with its latest event and full stack trace.
- Triage actions: assign, resolve, ignore, and comment, with changes written back to Sentry in real time.
- Browse and search: projects, issue lists, saved searches, tag value drill-down, and event-by-event navigation.
- Releases and health: release list and detail with crash-free session and user rates.
- Alerts and activity: view your organization's alert rules and an issue's activity feed and notes.
Permissions and access
Vedetta uses the read scopes on your token (org:read, project:read,
event:read) to display your organization, projects, issues, events, and releases,
and the optional write scopes (event:write, member:read,
team:read) to perform the triage actions you take (assigning, resolving, ignoring,
and commenting). Real-time alerts are delivered by the Vedetta relay, fed by a Sentry
issue-alert webhook. Vedetta requests only the access these features need, and it never modifies
your project or organization settings.
You stay in control: the access is set by the scopes you grant the token, and can be revoked at any time by deleting the token in your Sentry account settings.
Privacy and data
Your Sentry data is fetched on demand to display in the app and is not sold or used for advertising. The push relay handles only what is needed to route an alert to the right device, and organizations are isolated from one another. Full details are in our Privacy Policy.
Vedetta Pro
Exploring Vedetta on built-in demo data is free, with no account or payment. Connecting your own Sentry organization for live data and push alerts is part of Vedetta Pro, an optional subscription that is free for the first month, then €9.99 a year. The exact price in your region is shown in the App Store or Google Play before you subscribe. If a subscription lapses, the app returns to the free demo experience and never locks you out. See the Terms of Service for details.
Support
Questions, problems, or feedback? Email hello@getvedetta.com and we will help.
Changelog
Initial public release of the Vedetta integration.
- Real-time push notifications for new Sentry issues, per user and per organization.
- One-tap install and connect through Sentry's integration screen, with per-user device linking and organization isolation.
- Native iOS and Android apps for full issue triage: assign, resolve, ignore, comment, plus releases, alert rules, saved searches, and activity.