> For the complete documentation index, see [llms.txt](https://docs.runway.team/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.runway.team/integrations/stability-monitoring/sentry.md).

# 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&amp;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 > Personal Tokens**](https://sentry.io/settings/account/api/auth-tokens/)&#x20;

{% hint style="info" %}
Runway specifically requires a Personal Token because of Sentry limitations that prevent Runway from fetching information about organizations and projects with the Internal Integration token, which is something we need to properly query data via the API.
{% endhint %}

{% 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 `<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 %}