Real User Monitoring

Latest Dynatrace
Reference
Preview

Real User Monitoring (RUM) provides deep visibility into how end users interact with the frontends of your applications. The RUM models are organized into the following subcategories:

Some fields in user.events and user.sessions are restricted by default and require additional permissions to access. For the field list and access details, go to Sensitive user.events and user.sessions fields and field-level permissions.

To learn more about business events reported via RUM, visit RUM business event enrichment.

The following reference contains a list of fields that have a well-defined semantic meaning in Dynatrace RUM. The fields are organized in namespaces that are separated with dots.

Characteristic fields

User event characteristics give high-level information about the event's contents. The dedicated user event models describe what characteristics are expected for the model.

Attribute	Type	Description	Examples
`characteristics.classifier`	string	experimental The main characteristic of the user event determined with the following priority in case of overlapping characteristics: `error`, `page_summary`, `view_summary`, `navigation`, `app_start`, `visibility_change`, `user_interaction`, `request`, `property`, `api`, `invalid`, `sfm`. Used for internal optimization when storing the data and not intended for query usage.	`error`; `navigation`
`characteristics.has_anr`	boolean	stable Additional error characteristic: If set to `true`, the user event contains an ANR error.	`true`
`characteristics.has_app_start`	boolean	stable Primary characteristic: If set to `true`, the user event contains an app start event.	`true`
`characteristics.has_crash`	boolean	stable Additional error characteristic: If set to `true`, the user event contains a crash.	`true`
`characteristics.has_csp_violation`	boolean	stable Additional error characteristic: If set to `true`, the user event contains a CSP rule violation.	`true`
`characteristics.has_error`	boolean	stable Primary characteristic: If set to `true`, the user event contains at least one error.	`true`
`characteristics.has_event_properties`	boolean	stable Additional characteristic: If set to `true`, the user event contains event properties.	`true`
`characteristics.has_exception`	boolean	stable Additional error characteristic: If set to `true`, the user event contains an exception.	`true`
`characteristics.has_failed_request`	boolean	stable Additional error characteristic: If set to `true`, the user event contains a failed request.	`true`
`characteristics.has_long_task`	boolean	stable Primary characteristic: If set to `true`, the user event contains a long task event.	`true`
`characteristics.has_navigation`	boolean	stable Primary characteristic: If set to `true`, the user event contains navigation information.	`true`
`characteristics.has_page_summary`	boolean	stable Primary characteristic: If set to `true`, the user event contains a page summary.	`true`
`characteristics.has_replay`	boolean	experimental If set to `true`, at least part of the user session was recorded with Session Replay and can be replayed.	`true`
`characteristics.has_request`	boolean	stable Primary characteristic: If set to `true`, the user event contains a request.	`true`
`characteristics.has_session_properties`	boolean	stable Primary characteristic: If set to `true`, the user event contains session properties.	`true`
`characteristics.has_user_action`	boolean	stable Primary characteristic: If set to `true`, the user event contains a user action.	`true`
`characteristics.has_user_identifier`	boolean	stable Primary characteristic: If set to `true`, the user event contains a user identifier in `user.identifier`.	`true`
`characteristics.has_user_interaction`	boolean	stable Primary characteristic: If set to `true`, the user event contains a user interaction.	`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.has_view_summary`	boolean	stable Primary characteristic: If set to `true`, the user event contains a view summary.	`true`
`characteristics.has_visibility_change`	boolean	stable Primary characteristic: If set to `true`, the user event contains a visibility change event.	`false`
`characteristics.has_w3c_navigation_timings`	boolean	stable Additional request characteristic: If set to `true`, the user event contains W3C navigation timings.	`true`
`characteristics.has_w3c_resource_timings`	boolean	stable Additional request characteristic: If set to `true`, the user event contains W3C resource timings.	`true`
`characteristics.is_api_reported`	boolean	stable Additional characteristic: If set to `true`, the user event was sent using the Dynatrace API.	`true`
`characteristics.is_invalid`	boolean	stable Primary characteristic: If set to `true`, the user event was marked invalid during validation.	`false`
`characteristics.is_new_user`	boolean	experimental Primary characteristic: If set to `true`, the user event was recorded during the end user's first captured user session.	`true`
`characteristics.is_self_monitoring`	boolean	experimental Primary characteristic: If set to `true`, the user event is a standalone self-monitoring event.	`true`

