Try it free

User context

  • Latest Dynatrace
  • Reference

User context groups user events that enrich user events and user sessions with customer-supplied data, including user identifier events and event and session property events.

Event properties

Semantic conventions for event properties in Dynatrace RUM.

Query

This query searches for all user event properties events.

fetch user.events
| filter characteristics.has_event_properties == true

User event properties characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimental
Fixed value property.

property

characteristics.has_event_properties

boolean

stable
Fixed value true.

true

characteristics.is_api_reported

boolean

stable
Fixed value true.

true

User event properties

Event properties are custom-defined key-value pairs. Dynatrace RUM captures event properties as part of user journeys and uses these to enrich user events.

AttributeTypeDescriptionExamples

event_properties.__property_name__

record

stable
Contains the value for the event property named __property_name__ defined by the event and session property configuration. The data type of the value depends on the definition; default is data type string.

42; value

Basic user event fields

The basic attributes for all user events are defined in the user event base model.

Standalone session properties

Semantic conventions for session properties in Dynatrace RUM.

Query

This query searches for all user session properties events.

fetch user.events
| filter characteristics.has_session_properties == true

User session properties characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimental
Fixed value property.

property

characteristics.has_session_properties

boolean

stable
Fixed value true.

true

characteristics.is_api_reported

boolean

stable
Additional characteristic: If set to true, the user event was sent using the Dynatrace API.

true

User session properties

Session properties are custom-defined key-value pairs. Dynatrace RUM captures session properties as part of user journeys and uses these to enrich user sessions.

AttributeTypeDescriptionExamples

session_properties.__property_name__

record

stable
Contains the value for the session property named __property_name__ defined by the event and session property configuration. The data type of the value depends on the definition; default is data type string.

session_properties.patientid:DFTR123455; session_properties.customers_cohort: premium

Basic user event fields

The basic attributes for all user events are defined in the user event base model. Be aware that standalone session properties cannot contain event properties that are part of the basic attributes.

User identifier

Semantic conventions for user identifiers in Dynatrace RUM.

To learn more, go to user sessions.

Query

This query searches for all user identifier events.

fetch user.events
| filter characteristics.has_user_identifier

User identifier characteristics fields

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimental
Fixed value property.

property

characteristics.has_user_identifier

boolean

stable
Fixed value true.

true

characteristics.has_user_tag

boolean

deprecatedReplaced with characteristics.has_user_identifier.
Primary characteristic: If set to true, the user event contains a user identifier.

true

characteristics.is_api_reported

boolean

stable
Additional characteristic: If set to true, the user event was sent using the Dynatrace API.

true

User identifier fields

AttributeTypeDescriptionExamples

user.identifier

string

stable
The user identifier for identifying individual users across different browsers, devices, and user sessions.
Tags: sensitive-user-events

john.doe@dynatrace.com

Basic user event fields

The basic attributes for all user events are defined in the user event base model.