Session Replay
Session Replay records and visualizes user sessions, capturing screen changes, interactions, and logs to show exactly what users experienced.
Session Replay
Allows you see your app through your users' eyes by recording and visualizing user sessions, capturing screen changes, interactions, logs, and stability and performance issues.
It provides full context of the user experience, enabling teams to debug issues faster, reduce support back-and-forth, and proactively identify user frustration. Whether you're reproducing bugs, investigating negative feedback, or responding to support tickets, Session Replay shows you exactly what users experienced with complete visual context.
Features
Sessions List
Sessions are sorted chronologically by default. You’ll see the following information for each session:
User Data: The end-user's email/name and ID. By default, it shows Luciq's UUID, but you can override it with your internal IDs using the User Identification API.
Session Type: Any session that ends with a fatal crash or OOM is flagged as a crashing session. Any session that is affected by an App hang or a Force Restart is flagged as a frustrating session. Otherwise, a bucket is defined based on all the other metrics and occurrences (app launch, app traces, network, and UI hangs) that happened within the session. More examples can be found here.
Session Issues: The issues that happened during the session. These include crashes, app hangs, slow app launches, screen loadings, or execution traces as well as Force Restarts. This can help you identify sessions that require your attention.
Duration: The length of the replay.
App Version: The app version the user was on during the session.
OS: The OS version the device was on during the session.
Date: of when the session has occurred.
Session Details
With each session, Luciq captures detailed information about the session itself. Below is the list of session related details that Luciq captures:
User ID
Date
Session duration
App version
Device
OS version
User ID (if provided)
Username (if provided)
Locale
Bundle ID
Device location
User attributes
Feature flags
Timeline
A timeline from the beginning to the end of the session which visually highlights performance and stability issues that happen over the course of the replay. Users can easily move to the point on the timeline where they want to start debugging. It also visually shows the duration of the session.
Screenshots
Screenshots taken throughout the session whenever there is a change in the UI (The SDK captures a screenshot with every screen transition).
Logs
A whole host of logs are sent with every session. These logs include:
Luciq Logs: Logs with various verbosity levels that you can add manually.
User Steps: Log entries detailing each step the user has taken.
Network Logs: Records of all network requests.
Crashes: If Luciq’s Crash Reporting is enabled, you'll see all crash metrics within the session, including fatal crashes, app hangs, ANRs, and non-fatal errors.
Performance: If Luciq's APM is enabled, you'll see all APM metrics for the session, including app launches, screen loading, flows, and networks.
Session Definition
A session starts when the app is brought into the foreground and ends when it moves to the background or when it's terminated either by the OS or the user.
Foreground Only
We currently support session replay for foreground sessions only.
User Identification
In order to find sessions by searching for specific users, make sure you use our user identification API. More details about the user identification API can be found here.
Constrained Devices
On Android, the SDK automatically classifies devices into performance tiers based on hardware capabilities such as CPU, RAM, and memory class. On lower-tier devices, the SDK reduces data collection to protect app performance and prevent issues like ANRs or out-of-memory errors.
Device Tiers
LOW
Low-end
~30%
AVERAGE
Mid-range
~60%
HIGH
High-end
100%
What Gets Reduced
When the SDK reduces data collection on a constrained device, the following are affected:
Session Replay
Navigation mode only
Navigation mode only
Configured mode
Session Profiler
~18 seconds
~36 seconds
Full duration
Network and Console Logs
30% retained
60% retained
Full
Repro Steps
30% retained
60% retained
Full
What You'll See on the Dashboard
When viewing a bug report, crash occurrence, or session from a constrained device:
A device classification badge appears in the details panel showing the device tier and the percentage of data collected (e.g., "Low-end · 30% data collected").
If session profiler data, repro steps, or screenshots are unavailable due to data reduction, the dashboard displays a message explaining that data collection was reduced on that device to protect app performance.
Device classification is currently available on Android only. This behavior is automatic and does not require any configuration.
Last updated