> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lucenthq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sentry replay

> Connect Sentry Session Replay to Lucent.

Connect Sentry to import Session Replay recordings into Lucent. Lucent reads
Sentry replay metadata and recording segments, then analyzes the imported
session alongside your other Lucent sessions.

## What Lucent imports

Lucent uses Sentry's replay APIs for replay metadata and recording segments:

* [List an organization's replays](https://docs.sentry.io/api/replays/list-an-organizations-replays/)
* [Retrieve a replay instance](https://docs.sentry.io/api/replays/retrieve-a-replay-instance/)
* [List recording segments](https://docs.sentry.io/api/replays/list-recording-segments/)
* [Retrieve a recording segment](https://docs.sentry.io/api/replays/retrieve-a-recording-segment/)

## Requirements

You need:

* a Sentry organization slug
* a Sentry project slug or project ID
* a Sentry auth token
* an optional environment filter, such as `production`

Use a Sentry token with `org:read` and `project:read`.

## Connect Sentry

<Steps>
  <Step title="Create a Sentry auth token">
    In Sentry, create an auth token with `org:read` and `project:read`.
  </Step>

  <Step title="Open Lucent integrations">
    In Lucent, go to **Settings -> Integrations** and select **Sentry**.
  </Step>

  <Step title="Enter your project details">
    Add your Sentry host, organization slug, project slug or ID, token, and
    optional environment.
  </Step>

  <Step title="Save the integration">
    Lucent checks replay and recording segment access before saving.
  </Step>
</Steps>

The default Sentry host is `https://sentry.io`. If you use a self-hosted Sentry
deployment, enter your own host.

## Mobile and Expo replay support

Sentry web replay is supported. Sentry mobile and Expo replay import is beta:

* DOM-like rrweb payloads pass through unchanged.
* screenshot-style mobile payloads are converted before video generation.
* wireframe-style mobile payloads are converted before video generation.

Other mobile replay payloads are skipped.

## After import

Imported Sentry sessions keep their source metadata, so you can:

* open the original replay link from the session detail view
* filter sessions and Signals by source
* filter Signals by feature flag values when available

## Troubleshooting

| Problem                            | What to check                                                                                        |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Lucent cannot save the integration | Confirm the token has `org:read` and `project:read`, and that the org and project slugs are correct. |
| No sessions import                 | Check the environment filter and confirm the project has Sentry replays in the selected time window. |
| A mobile replay is skipped         | The replay did not contain renderable DOM, screenshot, or wireframe data.                            |