Session Timeline

What Is a Session?

A session is a continuous period of activity within the app. A new session is created each time the SDK is initialized or when the app comes back to foreground after 30 seconds of being in background.

Session Timeline

The session timeline provides a detailed, chronological view of all events during a session. You can see the exact order of actions leading up to an issue, making it easier to spot problems. The timeline also includes memory and CPU usage graphs to help you understand how the app was performing at different moments.

Additionally, screenshots and layout snapshots give you a window into what the user saw at the time. This visual context helps you catch UI issues, performance bottlenecks or anything else that might not be obvious just from logs.

Session timelines are automatically collected for sessions with Crashes and Bug Reports. Each session timeline includes all events that occurred 5 minutes before the issue, giving you deep context on what led to the problem.

See Configuration Options for details on how to configure sampling rates for session timeline.

Session Search

You can easily find session timelines using attributes like user ID, session ID, device model, app version, OS version, country and more. You can also search based on specific events, such as when a view was clicked or a screen was visited. This is particularly useful for investigating user- or device-specific issues.

The session search supports all custom events and attributes defined in your app, allowing you to filter sessions based on custom data like feature flags or user actions.

API Reference

Get Current Session

You can retrieve the current session using the getSessionId method. This is useful when you want to send the session ID to a different service or log it for debugging purposes.

Android

val sessionId = Measure.getSessionId()

iOS

Using Swift:

let sessionId = Measure.getSessionId()

or, in Objective-C:

NSString *sessionId = [Measure getSessionId];

Flutter

final String? sessionId = await Measure.instance.getSessionId();

React Native

const sessionId = await Measure.getSessionId();