User and session management

• Latest Dynatrace
• Explanation
• 1-min read
• Published Jan 12, 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

using Dynatrace.MAUI;

// After user logs in
Agent.Instance.IdentifyUser('user@example.com');

// Or use an internal user ID
Agent.Instance.IdentifyUser('user-12345');

Remove user identification

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

using Dynatrace.MAUI;

void Logout() {
  // Clear user identification
  Agent.Instance.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. Event and session properties must be configured before they can be used. Incoming event and session properties that are not configured are dropped during event ingest. Read more about configuring custom events and session properties.

Send session properties

using Dynatrace.MAUI;

var sessionEventData = new SessionPropertyEventData()
  .AddSessionProperty("session_properties.product_tier", "premium")
  .AddSessionProperty("session_properties.loyalty_status", "gold")
  .AddSessionProperty("session_properties.onboarding_complete", true);

Agent.Instance.SendSessionPropertyEvent(sessionEventData);

Property naming rules

Limits

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).

using Dynatrace.MAUI;

var firstSessionEventData = new SessionPropertyEventData()
  .AddSessionProperty("session_properties.cart_value", 0);

var secondSessionEventData = new SessionPropertyEventData()
  .AddSessionProperty("session_properties.cart_value", 149.99);

// Initial properties
Agent.Instance.SendSessionPropertyEvent(firstSessionEventData);

// Update after user adds items
Agent.Instance.SendSessionPropertyEvent(secondSessionEventData);

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.

using Dynatrace.MAUI;

void Logout() {
  // Clear user identification
  Agent.Instance.IdentifyUser(null);

  // End the current session
  Agent.Instance.EndSession();
}

Related topics