# Sentry
## Set up ### Navigate to the Integration settings view 1. Select an app in the top left corner from the Switcher 2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar 3. Click on **Integrations** in the sidebar ### **Connect Sentry** * Find the **Sentry** integration module under the **Stability monitoring** section * Click the **Connect** button * Enter an Auth Token * Generate a User Auth Token in Sentry by going to :link: [**User Settings > API > User Auth Tokens**](https://sentry.io/settings/account/api/auth-tokens/) (Runway specifically requires a User Auth Token, versus a token from a Sentry internal integration, because of Sentry limitations on certain endpoints Runway uses) {% hint style="warning" %} Required scopes for the Sentry API key are: * `org:read` * `project:write` *(required in order for Runway to* [*upload dSYMs*](/automations/types-of-automations.md#download-dsyms-from-app-store-connect-and-upload-to-stability-monitoring)*)* * `event:read` * `project:releases` * Note that in the Sentry UI, this scope may be called `releases:admin` {% endhint %} * Click **Save**; you’ll be presented with a dialog in which to select your Sentry organization, project and prod environment (and optionally a beta environment, if you have a [beta testing integration](/integrations/beta-testing.md) connected) for this app. * If your team's Sentry instance is in a custom/non-US region, additional configuration will be needed – please reach out to us to complete setup. #### Release identifiers Your Sentry release identifiers should have the format `@+` (e.g. `com.example.myapp@1.2.0+451`) as outlined by Sentry in their docs for [iOS](https://docs.sentry.io/platforms/apple/guides/ios/configuration/releases/#bind-the-version) and [Android](https://docs.sentry.io/platforms/android/configuration/releases/#bind-the-version). {% hint style="info" %} Note that Runway does not create new releases in Sentry; it only fetches data for existing releases. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.runway.team/integrations/stability-monitoring/sentry.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.