characteristics.classifier MUST be one of the following:

Value	Description
`api`	The user event was reported via the Dynatrace API.
`app_start`	The user event is an application start event.
`error`	The user event contains an error.
`invalid`	The user event is invalid.
`navigation`	The user event contains a navigation.
`other`	The user event could not be classified.
`page_summary`	The user event is a page summary event.
`property`	The user event contains event properties or session properties.
`request`	The user event contains request information.
`sfm`	The user event is a self-monitoring event.
`user_action`	The user event is a user action event.
`user_interaction`	The user event is a user interaction event.
`view_summary`	The user event is a view summary event.
`visibility_change`	The user event is a visibility change event.

Event fields

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.

Attribute	Type	Description	Examples
`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`

Flutter fields

Flutter attributes are only available for user events sent by the Flutter plugin.

Attribute	Type	Description	Examples
`flutter.version`	string	experimental The version of Flutter used in the app.	`3.35.0`

Page fields

The page fields contains information on the web page of an event.

Attribute	Type	Description	Examples
`page.background_time`	duration	stable The aggregated time that the page was in the background.	`0`
`page.detected_name`	string	stable The name RUM JavaScript detected for the page. The value is based on `page.url.full`. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e`
`page.foreground_time`	duration	stable The aggregated time that the page was in the foreground.	`900000000`
`page.instance_id`	uid	stable A random ID that is generated every time a user navigates to a new page. The `page.instance_id` is an 8-byte ID and hex-encoded if shown as a string.	`f76281848bd8288c`
`page.name`	string	stable An identifier for grouping pages. The value is automatically calculated by Dynatrace from `page.detected_name`. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`#dashboard;id=<uuid>`
`page.prerender_time`	duration	stable The aggregated time that the page was prerendering.	`0`
`page.source.url.domain`	string	stable The URI host component of the source page URL. This is extracted from `page.source.url.full`.	`www.foo.bar`
`page.source.url.fragment`	string	stable The URI fragment component of the source page URL. This is extracted from `page.source.url.full`.	`#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h`
`page.source.url.full`	string	stable The page URL of the previous page, provided in the format `scheme://host[:port]/path[?query][#fragment]`. This value is captured using `document.referrer` and may be missing or incomplete. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h`
`page.source.url.path`	string	stable The URI path component of the source page URL. This is extracted from `page.source.url.full`.	`/path`
`page.source.url.query`	string	stable The URI query component of the source page URL. This is extracted from `page.source.url.full`.	`q=value`
`page.source.url.scheme`	string	stable The URI scheme component of the source page URL. This is extracted from `page.source.url.full`.	`https`; `http`
`page.title`	string	stable The HTML DOM `document.title` property. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`FooBar - Title`
`page.url.domain`	string	stable The URI host component of the page URL. This is extracted from `page.url.full`.	`www.foo.bar`
`page.url.fragment`	string	stable The URI fragment component of the page URL. This is extracted from `page.url.full`.	`dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h`
`page.url.full`	string	stable The page URL, provided in the format `scheme://host[:port]/path[?query][#fragment]`. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h`
`page.url.path`	string	stable The URI path component of the page URL. This is extracted from `page.url.full`.	`/path`
`page.url.query`	string	stable The URI query component of the page URL. This is extracted from `page.url.full`.	`q=value`
`page.url.scheme`	string	stable The URI scheme component of the page URL. This is extracted from `page.url.full`.	`https`; `http`

React Native fields

The react_native fields contain information on React Native. React Native fields are only available for user events sent by the React Native plugin.

Attribute	Type	Description	Examples
`react_native.bundle.name`	string	experimental The name of the React Native bundle.	`RNBundleName`
`react_native.bundle.version`	string	experimental The version of the React Native bundle.	`0.0.1`
`react_native.version`	string	experimental The version of React Native used in the app.	`0.81.0`

Session properties

Session properties are custom-defined key-value pairs. Dynatrace RUM captures session properties as part of each of your users' journeys to enrich user sessions.

Attribute	Type	Description	Examples
`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`

