# Sentry

<div align="left"><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjFmyReUsbJqDjHEAlW%2F-MjHFgz_NX4gfstfiarj%2F-MjHKDuyk5PaE0CFj2TD%2Fsentry.png?alt=media&#x26;token=1d017aed-7180-4b7b-8c4f-e95dc2c24208" alt=""></div>

## 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 &#x20;
  * 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*](https://docs.runway.team/automations/types-of-automations#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](https://docs.runway.team/integrations/beta-testing) 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 `<bundle ID/package name>@<version>+<build number>`  (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 %}