User and session management

• Latest Dynatrace
• How-to guide
• 1-min read
• Updated on Oct 05, 2026

Dynatrace allows you to identify users across sessions and devices, manage session lifecycle, and attach properties that apply to all events in a session.

Identify users

Use identifyUser() to tag the current session with a user identifier. This enables you to track individual users across different sessions, browsers, and devices.

Basic usage

import { Dynatrace } from '@dynatrace/react-native-plugin';

// After user logs in
Dynatrace.identifyUser("user@example.com");

// Or use an internal user ID
Dynatrace.identifyUser("user-12345");

Remove user identification

To remove the user tag (for example, on logout), pass null or an empty string:

import { Dynatrace } from '@dynatrace/react-native-plugin';

function logout() {
  // Clear user identification
  Dynatrace.identifyUser(null);
}

Important considerations

Session properties

Session properties are key-value pairs that apply to all events in the current session. Use them to add context that characterizes the user's session.

Allow session properties

To allow a key, follow the steps in Allow API-reported properties.

Send session properties

Session properties apply to all events within the current session. Use sendSessionPropertyEvent() to set properties using the SessionPropertyEventData class that should be available across the entire user session.

import { Dynatrace, SessionPropertyEventData } from '@dynatrace/react-native-plugin';

// Set session-wide properties
Dynatrace.sendSessionPropertyEvent(new SessionPropertyEventData()
  .addSessionProperty("session_properties.user_tier", "premium")
  .addSessionProperty("session_properties.app_version", "2.1.0")
  .addSessionProperty("session_properties.feature_flag_enabled", true)
);

Property requirements

Allowed properties:

For property limits, see Capture event and session properties for mobile frontends.

Field naming rules:

Session property behavior:

Valid examples:

Update session properties

You can send session properties multiple times during a session. However, if you send the same property multiple times, session aggregation will keep only one value (first or last, depending on configuration).

import { Dynatrace, SessionPropertyEventData } from '@dynatrace/react-native-plugin';

// Initial properties
Dynatrace.sendSessionPropertyEvent(new SessionPropertyEventData()
  .addSessionProperty("session_properties.cart_value", 0)
);

// Update after user adds items
Dynatrace.sendSessionPropertyEvent(new SessionPropertyEventData()
  .addSessionProperty("session_properties.cart_value", 149.99)
);

End session

Use endSession() to manually close the current session and start a new one. All open actions are closed and sent to the server.

import { Dynatrace } from '@dynatrace/react-native-plugin';

function logout() {
  // Clear user identification
  Dynatrace.identifyUser(null);

  // End the current session
  Dynatrace.endSession();
}

Related topics