Skip to content

Commit

Permalink
feat(replay): Add troubleshooting section for "Replay does not look c…
Browse files Browse the repository at this point in the history
…orrect"

Adds some common cases where a replay does not look correct

Closes #10886
  • Loading branch information
billyvg committed Sep 16, 2024
1 parent 332d4cc commit 90f958b
Showing 1 changed file with 19 additions and 4 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,21 @@ excerpt: ""
description: "Troubleshooting Session Replay-specific Issues"
---

<Expandable title="Replay does not look correct" permalink>

There are a few category of cases where the replay playback does not match how your application looks. Below are some common causes and what next steps are if you experience this.

### Missing elements from the replay

* Usage of unsupported and/or deprecated elements such as `<frame>` (not to be confused with `<iframe>`)
* Element is blocked by the [privacy configuration](/platforms/javascript/session-replay/privacy/#blocking) (by default, elements with the class name `sentry-block` or the attribute `data-sentry-block`)

### CSS is wrong or missing

* There may be edge cases with complex CSS selectors which break the styling. Please [file an issue on GitHub](https://github.com/getsentry/sentry-javascript/issues) if you enounter this.

</Expandable>

<Expandable title="My `canvas` elements aren't getting captured" permalink>

Canvas is supported in SDK versions >= `7.98.0`. Please see the <PlatformLink to="/session-replay/#canvas-recording">canvas setup documention</PlatformLink> to get started with canvas recordings.
Expand Down Expand Up @@ -147,7 +162,7 @@ Using the [`captureConsoleIntegration`](https://docs.sentry.io/platforms/javascr

<Expandable title="Clicks are incorrectly resulting in a dead or rage click" permalink>

There are certain cases (such as clicking a button to play an audio clip) where Sentry incorrectly records a click as a dead click (note: rage clicks are a subset of dead clicks). As a workaround, you can use the [`slowClickIgnoreSelector`](/platforms/javascript/session-replay/configuration/#general-integration-configuration) configuration option to ignore dead clicks for specific selectors.

If you want to turn off [rage click issues](/product/issues/issue-details/replay-issues/) altogether, you can disable them by going to the **Settings** page in Sentry, clicking "Projects", and selecting the project for which you want to disable rage clicks. From here, select "Replays" under the "PROCESSING" heading and toggle off "Create Rage Click Issues".
</Expandable>
---
title: Troubleshooting
sidebar_order: 9000
notSupported:

0 comments on commit 90f958b

Please sign in to comment.