Session Replay Properties
Learn more about searchable session replay properties.
Session Replay provides a video-like reproduction of user interactions on a site or web app. All user interactions, including page visits, mouse movements, clicks, and scrolls, are captured, helping developers connect the dots between a known issue and how a user experienced it in the UI.
You can search by session replay properties on the Replay page.
Below is a list of keys and tokens that can be used in the session replay search.
Replay activity is calculated based on the number of errors, the number of ui events, and the duration of the replay. It's represented as a number from 1
to 10
.
- Type: number
Name of the users' web browser. For example, Chrome
, Firefox
, or Safari
- Type: string
The version string of the browser.
- Type: string
The alt
of an element that was clicked. For example, "a good dog"
would match the element <img src="/lassie.jpeg" alt="a good dog" />
- Type: string
The class
of an element that was clicked. No leading .
is necessary. For example, btn-primary
would match the element <a class="btn btn-primary">Save</a>
- Type: string
The name of the frontend component that was clicked. For example, MyAwesomeComponent
would match the React component <MyAwesomeComponent>
.
Note: This property requires that your project have React component name capturing configured.
- Type: string
The id
of an element that was clicked. No leading #
is necessary. For example, reset-password
would match the element <a id="reset-password">Reset</a>
- Type: string
The aria-label
of an element that was clicked. For example, Expand
would match the element <button aria-label="Expand"><img src="/icons/expand.png"/></button>
- Type: string
The role
of an element that was clicked. For example, button
would match both <button>Save</button>
and <a role="button">Submit</a>
- Type: string
An element identified using a subset of CSS selector syntax. For example, #section-1
or span.active
or span[role=button]
or .active[role=button]
would all match the element <span id="section-1" class="active" role="button"/>
. Note that, CSS combinators, pseudo selectors, and attr selectors other than =
are not supported.
- Type: string
The tag name of an element that was clicked. For example, input
would match <input name="username" />
- Type: string
The data-testid
or data-test-id
of an element that was clicked. For example, user-name
would match the element <a data-testid="user-name">User Name</a>
- Type: string
The immediate textContent
of an element that was clicked. For example, Save
would match <button>Save</button>
but wouldn't match <button><h1>Save</h1></button>
- Type: string
The title
of an element that was clicked. For example, Save this comment
would match the element <a title="Save this comment" class="btn btn-primary">Save</a>
- Type: string
The number of dead clicks within a replay.
- Type: number
The number of errors within a replay.
- Type: number
The number of rage clicks within a replay.
- Type: number
The number of segments within a replay. More segments represent more activity over time.
- Type: number
The number of URLs that the user visited during a replay recording.
- Type: number
Similar to the click.selector
search property, but only queries on dead clicks. An element identified using a subset of CSS selector syntax. For example, #section-1
or span.active
or span[role=button]
or .active[role=button]
would all match the element <span id="section-1" class="active" role="button"/>
. Note that, CSS combinators, pseudo selectors, and attr selectors other than =
are not supported.
- Type: string
Brand of the device
- Type: string
Family of the device. Typically, the common part of a model name across generations. For example, iPhone, Samsung Galaxy.
- Type: string
Internal hardware revision to identify the device exactly.
- Type: n/a
Details of the device
- Type: string
Distinguishes build or deployment variants of the same release of an application. For example, the dist can be the build number of an Xcode build or the version code of an Android build.
- Type: string
Duration of a replay in seconds.
- Type: number
Error instances that have occurred within a replay.
- Type: array
The event or replay id. In Issues, use only the ID value without the id
key.
- Type: UUID
Severity of the event (such as: fatal, error, warning). Always set to info for transactions.
- Type: string
The name of the operating system. For example, Windows
, Mac OS X
, or Linux
- Type: string
The version number of the operating system.
- Type: string
Name of the platform. This is only a metrics property for valid platforms, defaulting to other
.
- Type: string
The id of the project.
- Type: string
Similar to the click.selector
search property, but only queries on rage clicks. An element identified using a subset of CSS selector syntax. For example, #section-1
or span.active
or span[role=button]
or .active[role=button]
would all match the element <span id="section-1" class="active" role="button"/>
. Note that, CSS combinators, pseudo selectors, and attr selectors other than =
are not supported.
- Type: string
A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or release:latest
to pick the most recent release.
- Type: string
The reason a replay was triggered. For example, session
when replaysSessionSampleRate
takes effect, or error
when replaysOnErrorSampleRate
is sampled instead of session
.
- Type: string
Name of the Sentry SDK that sent the event.
- Type: string
Version of the Sentry SDK that sent the event.
- Type: string
Whether you've seen this replay. Alias: viewed_by_me
- Type: boolean
A trace represents the record of the entire operation you want to measure or track — like page load, searched using the UUID generated by Sentry’s SDK.
- Type: UUID
A specific URL that the user visited during the replay.
- Type: string
An alternative, or addition, to the username. Sentry is aware of email addresses and can therefore display things such as Gravatars and unlock messaging capabilities.
- Type: string
Application-specific internal identifier for the user.
- Type: string
User's IP address. Sentry uses the IP address as a unique identifier for unauthenticated users.
- Type: string
Username, which is typically a better label than the user.id
.
- Type: string
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").