View fields

The view fields contain information on the view of a user event.

Attribute	Type	Description	Examples
`view.background_time`	duration	stable Aggregated time that the view was in the background.	`0`
`view.detected_name`	string	stable The name detected for the view. For RUM JavaScript, the value is based on `view.url.full`. For OneAgent for Mobile, it is based on the view class name. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e`; `NavigationView`; `MainActivity`
`view.foreground_time`	duration	stable Aggregated time that the view was in the foreground.	`900000000`
`view.instance_id`	uid	stable A random ID that is generated every time a user navigates to a new view. The `view.instance_id` is an 8-byte ID and hex-encoded if shown as a string.	`f76281848bd8288c`
`view.name`	string	stable An identifier for grouping views. The value can be reported via the Dynatrace API. If not reported via the Dynatrace API, the value is automatically calculated from `view.detected_name`. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`#dashboard;id=<uuid>`; `Login View`
`view.prerender_time`	duration	stable Aggregated time that the view was prerendering.	`0`
`view.sequence_number`	long	stable The number of views throughout the page's entire lifespan.	`1`
`view.source.detected_name`	string	stable The `view.detected_name` value of the previous view. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e`; `NavigationView`; `MainActivity`
`view.source.instance_id`	uid	stable The identifier of the previous view (the previous view’s `view.instance_id`).	`f76281848bd8288c`
`view.source.name`	string	stable The `view.name` value of the previous view. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`#dashboard;id=<uuid>`; `Login View`
`view.source.url.domain`	string	stable The URI host component of the source view URL. This is extracted from `view.source.url.full`.	`www.foo.bar`
`view.source.url.fragment`	string	stable The URI fragment component of the source view URL. This is extracted from `view.source.url.full`.	`#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h`
`view.source.url.full`	string	stable The `location.href` of the previous view. This is the full URL provided in the format `scheme://host[:port]/path[?query][#fragment]`. Not applicable for OneAgent for Mobile. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h`
`view.source.url.path`	string	stable The URI path component of the source view URL. This is extracted from `view.source.url.full`.	`/path`
`view.source.url.query`	string	stable The URI query component of the source view URL. This is extracted from `view.source.url.full`.	`q=value`
`view.source.url.scheme`	string	stable The URI scheme component of the source view URL. This is extracted from `view.source.url.full`.	`https`; `http`
`view.url.domain`	string	stable The URI host component of the view URL. This is extracted from `view.url.full`.	`www.foo.bar`
`view.url.fragment`	string	stable The URI fragment component of the view URL. This is extracted from `view.url.full`.	`dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h`
`view.url.full`	string	stable The `location.href` at the time of the event. This is the full URL provided in the format `scheme://host[:port]/path[?query][#fragment]`. Not applicable for OneAgent for Mobile. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.	`https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h`
`view.url.path`	string	stable The URI path component of the view URL. This is extracted from `view.url.full`.	`/path`
`view.url.query`	string	stable The URI query component of the view URL. This is extracted from `view.url.full`.	`q=value`
`view.url.scheme`	string	stable The URI scheme component of the view URL. This is extracted from `view.url.full`.	`https`; `http`

Web vitals fields

The web vitals fields contain the web vitals attributes captured by Dynatrace RUM. Only available for user events sent by RUM JavaScript.

Attribute	Type	Description	Examples
`web_vitals.cumulative_layout_shift`	double	stable The `Cumulative Layout Shift` (CLS) value.	`0.1279`
`web_vitals.first_contentful_paint`	duration	stable The `First Contentful Paint` (FCP) value.	`92000000`
`web_vitals.first_input`	duration	stable The `First Input` value.	`6000000`
`web_vitals.first_input_delay`	duration	stable The `First Input Delay` (FID) value.	`6000000`
`web_vitals.first_paint`	duration	stable The `First Paint` value.	`92451200`
`web_vitals.interaction_to_next_paint`	duration	stable The `Interaction to Next Paint` (INP) value.	`190000000`
`web_vitals.largest_contentful_paint`	duration	stable The `Largest Contentful Paint` (LCP) value.	`880000000`
`web_vitals.time_to_first_byte`	duration	stable The `Time to First Byte` value.	`92000000`