Custom properties

  • Reference
  • Published Jan 14, 2026

Custom properties in Dynatrace RUM refer to user events that are not automatically captured but are instead reported through the Dynatrace API or captured based on configuration. These properties include user identifier events, as well as event and session property events.

Standalone event properties

Semantic conventions for user 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.classifierstringexperimental
Fixed value property.
property
characteristics.has_event_propertiesbooleanexperimental
Fixed value true.
true
characteristics.is_api_reportedbooleanexperimental
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__recordexperimental
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 attributes

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

Standalone session properties

Semantic conventions for user 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.classifierstringexperimental
Fixed value property.
property
characteristics.has_session_propertiesbooleanexperimental
Fixed value true.
true
characteristics.is_api_reportedbooleanexperimental
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__recordexperimental
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 attributes

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.

Standalone user tag

Semantic conventions for user tags in Dynatrace RUM.

Query

This query searches for all user tag events.

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

User identifier characteristics

AttributeTypeDescriptionExamples
characteristics.classifierstringexperimental
Fixed value property.
property
characteristics.has_user_tagbooleanexperimental
Fixed value true.
true
characteristics.is_api_reportedbooleanexperimental
Additional characteristic: If set to true, the user event was sent using the Dynatrace API.
true

User identifier attributes

AttributeTypeDescriptionExamples
user.identifierstringexperimental
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 attributes

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