Support
Connecting your account
Creating a token
- In Sentry, open User settings → Personal Tokens (on self-hosted: the equivalent auth token settings) and create a new token.
-
Choose scopes. For read-only browsing:
org:read,project:read,event:read. To triage from the app, addevent:write(resolve, archive, assign) andmember:read(assignee picker). - Copy the token and paste it into Tracebell's connect screen. Scopes cannot be changed after creation — if you picked too few, create a new token.
Self-hosted servers
Choose "Self-hosted" on the connect screen and enter your server's URL. The app uses the same API paths as sentry.io. Your server must be reachable from your phone (directly or via VPN) over HTTPS.
Common issues
- "Token invalid" right after pasting — check for truncation or extra whitespace; tokens are long. On self-hosted, also confirm the URL has no path after the host name.
- Buttons greyed out (resolve/assign) — your token is
missing
event:writeormember:read. Create a new token with those scopes. - Everything worked and suddenly stopped — the token was probably revoked or your organization membership changed. Reconnect with a fresh token.
- Lists feel slow or stop refreshing — Sentry applies rate limits per endpoint. The app backs off automatically and resumes when the limit resets.
Push notifications
On the free plan, registered devices get a daily digest of new issues (around 07:00 JST / 22:00 UTC), and every registered device gets a weekly summary. Tracebell Advanced replaces the daily digest with real-time delivery of every event (created, regressed, resolved) and its filters. Setup is the same for both:
- In Tracebell, open Profile → Notifications, tap Enable Notifications, and allow notifications.
- Tap Set Up Push Notifications. In Sentry, open Settings → Developer Settings → Custom Integrations and create an Internal Integration: set Issue & Event to Read (Sentry requires it to subscribe to issue webhooks), leave every other permission at “No Access”, turn on Alert Rule Action, and subscribe the webhook to issue events.
- Copy the integration's Client Secret, paste it into the app, and tap Register This Device. The app then shows your personal webhook URL.
- Paste that URL into the integration's Webhook URL field in Sentry and save. Optionally add “Send a notification via Tracebell” to your alert rules.
- Back in the app, send a test notification. With Advanced, choose which event types notify you in real time, and optionally limit them to selected Projects (up to 50) and a Minimum Level (Info, Warning, Error, or Fatal).
Creating an Internal Integration typically requires an Admin, Manager, or Owner role in the organization. If you are a Member, ask an owner to set it up, or use the app without push.
Privacy note: the relay never holds your Sentry token, and it does not store issue titles — they pass through it to Apple's push service only to deliver the notification. See the privacy policy.
How the filters work
- They apply to real-time pushes and to automatic Live Activity starts. The daily digest (free plan) and weekly summary still count every new issue, and issues you follow on the Lock Screen are not filtered.
- Metric alerts are filtered by project only. When Sentry does not say which project or level an event has, it is delivered rather than dropped.
Live Activity (Advanced)
Open an unresolved issue and tap Follow on Lock Screen. The Live Activity shows the issue's phase, events, users, alerts, and when it was last seen, on the Lock Screen and in the Dynamic Island. It ends when the issue is resolved or archived, and you can stop following at any time.
- Background updates come through the push relay, so they need notifications set up (above) for the issue's organization. They arrive when Sentry sends a webhook for the issue, not on a timer; adding “Send a notification via Tracebell” to an issue alert rule makes them more frequent. Without notifications, the Live Activity updates only while Tracebell is open and shows “Open Tracebell to refresh” after 30 minutes.
- Starting again: a followed issue's Live Activity can start again when the issue regresses or an alert fires.
- After a force-quit: if you swipe Tracebell away in the App Switcher, or Low Power Mode is on or Background App Refresh is off for Tracebell, iOS may not let the app start Live Activities or send their update token to the relay in the background. A Live Activity that started then shows “Open Tracebell to refresh” after 30 minutes, even with notifications set up. Open Tracebell and updates resume.
- Start Automatically (Profile → Notifications, off by default): an issue that regresses in the projects you watch, at or above your minimum level, can start a Live Activity on its own, but only while no Tracebell Live Activity is running.
- Limits: up to 3 Live Activities run at once; following a fourth ends the one updated least recently. iOS decides how often an app may start Live Activities in the background, and the relay sends at most 4 starts per hour, so a start can be skipped. iOS ends every Live Activity after 8 hours.
- Nothing appears? Check that Live Activities are on for Tracebell in the iOS Settings app, then use Send Test Live Activity in Profile → Notifications and lock your iPhone: a test Live Activity appears in about 10 seconds.
- In demo mode you can follow a sample issue; it plays sample updates while the app is open.
App icons (Advanced)
Open Profile → Appearance → App Icon and pick Paper, Mono, Signal, Amber, or Mint; Classic is always available. iOS confirms each change with a short alert. Without Advanced, and in demo mode, tapping an icon shows a preview and your Home Screen icon stays the same. If Advanced ends, the icon you chose stays until you switch back to Classic.
Purchases
- Plans: Tracebell Advanced is available monthly (¥500 / $2.99), annually (¥4,000 / $24.99, 14-day free trial), or as a one-time lifetime purchase (¥9,700 / $99.99). Tips in the app support development and unlock nothing.
- Restore: Profile → Plan → Restore Purchases (use the same Apple account).
- Cancel: subscriptions are managed in your App Store account settings, not in the app.
- Refunds are handled by Apple at reportaproblem.apple.com.
Feature requests and bugs
Email [email protected] with what you expected and what happened. Screenshots help — but please blur anything sensitive first.