Try it free

User events version 1.322

  • Published Aug 12, 2025

User events provide deep visibility and insights into experience, behavior, performance, and errors of your customers and end-users in real-time.

User event base model

Semantic conventions for the basic user event. These attributes are available for all user events, also for API reported events sent with the Dynatrace API.

Top-level attributes

AttributeTypeDescriptionExamples

duration

duration

experimentalThe difference between start_time and end_time in nanoseconds.

42

end_time

timestamp

experimentalEnd time of the user event. The value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time. Time correction is applied.

1649822520123123165

start_time

timestamp

experimentalStart time of the user event. The value is a UNIX Epoch time in nanoseconds and less than or equal to the end_time. Time correction is applied.

1649822520123123123

id

uid

experimentalUnique identifier of an user event.

357bf70f3c617cb34584b31bd4616af8

User event characteristics

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.

AttributeTypeDescriptionExamples

characteristics.classifier

string

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

error; navigation

characteristics.has_activity

boolean

experimentalPrimary characteristic: If set to true, the user event contains an activity event.

true

characteristics.has_anr

boolean

experimentalAdditional error characteristic: If set to true, the user event contains an ANR error.

true

characteristics.has_app_start

boolean

experimentalPrimary characteristic: If set to true, the user event contains an app start event.

true

characteristics.has_crash

boolean

experimentalAdditional error characteristic: If set to true, the user event contains a crash.

true

characteristics.has_csp_violation

boolean

experimentalAdditional error characteristic: If set to true, the user event contains a CSP rule violation.

true

characteristics.has_error

boolean

experimentalPrimary characteristic: If set to true, the user event contains at least one error.

true

characteristics.has_event_properties

boolean

experimentalAdditional characteristic: If set to true, the user event contains event properties.

true

characteristics.has_exception

boolean

experimentalAdditional error characteristic: If set to true, the user event contains an exception.

true

characteristics.has_failed_request

boolean

experimentalAdditional error characteristic: If set to true, the user event contains a failed request.

true

characteristics.has_long_task

boolean

experimentalPrimary characteristic: If set to true, the user event contains a long task event.

true

characteristics.has_navigation

boolean

experimentalPrimary characteristic: If set to true, the user event contains navigation information.

true

characteristics.has_page_summary

boolean

experimentalPrimary characteristic: If set to true, the user event contains a page summary.

true

characteristics.has_request

boolean

experimentalPrimary characteristic: If set to true, the user event contains a request.

true

characteristics.has_session_properties

boolean

experimentalPrimary characteristic: If set to true, the user event contains session properties.

true

characteristics.has_user_interaction

boolean

experimentalPrimary characteristic: If set to true, the user event contains a user interaction.

true

characteristics.has_user_tag

boolean

experimentalPrimary characteristic: If set to true, the user event contains a user tag.

true

characteristics.has_view_summary

boolean

experimentalPrimary characteristic: If set to true, the user event contains a view summary.

true

characteristics.has_visibility_change

boolean

experimentalPrimary characteristic: If set to true, the user event contains a visibility change event.

false

characteristics.has_w3c_navigation_timings

boolean

experimentalAdditional request characteristic: If set to true, the user event contains W3C navigation timings.

true

characteristics.has_w3c_resource_timings

boolean

experimentalAdditional request characteristic: If set to true, the user event contains W3C resource timings.

true

characteristics.is_api_reported

boolean

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

true

characteristics.is_invalid

boolean

experimentalPrimary characteristic: If set to true, the user event was marked invalid during validation.

false

characteristics.is_self_monitoring

boolean

experimentalPrimary characteristic: If set to true, the user event is a standalone self-monitoring event.

true

characteristics.classifier MUST be one of the following:

ValueDescription

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_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 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

experimentalContains 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

Time correction attributes

Time correction is applied on all timestamp fields of user events. For more details, go to time correction.

AttributeTypeDescriptionExamples

time_correction.is_applied

boolean

experimentalIf set to true, time correction has been applied to the event's timestamps.

false

time_correction.offset

long

experimentalThe offset (in nanoseconds) that is applied to all timestamp fields. The value may be negative.

127927969312

App attributes

App attributes are only available for user events sent by OneAgent for Mobile.

AttributeTypeDescriptionExamples

app.bundle

string

resource experimentalThe name of the bundle, for example the bundle identifier on iOS or the applicationId on Android.

com.example.easytravel

app.short_version

string

resource experimentalThe application's publicly visible version number, as, for example, displayed in App Store or Google Play. Usually this is just the major and minor version with no patch number.

5.23

app.version

string

resource experimentalThe application's internal build number, which can include information such as patch number and build number.

5.23.15789; 143542

React Native attributes

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

AttributeTypeDescriptionExamples

react_native.bundle.name

string

resource experimentalThe name of the React Native bundle.

RNBundleName

react_native.bundle.version

string

resource experimentalThe version of the React Native bundle.

0.0.1

Browser attributes

Browser attributes are only available for user events sent by RUM JavaScript.

AttributeTypeDescriptionExamples

browser.frame.id

uid

experimentalA unique ID generated by RUM JavaScript to identify the browser frame. The browser.frame.id is an 8-byte ID and hex-encoded if shown as a string.

f76281848bd8288c

browser.frame.parent_id

uid

experimentalA unique ID generated by RUM JavaScript to identify the browser's next-higher frame (if that frame exists and is reachable). The browser.frame.parent_id is an 8-byte ID and hex-encoded if shown as a string.

f76281848bd8288c

browser.name

string

resource experimentalThe browser name.

Mozilla

browser.tab.id

uid

experimentalA unique ID generated by RUM JavaScript to identify the browser tab. The browser.tab.id is an 8-byte ID and hex-encoded if shown as a string.

f76281848bd8288c

browser.user_agent

string

resource experimentalThe full user agent string as provided by the browser in the HTTP User-Agent request header.

Mozilla/5.0 (Windows NT 10.0; Win64; x64)

browser.version

string

resource experimentalThe browser version.

5.0

browser.window.height

long

experimentalThe browser window's height, in pixels.

384

browser.window.width

long

experimentalThe browser window's width, in pixels.

2048

Client attributes

AttributeTypeDescriptionExamples

client.ip

ipAddress

experimentalThe IP address of the client that makes the request. This may be IPv4 or IPv6.Tags: sensitive-spans

194.232.104.141; 2a01:468:1000:9::140

client.isp

string

experimentalThe name of the Internet Service Provider (ISP) associated with the client's IP address.

Internet Service Provider Name

Device attributes

AttributeTypeDescriptionExamples

device.battery.level

long

experimentalThe device's battery level in the range 0% (discharged) to 100% (fully charged).

100

device.is_rooted

boolean

resource experimentalIf set to true, the device is rooted or jailbroken. Only supported by OneAgent for Mobile.

false

device.manufacturer

string

resource experimentalThe device manufacturer. Only supported by OneAgent for Mobile.

Apple

device.model.identifier

string

resource experimentalThe device model identifier. Only supported by OneAgent for Mobile.

iPhone3,4

device.orientation

string

experimentalThe device orientation.

landscape

device.screen.height

long

resource experimentalThe device's screen height in its natural orientation.

1152

device.screen.width

long

resource experimentalThe device's screen width in its natural orientation.

2048

device.type

string

resource experimentalThe type of the device. Only supported by RUM JavaScript.

mobile

Dynatrace OpenPipeline attributes

AttributeTypeDescriptionExamples

dt.openpipeline.pipelines

string[]

resource experimentalCollects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.

[[logs:default], [logs:pipeline_haproxy_2656, bizevents:default]]

dt.openpipeline.source

string

resource experimentalIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. For user events the value is always rumagent.

rumagent

Dynatrace RUM attributes

AttributeTypeDescriptionExamples

dt.rum.agent.type

string

resource experimentalThe Dynatrace RUM agent type.

android

dt.rum.agent.version

string

resource experimentalThe version of the Dynatrace RUM agent. It is provided in the format major.minor.patch.build. The build number is optional.

8.263.1; 9.293.2.1; 1.313.0.20250402-172634

dt.rum.application.entity

string

experimentalAn entity ID of an entity of type APPLICATION or MOBILE_APPLICATION.Tags: entity-id

APPLICATION-DC92E74A7A844E6E; MOBILE_APPLICATION-E8A8751A60D5BCE8

dt.rum.application.id

string

experimentalThe application ID reported by Dynatrace RUM. OneAgent for Mobile is using a UUID. RUM JavaScript uses an 8-byte HEX string.

ea7c4b59f27d43eb; 89b1a1e7-fe89-4151-81e9-410fa0235f0d

dt.rum.browser.session_id

string

experimentalThe browser session ID, taken from the dtCookie value. Not applicable for OneAgent for Mobile.

4D3133F359A76AB05AAF39691696858A

dt.rum.event.source.type

string

resource experimentalThe Dynatrace RUM source technology that produced this event. Only used by cross-platform implementations, otherwise the field is omitted.

flutter

dt.rum.instance.id

string

resource experimentalThe RUM application instance ID. (This was formerly called the "Visitor id", "internal user ID", and "rxVisitor cookie value".)

3735928559; 1742973444821E7E6Q3E3SG28ATQPAGTT6T8HU92VFRFQ

dt.rum.schema_version

string

resource experimentalThe Dynatrace RUM enrichment version.

0.1

dt.rum.session.id

string

experimentalA unique ID that represents the user session.

HOPCPWKILUKHFHWRRQGBHHPAFLUJUOSH-0; 23626166142035610_1-0

dt.rum.user_type

string

resource experimentalThe RUM user type.

real_user

Geolocation attributes

AttributeTypeDescriptionExamples

geo.country.iso_code

string

resource experimentalThe two-letter country code. The format complies with ISO 3316-1 alpha-2.

CA; GB

geo.location.latitude

double

resource experimentalThe approximate latitude. The format complies with WGS 84. Only supported by OneAgent for Mobile and provided with a precision of 2 decimal places (equivalent to approximately 1 KM).

45.505918

geo.location.longitude

double

resource experimentalThe approximate longitude. The format complies with WGS 84. Only supported by OneAgent for Mobile and provided with a precision of 2 decimal places (equivalent to approximately 1 KM).

-73.61483

Network attributes

AttributeTypeDescriptionExamples

network.connection.type

string

experimentalThe internet connection type. Only supported by OneAgent for Mobile.

cell; wifi

Operating system attributes

AttributeTypeDescriptionExamples

os.name

string

resource experimentalThe OS name in a short, human-readable format.

iOS

os.version

string

resource experimentalThe complete OS version, including patch, build, and other information. Only supported by OneAgent for Mobile.

15.3.1; Ubuntu 16.04.7 LTS (Xenial Xerus) (kernel 4.15.0-206-generic); Windows Server 2022 Datacenter 21H2 2009, ver. 10.0.20348

Page attributes

Page attributes are only available for RUM Events sent by RUM JavaScript.

AttributeTypeDescriptionExamples

page.detected_name

string

experimentalThe name RUM JavaScript detected for the page. The value is based on page.url.full.

#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e

page.id

uid

experimentalA random ID that is generated every time a user navigates to a new page. The page.id is an 8-byte ID and hex-encoded if shown as a string.

f76281848bd8288c

page.name

string

experimentalAn identifier for grouping pages. The value is automatically calculated by Dynatrace from page.detected_name.

#dashboard;id=<uuid>

page.title

string

experimentalThe HTML DOM document.title property.

FooBar - Title

page.url.domain

string

experimentalThe URI host component of the page URL. This is extracted from page.url.full.

www.foo.bar

page.url.fragment

string

experimentalThe 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

experimentalThe page URL, provided in the format scheme://host[:port]/path[?query][#fragment].

https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h

page.url.path

string

experimentalThe URI path component of the page URL. This is extracted from page.url.full.

/path

page.url.query

string

experimentalThe URI query component of the page URL. This is extracted from page.url.full.

q=value

page.url.scheme

string

experimentalThe URI scheme component of the page URL. This is extracted from page.url.full.

https; http

View attributes

AttributeTypeDescriptionExamples

view.detected_name

string

experimentalThe name RUM JavaScript detected for the view. The value is based on view.url.full. Not applicable for OneAgent for Mobile.

#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e

view.id

uid

experimentalA random ID that is generated every time a user navigates to a new view. The view.id is an 8-byte ID and hex-encoded if shown as a string.

f76281848bd8288c

view.name

string

experimentalAn 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 for user events reported by RUM JavaScript.

#dashboard;id=<uuid>; LoginActivity

view.url.domain

string

experimentalThe URI host component of the view URL. This is extracted from view.url.full.

www.foo.bar

view.url.fragment

string

experimentalThe 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

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

https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h

view.url.path

string

experimentalThe URI path component of the view URL. This is extracted from view.url.full.

/path

view.url.query

string

experimentalThe URI query component of the view URL. This is extracted from view.url.full.

q=value

view.url.scheme

string

experimentalThe URI scheme component of the view URL. This is extracted from view.url.full.

https; http

Visibility attributes

Visibility attributes are only available for RUM Events sent by RUM JavaScript.

AttributeTypeDescriptionExamples

visibility.state

string

experimentalThe visibility state.

foreground

visibility.state MUST be one of the following:

ValueDescription

background

The application or browser tab is in the background and the content is not visible to the user.

foreground

The application or browser tab is in the foreground and the content is at least partially visible.

prerender

The content is in the process of prerendering. Only supported by RUM JavaScript.

unknown

The visibility state of the user event cannot be determined. Only used by RUM JavaScript.

Activity

Semantic conventions for activity events in Dynatrace RUM. These conventions are only supported by RUM JavaScript.

Query

This query searches for all activities.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value other.

other

characteristics.has_activity

boolean

experimentalFixed value true.

true

characteristics.has_navigation

boolean

experimentalPrimary characteristic: If set to true, the user event contains navigation information.

true

characteristics.is_api_reported

boolean

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

true

Activity attributes

AttributeTypeDescriptionExamples

activity.id

uid

experimentalA random ID that is generated for every activity. The activity.id is an 8-byte ID and hex-encoded if shown as a string.

f76281848bd8288c

activity.custom_name

string

experimentalThe activity name was reported via the Dynatrace API.

FooBar - Title

activity.interrupted_by_id

uid

experimentalThe activity.id of the activity that interrupted this activity.

f76281848bd8288c

activity.interrupted_id

uid

experimentalThe activity.id of the activity that was interrupted by this activity.

f76281848bd8288c

activity.mutation_count

long

experimentalThe number of DOM mutations during the lifespan of the activity.

3

activity.requests.pending_request_count

long

experimentalThe number of requests that were pending when the activity finished.

2

activity.requests.data_url_request_count

long

experimentalThe number of requests to a data URL during the lifespan of the activity.

2

activity.requests.count

long

experimentalThe number of requests during the lifespan of the activity.

10

activity.resource.count

long

experimentalThe number of resources loaded during the lifespan of the activity.

9

activity.resource.__initiator_type__.count

long

experimentalThe number of resources loaded during the lifespan of the activity split by initiator type, for example activity.resource.xmlhttprequest.count. Known initiator types are xmlhttprequest, fetch, navigation, css, script, beacon, video, audio, track, img, image, input, a, iframe, frame, link, icon, internal, violationreport and other.

9

activity.complete_reason

string

experimentalThe reason why the activity was completed.

timeout

activity.complete_reason MUST be one of the following:

ValueDescription

completed

The activity was normally completed.

completed_by_api

The activity was completed using the Dynatrace API.

interrupted_by_api

The activity was interrupted by a new activity started with the Dynatrace API.

interrupted_by_navigation

The activity was interrupted by a navigation.

interrupted_by_request

The activity was interrupted by a request.

no_activity

The activity detection was triggered, but no activity information was captured.

page_hide

The activity was closed because the page was left.

timeout

The activity timed out.

User interaction attributes

AttributeTypeDescriptionExamples

dom_event.is_trusted

boolean

experimentalInteraction is genuine from real user and not a synthetic event.

true

interaction.name

string

experimentalType of action performed by the user.

click

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

Error attributes

AttributeTypeDescriptionExamples

error.csp_violation_count

long

experimentalThe number of CSP rule violations.

1

error.dropped_exception_count

long

experimentalThe number of exceptions that are observed, but which are not captured due to error capture limits.

1

error.exception_count

long

experimentalThe total number of exceptions that are observed, including exceptions that are not captured.

1

error.http_4xx_count

long

experimentalThe number of HTTP request errors with a http.response.status_code of 400 - 499.

1

error.http_5xx_count

long

experimentalThe number of HTTP request errors with a http.response.status_code of 500 - 599.

1

error.http_other_count

long

experimentalThe number of HTTP request errors with a http.response.status_code of 0-99 or 600+ (undefined errors).

1

Web vitals attributes

AttributeTypeDescriptionExamples

web_vitals.cumulative_layout_shift

double

experimentalThe Cumulative Layout Shift (CLS) value.

0.1279

web_vitals.first_input

duration

experimentalThe First Input value.

6000000

web_vitals.first_input_delay

duration

experimentalThe First Input Delay (FID) value.

6000000

web_vitals.interaction_to_next_paint

duration

experimentalThe Interaction to Next Paint (INP) value.

190000000

web_vitals.largest_contentful_paint

duration

experimentalThe Largest Contentful Paint (LCP) value.

880000000

Largest Contentful Paint (LCP) attributes

The Largest Contentful Paint (LCP) attributes contain additional information about the captured web_vitals.largest_contentful_paint.

AttributeTypeDescriptionExamples

lcp.status

string

experimentalThe status information for LCP.

reported

lcp.update_count

long

experimentalThe number of LCP updates during the entire lifespan.

0

lcp.start_time

double

experimentalThe value of the LCP object's startTime property. The unit is milliseconds.

880.0

lcp.url

string

experimentalIf the element is an image, the request URL of the image.

https://www.foo.bar/images/image.png

lcp.load_time

double

experimentalThe value of the LCP object's loadTime property, i.e. the time the element was loaded. The unit is milliseconds. In case the element finished to load but the browser did not render it yet, a negative value is reported.

874.0

lcp.render_time

double

experimentalThe value of the LCP object's renderTime property, i.e. the time that the element was rendered. The unit is milliseconds.

880.0

lcp.size

long

experimentalThe intrinsic size of the element representing its area on the screen. The value is equal to the element's width multiplied by its height, in pixels.

53640

lcp.id

string

experimentalThe element's ID.

productLogo

lcp.ui_element.xpath

string[]

experimentalThe element's xpath. Might be missing, for example for element's that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

lcp.ui_element.tag_name

string

experimentalThe element's tag name. Might be missing, for example for element's that are inside a shadow DOM.

BUTTON

lcp.ui_element.render_delay

double

experimentalThe element's render delay, that is the time between when the element finishes loading and when it is fully rendered. The unit is milliseconds. Only available if a resource timing is available for the element.

100.0

lcp.resource.load_delay

double

experimentalThe resource's load delay, that is the time between Time to First Byte and when the browser starts loading the resource. The unit is milliseconds. Only available if a resource timing is available for the resource.

400.0

lcp.resource.load_duration

double

experimentalThe resource's load duration, that is the total time it takes to load the resource. The unit is milliseconds. Only available if a resource timing is available for the resource.

300.0

lcp.status MUST be one of the following:

ValueDescription

backgrounded

LCP is not reported because the browser tab was loaded in the background.

disabled

LCP is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

LCP is not reported because no content was rendered.

not_supported

LCP is not supported by the browser.

reported

LCP is reported.

First Input Delay (FID) attributes

The First Input Delay (FID) attributes contain additional information about the captured web_vitals.first_input_delay.

AttributeTypeDescriptionExamples

fid.status

string

experimentalThe status information for FID.

not_reported

fid.loading_state

string

experimentalThe document's loading state recorded at the point in time when the FID was captured.

complete

fid.start_time

double

experimentalThe value of the FID object's startTime property. The unit is milliseconds.

13427.0

fid.duration

double

experimentalThe value of the FID object's duration property. The unit is milliseconds.

24.0

fid.name

string

experimentalThe value of the FID object's name property, i.e. the user interaction event.

click

fid.processing_start

double

experimentalThe value of the FID object's processingStart property. The unit is milliseconds.

13433.0

fid.processing_end

double

experimentalThe value of the FID object's processingEnd property. The unit is milliseconds.

13433.0

fid.processing_duration

double

experimentalHow long it took for the event handler to execute. This is calculated as fid.processing_end minus fid.processing_start.

0.0

fid.cancelable

boolean

experimentalThe value of the FID object's cancelable property.

true

fid.ui_element.xpath

string[]

experimentalThe element's xpath. Might be missing, for example for element's that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

fid.ui_element.tag_name

string

experimentalThe element's tag name. Might be missing, for example for element's that are inside a shadow DOM.

BUTTON

fid.status MUST be one of the following:

ValueDescription

disabled

FID is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

FID is not reported because there was no user interaction.

not_supported

FID is not supported by the browser.

reported

FID is reported.

fid.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

Interaction to Next Paint (INP) attributes

The Interaction to Next Paint (INP) attributes contain additional information about the captured web_vitals.interaction_to_next_paint.

AttributeTypeDescriptionExamples

inp.status

string

experimentalThe status information for INP.

reported

inp.update_count

long

experimentalThe number of INP updates during the entire lifespan.

0

inp.interaction_count

long

experimentalThe number of interactions, during the entire lifespan, that exceed 40 milliseconds.

0

inp.loading_state

string

experimentalThe document's loading state recorded at the point in time when the INP was captured.

complete

inp.start_time

double

experimentalThe value of the INP object's startTime property. The unit is milliseconds.

13427.0

inp.duration

double

experimentalThe value of the INP object's duration property. The unit is milliseconds.

24.0

inp.name

string

experimentalThe value of the INP object's name property, i.e. the user interaction event.

click

inp.processing_start

double

experimentalThe value of the INP object's processingStart property. The unit is milliseconds.

13433.0

inp.processing_end

double

experimentalThe value of the INP object's processingEnd property. The unit is milliseconds.

13433.0

inp.processing_duration

double

experimentalHow long it took for the event handler to execute. This is calculated as inp.processing_end minus inp.processing_start.

0.0

inp.cancelable

boolean

experimentalThe value of the INP object's cancelable property.

true

inp.ui_element.xpath

string[]

experimentalThe element's xpath. Might be missing, for example for element's that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

inp.ui_element.tag_name

string

experimentalThe element's tag name. Might be missing, for example for element's that are inside a shadow DOM.

BUTTON

inp.status MUST be one of the following:

ValueDescription

below_threshold

INP is not reported because the value is below the threshold of 40 milliseconds.

disabled

INP is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

INP is not reported because no relevant user interaction happened.

not_supported

INP is not supported by the browser.

reported

INP is reported.

inp.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

Cumulative Layout Shift (CLS) attributes

The Cumulative Layout Shift (CLS) attributes contain additional information about the captured web_vitals.cumulative_layout_shift.

AttributeTypeDescriptionExamples

cls.status

string

experimentalThe status information for CLS.

not_supported

cls.update_count

long

experimentalThe number of CLS updates during the entire lifespan.

0

cls.loading_state

string

experimentalThe document's loading state recorded at the point in time when the CLS was captured.

complete

cls.value

double

experimentalThe final CLS value.

0.1279

cls.ui_element.xpath

string[]

experimentalThe xpath of the element causing the largest layout shift. Might be missing, for example for elements that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

cls.ui_element.tag_name

string

experimentalThe tag name of the element causing the largest layout shift. Might be missing, for example for elements that are inside a shadow DOM.

BUTTON

cls.ui_element.shift_time

double

experimentalThe time when the largest layout shift occurred. The value is relative to start_time. The unit is milliseconds.

2066.9

cls.ui_element.shift_value

double

experimentalThe layout shift score of the element causing the largest layout shift.

0.11

cls.status MUST be one of the following:

ValueDescription

disabled

CLS is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

CLS is not reported.

not_supported

CLS is not supported by the browser.

reported

CLS is reported.

cls.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

Long task attributes

AttributeTypeDescriptionExamples

long_task.status

string

experimentalThe status information for long task information.

not_supported

long_task.count

long

experimentalThe number of long tasks observed during the entire lifespan.

2

long_task.avg_duration

long

experimentalThe average duration of all observed long tasks in milliseconds.

60

long_task.slowest_occurrences

record[]

experimentalThe start time and the duration of the slowest observed long tasks in milliseconds. The start time is relative to the user event's start_time.

{'duration': 60, 'start_time': 1234}; {'duration': 58, 'start_time': 2999}

long_task.status MUST be one of the following:

ValueDescription

disabled

Long task information is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

Long task information is not reported because no long task was observed.

not_supported

Long tasks API is not supported by the browser.

reported

Long task information is reported.

Navigation attributes

In case a soft navigation happens during the lifespan of an activity, the activity event also contains the navigation attributes that are defined in the navigation model.

Application Not Responding (ANR)

Semantic conventions to describe Application Not Responding (ANR) events in Dynatrace RUM. These conventions are supported only for OneAgent for Mobile.

Query

This query searches for all ANR events.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value error.

error

characteristics.has_anr

boolean

experimentalFixed value true.

true

characteristics.has_error

boolean

experimentalFixed value true.

true

Error attributes

AttributeTypeDescriptionExamples

error.display_name

string

experimentalA human-readable version of error.id.

500: foo.bar/path/file; path/file:1:5

error.id

uid

experimentalA unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string.

357bf70f3c617cb34584b31bd4616af8

error.is_fatal

boolean

experimentalAlways true for ANR errors because the non-responsive app resulted in a fatal exit.

true

error.type

string

experimentalThe main error type. This information is determined by Dynatrace RUM error grouping.

anr

ANR attributes

AttributeTypeDescriptionExamples

exception.message

string

experimentalA message that describes the exception.

user request after error: Input dispatching timed out (f9276c4 com.example\/com.example.MainActivity (server) is not responding. Waited 10001ms for MotionEvent)

exception.stack_trace

string

experimentalThe stack trace of the ANR error. The format depends on the technology and source.

"main" prio=5 tid=1 Sleeping\n | group="main" sCount=1 ucsCount=0 flags=1 obj=0x739329b8 self=0x7f3c8a64c7b0\n at java.lang.Thread.sleep(Native method)

Basic user event attributes

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

Application start

Semantic conventions to describe application starts in Dynatrace RUM. These conventions are supported only for OneAgent for Mobile.

Query

This query searches for all application starts.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value app_start.

app_start

characteristics.has_app_start

boolean

experimentalFixed value true.

true

App start attributes

AttributeTypeDescriptionExamples

app_start.type

string

experimentalThe type of app start.

cold; warm; hot

app_start.type MUST be one of the following:

ValueDescription

cold

A cold app start means that the app started from scratch. For example, this happens in case the app launched for the first time since the device booted.

hot

A hot app start has lower overhead than a cold or warm start. If the app state still resided in memory, operations such as object initialization, layout inflation, and rendering may be avoided.

warm

A warm app start encompasses a subset of the operations that take place during a cold start. For example, this can happen if the user backs out of the app but then re-launches it. This may differ significantly depending on the platform.

Android app start attributes

OneAgent for Mobile sends native Android and cross platform app start attributes in a single event for cross platform implementations.

AttributeTypeDescriptionExamples

app_start.android.application.on_create.start_time

duration

experimentalThe start time of the phase from Application.onCreate to the first Activity.onCreate. The value is relative to start_time.

0

app_start.android.application.on_create.end_time

duration

experimentalThe end time of the phase from Application.onCreate to the first Activity.onCreate. The value is relative to start_time.

123

app_start.android.activity.on_create.start_time

duration

experimentalThe start time of the phase from Activity.onCreate to the first Activity.onStart. The value is relative to start_time.

123

app_start.android.activity.on_create.end_time

duration

experimentalThe end time of the phase from Activity.onCreate to the first Activity.onStart. The value is relative to start_time.

456

app_start.android.activity.on_start.start_time

duration

experimentalThe start time of the phase from Activity.onStart to the first Activity.onResume. The value is relative to start_time.

456

app_start.android.activity.on_start.end_time

duration

experimentalThe end time of the phase from Activity.onStart to the first Activity.onResume. The value is relative to start_time.

789

iOS app start attributes

OneAgent for Mobile sends native iOS and cross platform app start attributes in a single event for cross platform implementations.

AttributeTypeDescriptionExamples

app_start.ios.pre_runtime_init.start_time

duration

experimentalThe start time for the system interface phase, which goes from processStartTime to loadTime. The value is relative to start_time.

0

app_start.ios.pre_runtime_init.end_time

duration

experimentalThe end time for the system interface phase, which goes from processStartTime to loadTime. The value is relative to start_time.

123

app_start.ios.runtime_init.start_time

duration

experimentalThe start time for the runtime init phase, which goes from loadTime to app init. The value is relative to start_time.

123

app_start.ios.runtime_init.end_time

duration

experimentalThe end time for the runtime init phase, which goes from loadTime to app init. The value is relative to start_time.

456

app_start.ios.uikit_init.start_time

duration

experimentalThe start time for the UIKit init phase, which goes from app init to applicationWillFinishLaunching. The value is relative to start_time.

456

app_start.ios.uikit_init.end_time

duration

experimentalThe end time for the UIKit init phase, which goes from app init to applicationWillFinishLaunching. The value is relative to start_time.

789

app_start.ios.application_init.start_time

duration

experimentalThe start time for application init phase, which goes from applicationWillFinishLaunching to loadView. The value is relative to start_time.

789

app_start.ios.application_init.end_time

duration

experimentalThe end time for application init phase, which goes from applicationWillFinishLaunching to loadView. The value is relative to start_time.

1234

app_start.ios.initial_frame_render.start_time

duration

experimentalThe start time for initial frame renderer phase, which goes from loadView or applicationWillEnterForeground for hot starts to applicationDidBecomeActive. The value is relative to start_time.

1234

app_start.ios.initial_frame_render.end_time

duration

experimentalThe end time for the initial frame renderer phase, which goes from loadView or applicationWillEnterForeground for hot starts to applicationDidBecomeActive. The value is relative to start_time.

1567

Flutter app start attributes

AttributeTypeDescriptionExamples

app_start.flutter.pre_plugin_init.start_time

duration

experimentalThe start time for the Flutter engine initialization phase, which triggers the init of the Dynatrace plugin. The value is relative to start_time.

0

app_start.flutter.pre_plugin_init.end_time

duration

experimentalThe end time for the Flutter engine initialization phase, which triggers the init of the Dynatrace plugin. The value is relative to start_time.

123

app_start.flutter.main_init.start_time

duration

experimentalThe start time for the main init phase, which includes the main function call and Dynatrace functionality setup. The value is relative to start_time.

123

app_start.flutter.main_init.end_time

duration

experimentalThe end time for the main init phase, which includes the main function call and Dynatrace functionality setup. The value is relative to start_time.

456

React Native app start attributes

AttributeTypeDescriptionExamples

app_start.react_native.run_js_bundle.load_time

duration

experimentalThe point in time when the bridge is started, essentially when a load or reload happens. The value is relative to start_time.

3

app_start.react_native.download.start_time

duration

experimentalOnly available in development. The start time of the development bundle download phase. The value is relative to start_time.

112

app_start.react_native.download.end_time

duration

experimentalOnly available in development. The end time of the development bundle download phase. The value is relative to start_time.

123

app_start.react_native.run_js_bundle.start_time

duration

experimentalThe start time for the React Native JavaScript bundle loading phase. The value is relative to start_time.

134

app_start.react_native.run_js_bundle.end_time

duration

experimentalThe end time for the React Native JavaScript bundle loading phase. The value is relative to start_time.

135

app_start.react_native.content_appeared

duration

experimentalThe point in time when the initial component is mounted. The value is relative to start_time.

1234

Basic user event attributes

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

Content Security Policy (CSP) rule violation

Semantic conventions for W3C Content Security Policy (CSP) rule violations in Dynatrace RUM. These conventions are only supported for RUM JavaScript.

Query

This query searches for all violations of the Content Security Policy (CSP).

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value error.

error

characteristics.has_csp_violation

boolean

experimentalFixed value true.

true

characteristics.has_error

boolean

experimentalFixed value true.

true

Error attributes

AttributeTypeDescriptionExamples

error.display_name

string

experimentalA human-readable version of error.id.

500: foo.bar/path/file; path/file:1:5

error.id

uid

experimentalA unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string.

357bf70f3c617cb34584b31bd4616af8

error.is_fatal

boolean

experimentalIf set to true, the error resulted in a fatal exit (for example, an unhandled exception). Otherwise this attribute should be omitted.

false

error.reason

string

experimentalThe error reason. RUM JavaScript reports a pre-defined set of values.

no network

error.type

string

experimentalThe main error type. This information is determined by Dynatrace RUM error grouping.

csp

CSP rule violation report attributes

AttributeTypeDescriptionExamples

csp.blocked_uri.full

string

experimentalThe full URI of the resource that was blocked from loading by the Content Security Policy.

https://www.foo.bar/resources/file.js; inline

csp.blocked_uri.scheme

string

experimentalThe URI scheme component. This is extracted from csp.blocked_uri.full.

https

csp.blocked_uri.domain

string

experimentalThe URI domain component. This is extracted from csp.blocked_uri.full.

www.foo.bar

csp.blocked_uri.path

string

experimentalThe URI path component. This is extracted from csp.blocked_uri.full.

/resources/file.js

csp.blocked_uri.query

string

experimentalThe URI query component. This is extracted from csp.blocked_uri.full.

csp.blocked_uri.fragment

string

experimentalThe URI fragment component. This is extracted from csp.blocked_uri.full.

csp.blocked_uri.provider

string

experimentalThe provider type for the host name of csp.blocked_uri.full. This information is determined by Dynatrace RUM resource detection.

third_party

csp.document_uri.full

string

experimentalThe full URI of the document in which the violation occurred.

https://www.foo.bar/

csp.document_uri.scheme

string

experimentalThe URI scheme component. This is extracted from csp.document_uri.full.

https

csp.document_uri.domain

string

experimentalThe URI domain component. This is extracted from csp.document_uri.full.

www.foo.bar

csp.document_uri.path

string

experimentalThe URI path component. This is extracted from csp.document_uri.full.

/

csp.document_uri.query

string

experimentalThe URI query component. This is extracted from csp.document_uri.full.

csp.document_uri.fragment

string

experimentalThe URI fragment component. This is extracted from csp.document_uri.full.

csp.referrer.full

string

experimentalThe referrer of the document in which the violation occurred.

https://www.foo.bar/

csp.disposition

string

experimentalIf set to enforce, the HTTP Content-Security-Policy response header is used and the request was actually blocked. If set to report, the HTTP Content-Security-Policy-Report-Only response header is used and the request was not blocked.

enforce

csp.violated_directive

string

experimentalThe policy directive that was violated, as it appears in the policy.

default-src

csp.effective_directive

string

experimentalThe directive whose enforcement caused the violation.

style-src

csp.original_policy

string

experimentalThe original policy as specified by the HTTP Content-Security-Policy or the HTTP Content-Security-Policy-Report-Only response header.

default-src 'none'; style-src cdn.foo.bar; report-to /_/csp-reports

csp.status_code

long

experimentalThe HTTP status code of the resource on which the global object was instantiated.

200

csp.sample

string

experimentalIf the directive's value contains the expression report-sample, this is set to the first 40 characters of the source file.

csp.line_number

long

experimentalLine number where the violation occurred.

32

csp.column_number

long

experimentalColumn number where the violation occurred.

178

csp.source_file.full

string

experimentalThe full URL (from which the external file was loaded) that caused the violation.

https://www.foo.bar/

csp.reporter

string

experimentalEither ReportingObserver or SecurityPolicyViolationEvent depending on how the CSP violation got captured on site.

ReportingObserver

csp.stack_trace

string

experimentalThe stack trace that RUM JavaScript collected for the CSP rule violation by firing an exception.

@https://www.foo.bar/path/main.js:59:26 e@https://www.foo.bar/path/lib/1.1/lib.js:2:30315

csp.blocked_uri.provider MUST be one of the following:

ValueDescription

cdn

CDN (content delivery network).

first_party

First-party provider.

third_party

Third-party provider.

Basic user event attributes

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

Crash

Semantic conventions to describe crash events in Dynatrace RUM. These conventions are supported only for OneAgent for Mobile.

Query

This query searches for all crashes.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value error.

error

characteristics.has_crash

boolean

experimentalFixed value true.

true

characteristics.has_error

boolean

experimentalFixed value true.

true

Error attributes

AttributeTypeDescriptionExamples

error.display_name

string

experimentalA human-readable version of error.id.

500: foo.bar/path/file; path/file:1:5

error.id

uid

experimentalA unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string.

357bf70f3c617cb34584b31bd4616af8

error.is_fatal

boolean

experimentalIf set to true, the error resulted in a fatal exit (for example, an unhandled exception). Otherwise this attribute should be omitted.

true

error.type

string

experimentalThe main error type. This information is determined by Dynatrace RUM error grouping.

crash

Crash attributes

AttributeTypeDescriptionExamples

exception.crash_signal_name

string

experimentalThe signal that was sent to the process.

SIGSEGV

exception.message

string

experimentalA message that describes the exception.

Division by zero

exception.stack_trace

string

experimentalThe stack trace of the crash or a full crash report. The format depends on the technology and source.

java.lang.ArithmeticException: divide by zero\n at com.example.Foo.bar(Foo.kt:14); signal 6 (SIGABRT), code -1 (SI_QUEUE), fault addr 0000000000000000\nThread-18:\n #00 pc 000000000005cb90 /apex/com.android.runtime/lib64/bionic/libc.so (abort+192) (BuildId: eb58b4d427279994f00c0e1818477e4f)

exception.type

string

experimentalThe type of the exception, for example, its fully-qualified class name or the crash type of a native crash in an Android application.

java.net.ConnectException; OSError; char*

Basic user event attributes

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

Exception

Semantic conventions to describe exceptions in Dynatrace RUM.

Query

This query searches for all exceptions.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value error.

error

characteristics.has_error

boolean

experimentalFixed value true.

true

characteristics.has_exception

boolean

experimentalFixed value true.

true

Error attributes

AttributeTypeDescriptionExamples

error.display_name

string

experimentalA human-readable version of error.id.

500: foo.bar/path/file; path/file:1:5

error.id

uid

experimentalA unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string.

357bf70f3c617cb34584b31bd4616af8

error.is_fatal

boolean

experimentalIf set to true, the error resulted in a fatal exit (for example, an unhandled exception). Otherwise this attribute should be omitted.

true

error.reason

string

experimentalThe error reason. RUM JavaScript reports a pre-defined set of values. OneAgent for iOS reports nserror.domain.

no network

error.source

string

experimentalThe error source.

fetch; console

error.type

string

experimentalThe main error type. This information is determined by Dynatrace RUM error grouping.

exception

Exception attributes

AttributeTypeDescriptionExamples

exception.column_number

long

experimentalThe column number where the exception happened. Only supported by RUM JavaScript, the value is reported as provided by the browser.

12304

exception.file.domain

string

experimentalThe URI domain component. This is extracted from exception.file.full.

www.foo.bar

exception.file.full

string

experimentalThe full file location when the exception happened. Only supported by RUM JavaScript, the value is reported as provided by the browser.

https://www.foo.bar/path/main.js; main.js; <anonymous>

exception.file.path

string

experimentalThe URI path component. This is extracted from exception.file.full.

/path/main.js

exception.file.provider

string

experimentalThe provider type for the host name of exception.file.full. This information is determined by Dynatrace RUM resource detection.

third_party

exception.is_stack_trace_generated

boolean

experimentalIf set to true, the captured stack trace was generated by Dynatrace RUM. This is only available if the user event contains a stack trace. Only supported by RUM JavaScript and OneAgent for Mobile with the Dynatrace Flutter extension.

false

exception.is_stack_trace_wrapped

boolean

experimentalIf set to true, Dynatrace RUM wrapped the method that caused the exception. This is only available if the user event contains a stack trace. Only supported by RUM JavaScript and OneAgent for Mobile with the Dynatrace Flutter extension.

false

exception.line_number

long

experimentalThe line number where the exception happened. Only supported by RUM JavaScript, the value is reported as provided by the browser.

1401

exception.message

string

experimentalA message that describes the exception.

Division by zero

exception.stack_trace

string

experimentalThe stack trace of the exception. The format depends on the technology and source. While OneAgent formats stack traces to unify them across technologies, stack traces from an OpenTelemetry source are in the format they were sent to Dynatrace.

@https://www.foo.bar/path/main.js:59:26 e@https://www.foo.bar/path/lib/1.1/lib.js:2:30315

exception.type

string

experimentalThe type of the exception, for example its fully-qualified class name.

java.net.ConnectException; OSError

Basic user event attributes

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

Long task

Semantic conventions for long task events in Dynatrace RUM. These conventions are only supported by RUM JavaScript.

Query

This query searches for all long tasks.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value other.

other

characteristics.has_long_task

boolean

experimentalFixed value true.

true

Long task attributes

AttributeTypeDescriptionExamples

long_task.name

string

experimentalOne of the following strings refers to the browsing context or frame that can be attributed to the long task: cross-origin-ancestor, cross-origin-descendant, cross-origin-unreachable, multiple-contexts, same-origin-ancestor, same-origin-descendant, same-origin, self, unknown.

cross-origin-ancestor

long_task.attribution.container_id

string

experimentalThe ID of the container where the long task happened.

app-iframe

long_task.attribution.container_name

string

experimentalThe name of the container where the long task happened.

app-iframe

long_task.attribution.container_src

string

experimentalThe source of the container where the long task happened.

http://www.dynatrace.com

long_task.attribution.container_type

string

experimentalThe type of container where the long task happened.

iframe

long_task.attribution.name

string

experimentalThe name of the attribution.

unknown

Navigation

Semantic conventions for navigation events. These conventions are only supported by RUM JavaScript.

Query

This query searches for all navigation events.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value navigation.

navigation

characteristics.has_navigation

boolean

experimentalFixed value true.

true

Navigation attributes

AttributeTypeDescriptionExamples

navigation.type

string

experimentalThe navigation type, including types as defined by W3C and additional Dynatrace-defined navigation types.

navigate

navigation.tab_state

string

experimentalGives additional information about the browser tab.

new

navigation.type MUST be one of the following:

ValueDescription

back_forward

Navigation through the browser's history traversal operation.

back_forward_cache

Back-Forward-Cache navigation detected by RUM JavaScript (only used for standalone navigation events).

navigate

Navigation started by clicking a link, entering the URL in the browser's address bar, form submission, or initializing through a script operation that is not a reload or back_forward navigation.

prerender

Navigation initiated by a prerender hint.

reload

Navigation through the browser's reload operation, location.reload() or a refresh pragma directive like <meta http-equiv="refresh" content="300">.

soft_navigation

Soft navigation detected by RUM JavaScript (only used for standalone navigation events).

navigation.tab_state MUST be one of the following:

ValueDescription

duplicated

Navigation through the browser's Duplicate Tab functionality.

existing

Navigation within an existing tab.

existing_invalid

Navigation within an existing tab but the available tab ID was invalid. This can happen if the RUM JavaScript's browser storage state is externally modified.

new

First navigation or navigation through the browser's Open in New Tab functionality.

View attributes

AttributeTypeDescriptionExamples

view.sequence_number

long

experimentalThe number of views throughout the page's lifespan up to now. This is incremented consecutively with each navigation.

1

Source page attributes

AttributeTypeDescriptionExamples

page.source.url.domain

string

experimentalThe URI host component of the source page URL. This is extracted from page.source.url.full.

www.foo.bar

page.source.url.fragment

string

experimentalThe 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

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

https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h

page.source.url.path

string

experimentalThe URI path component of the source page URL. This is extracted from page.source.url.full.

/path

page.source.url.query

string

experimentalThe URI query component of the source page URL. This is extracted from page.source.url.full.

q=value

page.source.url.scheme

string

experimentalThe URI scheme component of the source page URL. This is extracted from page.source.url.full.

https; http

Source view attributes

AttributeTypeDescriptionExamples

view.source.detected_name

string

experimentalThe view.detected_name value of the previous view. Not applicable for OneAgent for Mobile.

#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e

view.source.name

string

experimentalThe view.name value of the previous view. Not supported by OneAgent for Mobile.

#dashboard;id=<uuid>

view.source.url.domain

string

experimentalThe URI host component of the source view URL. This is extracted from view.source.url.full.

www.foo.bar

view.source.url.fragment

string

experimentalThe 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

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

https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h

view.source.url.path

string

experimentalThe URI path component of the source view URL. This is extracted from view.source.url.full.

/path

view.source.url.query

string

experimentalThe URI query component of the source view URL. This is extracted from view.source.url.full.

q=value

view.source.url.scheme

string

experimentalThe URI scheme component of the source view URL. This is extracted from view.source.url.full.

https; http

Basic user event attributes

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

Page summary

Semantic conventions for page summary events in Dynatrace RUM. These conventions are only supported by RUM JavaScript.

Query

This query searches for all page summaries.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value page_summary.

page_summary

characteristics.has_page_summary

boolean

experimentalFixed value true.

true

Performance attributes

AttributeTypeDescriptionExamples

performance.activation_start

duration

experimentalThe time when a prerendered document is activated. The value is relative to performance.time_origin. This is an experimental feature that is only available in some browsers.

0

performance.time_origin

timestamp

experimentalThe timestamp of the beginning of the current page's lifetime. The value is a UNIX Epoch time in nanoseconds. Time correction is applied.

1667469141402000000

Error attributes

AttributeTypeDescriptionExamples

error.csp_violation_count

long

experimentalThe number of CSP rule violations.

1

error.dropped_exception_count

long

experimentalThe number of exceptions that are observed, but which are not captured due to error capture limits.

1

error.exception_count

long

experimentalThe total number of exceptions that are observed, including exceptions that are not captured.

1

error.http_4xx_count

long

experimentalThe number of HTTP request errors with a http.response.status_code of 400 - 499.

1

error.http_5xx_count

long

experimentalThe number of HTTP request errors with a http.response.status_code of 500 - 599.

1

error.http_other_count

long

experimentalThe number of HTTP request errors with a http.response.status_code of 0-99 or 600+ (undefined errors).

1

Page attributes

AttributeTypeDescriptionExamples

page.background_time

duration

experimentalThe aggregated time that the page was in the background.

0

page.foreground_time

duration

experimentalThe aggregated time that the page was in the foreground.

900000000

page.prerender_time

duration

experimentalThe aggregated time that the page was prerendering.

0

Navigation attributes

AttributeTypeDescriptionExamples

navigation.type

string

experimentalThe navigation type, including types as defined by W3C and additional Dynatrace-defined navigation types.

navigate

navigation.tab_state

string

experimentalGives additional information about the browser tab.

new

navigation.type MUST be one of the following:

ValueDescription

back_forward

Navigation through the browser's history traversal operation.

back_forward_cache

Back-Forward-Cache navigation detected by RUM JavaScript (only used for standalone navigation events).

navigate

Navigation started by clicking a link, entering the URL in the browser's address bar, form submission, or initializing through a script operation that is not a reload or back_forward navigation.

prerender

Navigation initiated by a prerender hint.

reload

Navigation through the browser's reload operation, location.reload() or a refresh pragma directive like <meta http-equiv="refresh" content="300">.

soft_navigation

Soft navigation detected by RUM JavaScript (only used for standalone navigation events).

navigation.tab_state MUST be one of the following:

ValueDescription

duplicated

Navigation through the browser's Duplicate Tab functionality.

existing

Navigation within an existing tab.

existing_invalid

Navigation within an existing tab but the available tab ID was invalid. This can happen if the RUM JavaScript's browser storage state is externally modified.

new

First navigation or navigation through the browser's Open in New Tab functionality.

Web vitals attributes

AttributeTypeDescriptionExamples

web_vitals.largest_contentful_paint

duration

experimentalThe Largest Contentful Paint (LCP) value.

880000000

web_vitals.first_contentful_paint

duration

experimentalThe First Contentful Paint (FCP) value.

92000000

web_vitals.first_input_delay

duration

experimentalThe First Input Delay (FID) value.

6000000

web_vitals.cumulative_layout_shift

double

experimentalThe Cumulative Layout Shift (CLS) value.

0.1279

web_vitals.interaction_to_next_paint

duration

experimentalThe Interaction to Next Paint (INP) value.

190000000

web_vitals.first_input

duration

experimentalThe First Input value.

6000000

web_vitals.first_paint

duration

experimentalThe First Paint value.

92451200

web_vitals.time_to_first_byte

duration

experimentalThe Time to First Byte value.

92000000

Largest Contentful Paint (LCP) attributes

The Largest Contentful Paint (LCP) attributes contain additional information about the captured web_vitals.largest_contentful_paint.

AttributeTypeDescriptionExamples

lcp.status

string

experimentalThe status information for LCP.

reported

lcp.update_count

long

experimentalThe number of LCP updates during the entire lifespan.

0

lcp.start_time

double

experimentalThe value of the LCP object's startTime property. The unit is milliseconds.

880.0

lcp.url

string

experimentalIf the element is an image, the request URL of the image.

https://www.foo.bar/images/image.png

lcp.load_time

double

experimentalThe value of the LCP object's loadTime property, i.e. the time the element was loaded. The unit is milliseconds. In case the element finished to load but the browser did not render it yet, a negative value is reported.

874.0

lcp.render_time

double

experimentalThe value of the LCP object's renderTime property, i.e. the time that the element was rendered. The unit is milliseconds.

880.0

lcp.size

long

experimentalThe intrinsic size of the element representing its area on the screen. The value is equal to the element's width multiplied by its height, in pixels.

53640

lcp.id

string

experimentalThe element's ID.

productLogo

lcp.ui_element.xpath

string[]

experimentalThe element's xpath. Might be missing, for example for element's that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

lcp.ui_element.tag_name

string

experimentalThe element's tag name. Might be missing, for example for element's that are inside a shadow DOM.

BUTTON

lcp.ui_element.render_delay

double

experimentalThe element's render delay, that is the time between when the element finishes loading and when it is fully rendered. The unit is milliseconds. Only available if a resource timing is available for the element.

100.0

lcp.resource.load_delay

double

experimentalThe resource's load delay, that is the time between Time to First Byte and when the browser starts loading the resource. The unit is milliseconds. Only available if a resource timing is available for the resource.

400.0

lcp.resource.load_duration

double

experimentalThe resource's load duration, that is the total time it takes to load the resource. The unit is milliseconds. Only available if a resource timing is available for the resource.

300.0

lcp.status MUST be one of the following:

ValueDescription

backgrounded

LCP is not reported because the browser tab was loaded in the background.

disabled

LCP is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

LCP is not reported because no content was rendered.

not_supported

LCP is not supported by the browser.

reported

LCP is reported.

First Input Delay (FID) attributes

The First Input Delay (FID) attributes contain additional information about the captured web_vitals.first_input_delay.

AttributeTypeDescriptionExamples

fid.status

string

experimentalThe status information for FID.

not_reported

fid.loading_state

string

experimentalThe document's loading state recorded at the point in time when the FID was captured.

complete

fid.start_time

double

experimentalThe value of the FID object's startTime property. The unit is milliseconds.

13427.0

fid.duration

double

experimentalThe value of the FID object's duration property. The unit is milliseconds.

24.0

fid.name

string

experimentalThe value of the FID object's name property, i.e. the user interaction event.

click

fid.processing_start

double

experimentalThe value of the FID object's processingStart property. The unit is milliseconds.

13433.0

fid.processing_end

double

experimentalThe value of the FID object's processingEnd property. The unit is milliseconds.

13433.0

fid.processing_duration

double

experimentalHow long it took for the event handler to execute. This is calculated as fid.processing_end minus fid.processing_start.

0.0

fid.cancelable

boolean

experimentalThe value of the FID object's cancelable property.

true

fid.ui_element.xpath

string[]

experimentalThe element's xpath. Might be missing, for example for element's that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

fid.ui_element.tag_name

string

experimentalThe element's tag name. Might be missing, for example for element's that are inside a shadow DOM.

BUTTON

fid.status MUST be one of the following:

ValueDescription

disabled

FID is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

FID is not reported because there was no user interaction.

not_supported

FID is not supported by the browser.

reported

FID is reported.

fid.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

Interaction to Next Paint (INP) attributes

The Interaction to Next Paint (INP) attributes contain additional information about the captured web_vitals.interaction_to_next_paint.

AttributeTypeDescriptionExamples

inp.status

string

experimentalThe status information for INP.

reported

inp.update_count

long

experimentalThe number of INP updates during the entire lifespan.

0

inp.interaction_count

long

experimentalThe number of interactions, during the entire lifespan, that exceed 40 milliseconds.

0

inp.loading_state

string

experimentalThe document's loading state recorded at the point in time when the INP was captured.

complete

inp.start_time

double

experimentalThe value of the INP object's startTime property. The unit is milliseconds.

13427.0

inp.duration

double

experimentalThe value of the INP object's duration property. The unit is milliseconds.

24.0

inp.name

string

experimentalThe value of the INP object's name property, i.e. the user interaction event.

click

inp.processing_start

double

experimentalThe value of the INP object's processingStart property. The unit is milliseconds.

13433.0

inp.processing_end

double

experimentalThe value of the INP object's processingEnd property. The unit is milliseconds.

13433.0

inp.processing_duration

double

experimentalHow long it took for the event handler to execute. This is calculated as inp.processing_end minus inp.processing_start.

0.0

inp.cancelable

boolean

experimentalThe value of the INP object's cancelable property.

true

inp.ui_element.xpath

string[]

experimentalThe element's xpath. Might be missing, for example for element's that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

inp.ui_element.tag_name

string

experimentalThe element's tag name. Might be missing, for example for element's that are inside a shadow DOM.

BUTTON

inp.status MUST be one of the following:

ValueDescription

below_threshold

INP is not reported because the value is below the threshold of 40 milliseconds.

disabled

INP is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

INP is not reported because no relevant user interaction happened.

not_supported

INP is not supported by the browser.

reported

INP is reported.

inp.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

First Contentful Paint (FCP) attributes

The First Contentful Paint (FCP) attributes contain additional information about the captured web_vitals.first_contentful_paint.

AttributeTypeDescriptionExamples

fcp.status

string

experimentalThe status information for FCP.

reported

fcp.loading_state

string

experimentalThe document's loading state recorded at the point in time when the FCP was captured.

complete

fcp.value

double

experimentalThe value of the FCP object's startTime property. The unit is milliseconds.

92.0

fcp.status MUST be one of the following:

ValueDescription

backgrounded

FCP is not reported because the browser tab was in the background before the value could be reported.

not_reported

FCP is not reported because no content was rendered.

not_supported

FCP is not supported by the browser.

reported

FCP is reported.

fcp.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

Cumulative Layout Shift (CLS) attributes

The Cumulative Layout Shift (CLS) attributes contain additional information about the captured web_vitals.cumulative_layout_shift.

AttributeTypeDescriptionExamples

cls.status

string

experimentalThe status information for CLS.

not_supported

cls.update_count

long

experimentalThe number of CLS updates during the entire lifespan.

0

cls.loading_state

string

experimentalThe document's loading state recorded at the point in time when the CLS was captured.

complete

cls.value

double

experimentalThe final CLS value.

0.1279

cls.ui_element.xpath

string[]

experimentalThe xpath of the element causing the largest layout shift. Might be missing, for example for elements that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

cls.ui_element.tag_name

string

experimentalThe tag name of the element causing the largest layout shift. Might be missing, for example for elements that are inside a shadow DOM.

BUTTON

cls.ui_element.shift_time

double

experimentalThe time when the largest layout shift occurred. The value is relative to start_time. The unit is milliseconds.

2066.9

cls.ui_element.shift_value

double

experimentalThe layout shift score of the element causing the largest layout shift.

0.11

cls.status MUST be one of the following:

ValueDescription

disabled

CLS is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

CLS is not reported.

not_supported

CLS is not supported by the browser.

reported

CLS is reported.

cls.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

First Paint (FP) attributes

The First Paint (FP) attributes contain additional information about the captured web_vitals.first_paint.

AttributeTypeDescriptionExamples

fp.status

string

experimentalThe status information for FP.

reported

fp.loading_state

string

experimentalThe document's loading state recorded at the point in time when the FP was captured.

complete

fp.value

double

experimentalThe value of the FP object's startTime property, i.e. the FP. The unit is milliseconds.

92.0

fp.status MUST be one of the following:

ValueDescription

backgrounded

FP is not reported because the browser tab was in the background before the value could be reported.

not_reported

FP is not reported because no content was rendered.

not_supported

FP is not supported by the browser.

reported

FP is reported.

fp.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

Time to First Byte (TTFB) attributes

The Time to First Byte (TTFB) attributes contain additional information about the captured web_vitals.time_to_first_byte.

AttributeTypeDescriptionExamples

ttfb.status

string

experimentalThe status information for TTFB.

reported

ttfb.value

double

experimentalThe responseStart value of the navigation timing. The unit is milliseconds.

92.0

ttfb.waiting_duration

double

experimentalThe total time from when the user initiates loading to when the navigation request is handled, that is the workerStart or fetchStart value of the navigation timing. Long waiting durations are usually caused by HTTP redirects. The unit is milliseconds.

4.2

ttfb.cache_duration

double

experimentalThe total time spent checking the HTTP cache for a match, that is the domainLookupStart value of the navigation timing minus ttfb.waiting_duration. The unit is milliseconds.

10.12

ttfb.dns_duration

double

experimentalThe total time to resolve the DNS for the requested domain, that is the connectStart value minus the domainLookupStart value of the navigation timing. The unit is milliseconds.

3.3

ttfb.connection_duration

double

experimentalThe total time to create the connection to the requested domain, that is the connectEnd value minus the connectStart value of the navigation timing. The unit is milliseconds.

20.1

ttfb.request_duration

double

experimentalThe total time from when the request was sent until the first byte of the response was received, that is the responseStart value minus the connectEnd value of the navigation timing. The value includes network time and server processing time. The unit is milliseconds.

30.1

ttfb.status MUST be one of the following:

ValueDescription

not_reported

TTFB is not reported by the browser.

reported

TTFB is reported.

Long task attributes

AttributeTypeDescriptionExamples

long_task.status

string

experimentalThe status information for long task information.

not_supported

long_task.count

long

experimentalThe number of long tasks observed during the entire lifespan.

2

long_task.avg_duration

long

experimentalThe average duration of all observed long tasks in milliseconds.

60

long_task.slowest_occurrences

record[]

experimentalThe start time and the duration of the slowest observed long tasks in milliseconds. The start time is relative to the user event's start_time.

{'duration': 60, 'start_time': 1234}; {'duration': 58, 'start_time': 2999}

long_task.status MUST be one of the following:

ValueDescription

disabled

Long task information is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

Long task information is not reported because no long task was observed.

not_supported

Long tasks API is not supported by the browser.

reported

Long task information is reported.

Basic user event attributes

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

Request

Semantic conventions for request events captured on the client in Dynatrace RUM.

Query

This query searches for all request user events.

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

This query searches for all failed requests.

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

Limitations

RUM JavaScript doesn't capture data URL requests.

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalIn case the request failed error, for page loads navigation, or otherwise request.

request

characteristics.has_csp_violation

boolean

experimentalAdditional error characteristic: If set to true, the user event contains a CSP rule violation.

true

characteristics.has_error

boolean

experimentalPrimary characteristic: If set to true, the user event contains at least one error.

true

characteristics.has_exception

boolean

experimentalAdditional error characteristic: If set to true, the user event contains an exception.

true

characteristics.has_failed_request

boolean

experimentalAdditional error characteristic: If set to true, the user event contains a failed request.

true

characteristics.has_navigation

boolean

experimentalPrimary characteristic: If set to true, the user event contains navigation information.

true

characteristics.has_request

boolean

experimentalFixed value true.

true

characteristics.has_w3c_navigation_timings

boolean

experimentalAdditional request characteristic: If set to true, the user event contains W3C navigation timings.

true

characteristics.has_w3c_resource_timings

boolean

experimentalAdditional request characteristic: If set to true, the user event contains W3C resource timings.

true

Network attributes

AttributeTypeDescriptionExamples

network.protocol.name

string

experimentalOSI Application Layer or non-OSI equivalent. This is a mandatory field for request user events.

amqp; http; mqtt

URL attributes

AttributeTypeDescriptionExamples

url.domain

string

experimentalThe URI domain component. This is extracted from url.full.

www.foo.bar; google.com; wikipedia.org

url.fragment

string

experimentalThe URI fragment component. This is extracted from url.full.

SemConv

url.full

string

experimentalAbsolute URL describing a network resource according to RFC3986. OneAgent for Mobile removes the optional user information subcomponent. This is a mandatory field for request user events.Tags: sensitive-spans

https://www.foo.bar/docs/search?q=OpenTelemetry#SemConv

url.path

string

experimentalThe URI path component. This is extracted from url.full.

/docs/search

url.provider

string

experimentalThe provider type for the host name of url.full. This information is determined by Dynatrace RUM resource detection.

third_party

url.query

string

experimentalThe URI query component. This is extracted from url.full.Tags: sensitive-spans

q=OpenTelemetry

url.scheme

string

experimentalThe URI scheme component identifying the used protocol. This is extracted from url.full.

https; ftp; telnet

HTTP attributes

Only available for HTTP requests.

AttributeTypeDescriptionExamples

http.request.method

string

experimentalHTTP request method.

GET; POST; HEAD

http.response.reason_phrase

string

experimentalThe HTTP reason phrase (HTTP1 only).

Not found

http.response.status_code

long

experimentalHTTP response status code.

200

WebSocket attributes

Only available for WebSocket connection request events sent by OneAgent for Mobile.

AttributeTypeDescriptionExamples

websocket.connection.status_code

long

experimentalThe WebSocket connection status code.

1001

Span and trace attributes

AttributeTypeDescriptionExamples

span.id

uid

experimentalA unique identifier for a span within a trace. The span.id is an 8-byte ID and hex-encoded if shown as a string. Only available if Dynatrace RUM starts a trace and sets the Trace Context HTTP headers.

f76281848bd8288c

trace.id

uid

experimentalA unique identifier for a trace. The trace.id is a 16-byte ID and hex-encoded if shown as a string. Available if Dynatrace RUM starts a trace and sets the Trace Context HTTP headers or if RUM JavaScript captures the trace information reported by OneAgent via server-timing HTTP response header.

357bf70f3c617cb34584b31bd4616af8

trace.is_sampled

boolean

experimentalFlag indicating whether the trace was sampled out. If set to true, the trace is recorded. If set to false, the trace is ignored. Only available if RUM JavaScript captures the trace information reported by OneAgent via server-timing HTTP response header. Not supported by OneAgent for Mobile.

Request trace context hint attribute

AttributeTypeDescriptionExamples

request.trace_context_hint

string

experimentalIndicates if and why RUM JavaScript set the W3C Trace Context headers on the request.

excluded

request.server_timing_hint

string

experimentalIndicates if and why RUM JavaScript received trace information from OneAgent via the browser's performance API (PerformanceServerTiming interface).

received

request.trace_context_hint MUST be one of the following:

ValueDescription

cross_origin

Trace Context headers were not set because the request is a cross-origin request.

disabled

Trace Context headers were not set for the request because the feature is disabled.

excluded

Trace Context headers were not set because the request is excluded by configuration.

included

Trace Context headers were set because the request is included by configuration.

not_http

Trace Context headers were not set because the request is not an HTTP request.

set

Trace Context headers were set for the request.

request.server_timing_hint MUST be one of the following:

ValueDescription

invalid

RUM JavaScript ignored invalid trace information.

mismatch

RUM JavaScript received trace information that doesn't match the Trace Context headers.

no_trace_info

No trace information available.

not_available

Server-Timing not available.

received

RUM JavaScript received valid trace information.

Request size attributes

Only available for user events sent by OneAgent for Mobile.

AttributeTypeDescriptionExamples

request.bytes_received

long

experimentalThe estimated number of encoded/compressed bytes received for the request. This includes the response header fields plus the response payload body.

36917

request.bytes_sent

long

experimentalThe estimated number of encoded/compressed bytes sent for the request. This includes the request header fields plus the request payload body.

456

Performance attributes

Only available for user events sent by RUM JavaScript and based on W3C Resource Timing and W3C Navigation Timing.

AttributeTypeDescriptionExamples

performance.incomplete_reason

string

experimentalGives additional information about missing performance fields.

not_detected

performance.time_origin

timestamp

experimentalThe timestamp of the beginning of the current page's lifetime. The value is a UNIX Epoch time in nanoseconds. Time correction is applied.

1667469141402000000

performance.transfer_size

long

experimentalThe size (in octets) of the fetched resource. The size includes the response header fields plus the response payload body.

36917

performance.initiator_type

string

experimentalThe web platform feature that initiated the resource load.

xmlhttprequest

performance.next_hop_protocol

string

experimentalThe network protocol used to fetch the resource.

http/1.1

performance.start_time

duration

experimentalThe start time of the resource fetching phase. The value is relative to performance.time_origin and for navigation timings always 0.

0

performance.domain_lookup_start

duration

experimentalThe start time of the domain name lookup phase. The value is relative to performance.time_origin.

3000000

performance.domain_lookup_end

duration

experimentalThe end time of the domain name lookup phase. The value is relative to performance.time_origin.

3000000

performance.connect_start

duration

experimentalThe start time of the complete server connection phase. The value is relative to performance.time_origin.

3000000

performance.connect_end

duration

experimentalThe end time of the complete server connection phase. The value is relative to performance.time_origin.

3000000

performance.secure_connection_start

duration

experimentalThe start time of the secure server connection phase. The value is relative to performance.time_origin.

3000000

performance.request_start

duration

experimentalThe start time of the resource request phase. The value is relative to performance.time_origin.

17000000

performance.response_start

duration

experimentalThe start time of the resource response phase. (This is also the end time of the resource request phase.) The value is relative to performance.time_origin.

150000000

performance.response_end

duration

experimentalThe end time of the resource response phase. The value is relative to performance.time_origin.

150000000

performance.encoded_body_size

long

experimentalThe size (in octets) of the content encoded body.

31580

performance.decoded_body_size

long

experimentalThe size (in octets) of the body in bytes after removing content encoding.

31580

performance.redirect_start

duration

experimentalThe start time of the redirect phase. The value is relative to performance.time_origin.

0

performance.redirect_end

duration

experimentalThe end time of the redirect phase. The value is relative to performance.time_origin.

0

performance.worker_start

duration

experimentalThe start time of the service worker phase. The value is relative to performance.time_origin.

0

performance.fetch_start

duration

experimentalThe start time of the resource fetching. (This is also the end time of the service worker phase.) The value is relative to performance.time_origin.

3000000

performance.render_blocking_status

string

experimentalThe render-blocking status of the resource.

blocking; non-blocking

performance.first_interim_response_start

duration

experimentalThe time when the first byte was received for an interim 1xx response. The value is relative to performance.time_origin. This is an experimental feature that is only available in some browsers.

0

performance.final_response_headers_start

duration

experimentalThe time when the first byte of the final document response was received from the server. The value is relative to performance.time_origin. This is an experimental feature that is only available in some browsers.

0

performance.delivery_type

string

experimentalThe delivery type of the resource, for example cache or navigational-prefetch. This is an experimental feature that is only available in some browsers.

cache

performance.unload_event_start

duration

experimentalThe start time of the unload event handler phase. The value is relative to performance.time_origin.

154000000

performance.unload_event_end

duration

experimentalThe end time of the unload event handler phase. The value is relative to performance.time_origin.

167000000

performance.dom_interactive

duration

experimentalThe time when the DOM construction has finished and interaction with it is possible. The value is relative to performance.time_origin.

409000000

performance.dom_content_loaded_event_start

duration

experimentalThe start time of the DOM content loaded event handler phase. The value is relative to performance.time_origin.

409000000

performance.dom_content_loaded_event_end

duration

experimentalThe end time of the DOM content loaded event handler phase. The value is relative to performance.time_origin.

424000000

performance.dom_complete

duration

experimentalThe time when the DOM is complete. The value is relative to performance.time_origin.

899000000

performance.load_event_start

duration

experimentalThe start time of the load event handler phase. The value is relative to performance.time_origin.

899000000

performance.load_event_end

duration

experimentalThe end time of the load event handler phase. The value is relative to performance.time_origin.

900000000

performance.redirect_count

long

experimentalThe number of redirects since the last non-redirect navigation.

0

performance.activation_start

duration

experimentalThe time when a prerendered document is activated. The value is relative to performance.time_origin. This is an experimental feature that is only available in some browsers.

0

performance.incomplete_reason MUST be one of the following:

ValueDescription

cache_or_cors

The resource was retrieved from a cache or it was a cross-origin request without Timing-Allow-Origin HTTP response header.

invalid_timings

The timings reported by the browser are invalid.

late_aborted

The browser only provides incomplete information because the HTTP request was aborted late in processing.

local_cache

The resource was fetched from a local cache. Set in case performance.transfer_size is zero and performance.decoded_body_size is not zero.

not_detected

Not provided by the browser.

page_dismissal

Page dismissal was triggered while RUM JavaScript waited for resources.

performance.render_blocking_status MUST be one of the following:

ValueDescription

blocking

The resource might potentially block rendering.

non-blocking

The resource does not block rendering.

Web vitals attributes

Only available for user events sent by RUM JavaScript that are based on W3C Navigation Timing.

AttributeTypeDescriptionExamples

web_vitals.time_to_first_byte

duration

experimentalThe Time to First Byte value.

92000000

XHR attributes

Only available for user events sent by RUM JavaScript and captured using the browser's XML Http Request API.

AttributeTypeDescriptionExamples

xhr.load_end

duration

experimentalThe time from request start to XHR load end event. The value is relative to performance.time_origin.

150000000

Activity attributes

Only available for user events sent by RUM JavaScript and in case an activity was active when the request started.

AttributeTypeDescriptionExamples

activity.id

uid

experimentalThe ID of the active activity. The activity.id is an 8-byte ID and hex-encoded if shown as a string.

f76281848bd8288c

Navigation request attributes

Navigation requests, i.e. page loads captured by RUM JavaScript that contain W3C Navigation Timings, contain additional attributes that are defined in the navigation model.

Failed request attributes

Failed requests can contain additional attributes that are defined in the exception model and the Content Security Policy (CSP) rule violation model.

Basic user event attributes

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

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 characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value property.

property

characteristics.has_event_properties

boolean

experimentalFixed value true.

true

characteristics.is_api_reported

boolean

experimentalFixed value true.

true

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

experimentalContains 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 event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value property.

property

characteristics.has_session_properties

boolean

experimentalFixed value true.

true

characteristics.is_api_reported

boolean

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

true

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

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

42; value

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 event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value property.

property

characteristics.has_user_tag

boolean

experimentalFixed value true.

true

characteristics.is_api_reported

boolean

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

true

User tag

AttributeTypeDescriptionExamples

dt.rum.user_tag

string

experimentalThe user tag.

john.doe@dynatrace.com

Basic user event attributes

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

User interaction

Semantic conventions for standalone user interaction in Dynatrace RUM for web applications.

User event characteristics and common fields

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value user_interaction.

user_interaction

characteristics.has_user_interaction

boolean

experimentalFixed value true.

true

dom_event.is_trusted

boolean

experimentalInteraction is genuine from real user and not a synthetic event.

true

interaction.name

string

experimentalType of action performed by the user.

click

positions

record[]

experimentalArray of {x,y, (start_time)} positions of the mouse or finger. Time units are nanoseconds. Mandatory for click, touch, mouse_over, scroll, long_press, drag, drop, zoom.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400, 'start_time:500': None}, {'x': 200, 'y': 450, 'start_time:900': None}]

Blur events

interaction.name = blur Only if attribute data-dt-blur is present

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Change events

interaction.name = change

UI Element

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

UI Element value

AttributeTypeDescriptionExamples

ui_element.value.content

string

experimentalContent of the form field. Field only captured if the DOM attribute data-dt-content is present.

dark

ui_element.value.length

long

experimentalOnly for some form elements: input and textarea. Length of the value.

89

ui_element.value.selection_count

long

experimentalOnly for some form elements: checkbox, select, etc. Count of selected elements where more than one is possible.

4

ui_element.value.type

string

experimentalType of the form field.

radio; password

ui_element.value.validity

string

experimentalStatus of the validity for the given field

valid; tooShort

Form Element

AttributeTypeDescriptionExamples

form_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

form_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

form_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

form_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

form_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

form_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

form_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

form_element.name_origin

string

experimentalField used to fill form_element.name.

title; name; id; content; value

form_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

form_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Label Element

AttributeTypeDescriptionExamples

label_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

label_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

label_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

label_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

label_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

label_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

label_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

label_element.name_origin

string

experimentalField used to fill label_element.name.

title; name; id; content; value

label_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

label_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Click events

interaction.name = click

UI Element

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Mouse button

AttributeTypeDescriptionExamples

mouse_button

long

experimentalMouse button used for the click interaction. Follows Mouse Button definition.

0

Pointer positions

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedpositionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Drag events

interaction.name = drag
ui_element.* refers to the dragged object

UI Element

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

AttributeTypeDescriptionExamples

drag_resolve

string

experimentalResult of the drag action.

valid_drop

Pointer positions

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedpositionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Drop events

interaction.name = drop
ui_element.* refers to the landing object
drag_element.* refers to the dragged object

UI Element

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Pointer positions

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedpositionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Drag Element

AttributeTypeDescriptionExamples

drag_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

drag_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

drag_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

drag_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

drag_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

drag_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if drag_element has no name or custom_name.

[button--primary, slideshow__image--selected]

drag_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if drag_element has no name or custom_name.

Add to cart; Homepage logo

drag_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if drag_element has no name or custom_name.

[filter, menu]

drag_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

drag_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

drag_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if drag_element has no name or custom_name.

Add to cart; Homepage logo

drag_element.ancestor.name_origin

string

experimentalField used to fill drag_element.ancestor.name. Only available if drag_element has no name or custom_name.

title; name; id; content; value

drag_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if drag_element has no name or custom_name.

[theme:dark, expanded:true]

drag_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

drag_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if drag_element has no name or custom_name.

div; CartFragment

drag_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

drag_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

drag_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

drag_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

drag_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

drag_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

drag_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

drag_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". In case of file use mime type as name. In case of multiple files use a stringified array of mime types, in case of unknown element use "Unknown".

Add to cart; Homepage logo

drag_element.name_origin

string

experimentalField used to fill drag_element.name.

title; name; id; content; value

drag_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

drag_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. drag_element.custom_name, drag_element.name, drag_element.ancestor.custom_name, drag_element.ancestor.name

Add to cart; Homepage logo

drag_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

drag_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. In case of external file it should be data. In case of unknown origin, like external HTML is should be unknown.

div; CartFragment

drag_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Focus events

interaction.name = focus Only if attribute data-dt-focus is present

Pointer positions

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedpositionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Key press events

interaction.name = key_press

UI Element

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Keys

AttributeTypeDescriptionExamples

keys

string[]

experimentalKey or combination of keys pressed by the user. In web only combinations of keys including ctrl, cmd or esc, and standalone esc, enter and tab. In mobile system keys.

[['ctrl', 'alt', 's'], ['Tab']]

Long press events

interaction.name = long_press

UI Element

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Pointer positions

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedpositionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Duration

AttributeTypeDescriptionExamples

duration

duration

experimentalThe difference between start_time and end_time in nanoseconds.

42

Mouse over events

interaction.name = mouse_over
Only if attribute data-dt-mouse-over="x" is present and x is the amount of ms required before sending it.

UI Element

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Pointer positions

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedpositionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Duration

AttributeTypeDescriptionExamples

duration

duration

experimentalThe difference between start_time and end_time in nanoseconds.

42

Resize events

interaction.name = resize

Scroll events

interaction.name = scroll
Only for mobile: pointer_positions are required

UI Element

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Scroll position

AttributeTypeDescriptionExamples

scroll_position.x

long

deprecatedpositionsDelta on horizontal scroll associated to element.scrollLeft.

200

scroll_position.y

long

deprecatedpositionsDelta on vertical scroll associated to element.scrollTop.

200

Scroll parent

AttributeTypeDescriptionExamples

scroll_target.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

scroll_target.id

string[]

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

[UIButtonLabel_234]

scroll_target.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Touch events

interaction.name = touch

UI Element

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

[button--primary, slideshow__image--selected]

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

[filter, menu]

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

[theme:dark, expanded:true]

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

[//*[@id="cart"], div, div]

ui_element.component

string

experimentalFor mobile only. Type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

[button--primary, slideshow__image--selected]

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

[filter, menu]

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

[theme:dark, expanded:true]

ui_element.resolved_name

string

experimentalName of the element taken from the following fields by priority. ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

[//*[@id="cart"], div, div]

Pointer positions

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedpositionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Zoom events

interaction.name = zoom

AttributeTypeDescriptionExamples

zoom.level

double

experimentalLevel of zoom applied to the page.

1.5

Basic user event attributes

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

View summary

Semantic conventions for view summary events in Dynatrace RUM. Only supported by RUM JavaScript.

Query

This query searches for all view summaries.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value view_summary.

view_summary

characteristics.has_view_summary

boolean

experimentalFixed value true.

true

Performance attributes

Only available for user events sent by RUM JavaScript.

AttributeTypeDescriptionExamples

performance.activation_start

duration

experimentalThe time when a prerendered document is activated. The value is relative to performance.time_origin. This is an experimental feature that is only available in some browsers.

0

performance.time_origin

timestamp

experimentalThe timestamp of the beginning of the current page's lifetime. The value is a UNIX Epoch time in nanoseconds. Time correction is applied.

1667469141402000000

Error attributes

AttributeTypeDescriptionExamples

error.csp_violation_count

long

experimentalThe number of CSP rule violations.

1

error.dropped_exception_count

long

experimentalThe number of exceptions that are observed, but which are not captured due to error capture limits.

1

error.exception_count

long

experimentalThe total number of exceptions that are observed, including exceptions that are not captured.

1

error.http_4xx_count

long

experimentalThe number of HTTP request errors with a http.response.status_code of 400 - 499.

1

error.http_5xx_count

long

experimentalThe number of HTTP request errors with a http.response.status_code of 500 - 599.

1

error.http_other_count

long

experimentalThe number of HTTP request errors with a http.response.status_code of 0-99 or 600+ (undefined errors).

1

View attributes

AttributeTypeDescriptionExamples

view.background_time

duration

experimentalAggregated time that the view was in the background.

0

view.foreground_time

duration

experimentalAggregated time that the view was in the foreground.

900000000

view.prerender_time

duration

experimentalAggregated time that the view was prerendering.

0

view.sequence_number

long

experimentalThe number of views throughout the page's entire lifespan.

1

Navigation attributes

AttributeTypeDescriptionExamples

navigation.type

string

experimentalThe navigation type, including types as defined by W3C and additional Dynatrace-defined navigation types.

navigate

navigation.tab_state

string

experimentalGives additional information about the browser tab.

new

navigation.type MUST be one of the following:

ValueDescription

back_forward

Navigation through the browser's history traversal operation.

back_forward_cache

Back-Forward-Cache navigation detected by RUM JavaScript (only used for standalone navigation events).

navigate

Navigation started by clicking a link, entering the URL in the browser's address bar, form submission, or initializing through a script operation that is not a reload or back_forward navigation.

prerender

Navigation initiated by a prerender hint.

reload

Navigation through the browser's reload operation, location.reload() or a refresh pragma directive like <meta http-equiv="refresh" content="300">.

soft_navigation

Soft navigation detected by RUM JavaScript (only used for standalone navigation events).

navigation.tab_state MUST be one of the following:

ValueDescription

duplicated

Navigation through the browser's Duplicate Tab functionality.

existing

Navigation within an existing tab.

existing_invalid

Navigation within an existing tab but the available tab ID was invalid. This can happen if the RUM JavaScript's browser storage state is externally modified.

new

First navigation or navigation through the browser's Open in New Tab functionality.

Web vitals attributes

Only available for user events sent by RUM JavaScript.

AttributeTypeDescriptionExamples

web_vitals.largest_contentful_paint

duration

experimentalThe Largest Contentful Paint (LCP) value.

880000000

web_vitals.first_contentful_paint

duration

experimentalThe First Contentful Paint (FCP) value.

92000000

web_vitals.first_input_delay

duration

experimentalThe First Input Delay (FID) value.

6000000

web_vitals.cumulative_layout_shift

double

experimentalThe Cumulative Layout Shift (CLS) value.

0.1279

web_vitals.interaction_to_next_paint

duration

experimentalThe Interaction to Next Paint (INP) value.

190000000

web_vitals.first_input

duration

experimentalThe First Input value.

6000000

web_vitals.first_paint

duration

experimentalThe First Paint value.

92451200

web_vitals.time_to_first_byte

duration

experimentalThe Time to First Byte value.

92000000

Largest Contentful Paint (LCP) attributes

The lcp attributes contain detail information on the captured web_vitals.largest_contentful_paint.

AttributeTypeDescriptionExamples

lcp.status

string

experimentalThe status information for LCP.

reported

lcp.update_count

long

experimentalThe number of LCP updates during the entire lifespan.

0

lcp.start_time

double

experimentalThe value of the LCP object's startTime property. The unit is milliseconds.

880.0

lcp.url

string

experimentalIf the element is an image, the request URL of the image.

https://www.foo.bar/images/image.png

lcp.load_time

double

experimentalThe value of the LCP object's loadTime property, i.e. the time the element was loaded. The unit is milliseconds. In case the element finished to load but the browser did not render it yet, a negative value is reported.

874.0

lcp.render_time

double

experimentalThe value of the LCP object's renderTime property, i.e. the time that the element was rendered. The unit is milliseconds.

880.0

lcp.size

long

experimentalThe intrinsic size of the element representing its area on the screen. The value is equal to the element's width multiplied by its height, in pixels.

53640

lcp.id

string

experimentalThe element's ID.

productLogo

lcp.ui_element.xpath

string[]

experimentalThe element's xpath. Might be missing, for example for element's that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

lcp.ui_element.tag_name

string

experimentalThe element's tag name. Might be missing, for example for element's that are inside a shadow DOM.

BUTTON

lcp.ui_element.render_delay

double

experimentalThe element's render delay, that is the time between when the element finishes loading and when it is fully rendered. The unit is milliseconds. Only available if a resource timing is available for the element.

100.0

lcp.resource.load_delay

double

experimentalThe resource's load delay, that is the time between Time to First Byte and when the browser starts loading the resource. The unit is milliseconds. Only available if a resource timing is available for the resource.

400.0

lcp.resource.load_duration

double

experimentalThe resource's load duration, that is the total time it takes to load the resource. The unit is milliseconds. Only available if a resource timing is available for the resource.

300.0

lcp.status MUST be one of the following:

ValueDescription

backgrounded

LCP is not reported because the browser tab was loaded in the background.

disabled

LCP is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

LCP is not reported because no content was rendered.

not_supported

LCP is not supported by the browser.

reported

LCP is reported.

First Input Delay (FID) attributes

The fid attributes contain detail information on the captured web_vitals.first_input_delay.

AttributeTypeDescriptionExamples

fid.status

string

experimentalThe status information for FID.

not_reported

fid.loading_state

string

experimentalThe document's loading state recorded at the point in time when the FID was captured.

complete

fid.start_time

double

experimentalThe value of the FID object's startTime property. The unit is milliseconds.

13427.0

fid.duration

double

experimentalThe value of the FID object's duration property. The unit is milliseconds.

24.0

fid.name

string

experimentalThe value of the FID object's name property, i.e. the user interaction event.

click

fid.processing_start

double

experimentalThe value of the FID object's processingStart property. The unit is milliseconds.

13433.0

fid.processing_end

double

experimentalThe value of the FID object's processingEnd property. The unit is milliseconds.

13433.0

fid.processing_duration

double

experimentalHow long it took for the event handler to execute. This is calculated as fid.processing_end minus fid.processing_start.

0.0

fid.cancelable

boolean

experimentalThe value of the FID object's cancelable property.

true

fid.ui_element.xpath

string[]

experimentalThe element's xpath. Might be missing, for example for element's that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

fid.ui_element.tag_name

string

experimentalThe element's tag name. Might be missing, for example for element's that are inside a shadow DOM.

BUTTON

fid.status MUST be one of the following:

ValueDescription

disabled

FID is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

FID is not reported because there was no user interaction.

not_supported

FID is not supported by the browser.

reported

FID is reported.

fid.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

Interaction to Next Paint (INP) attributes

The inp attributes contain detail information on the captured web_vitals.interaction_to_next_paint.

AttributeTypeDescriptionExamples

inp.status

string

experimentalThe status information for INP.

reported

inp.update_count

long

experimentalThe number of INP updates during the entire lifespan.

0

inp.interaction_count

long

experimentalThe number of interactions, during the entire lifespan, that exceed 40 milliseconds.

0

inp.loading_state

string

experimentalThe document's loading state recorded at the point in time when the INP was captured.

complete

inp.start_time

double

experimentalThe value of the INP object's startTime property. The unit is milliseconds.

13427.0

inp.duration

double

experimentalThe value of the INP object's duration property. The unit is milliseconds.

24.0

inp.name

string

experimentalThe value of the INP object's name property, i.e. the user interaction event.

click

inp.processing_start

double

experimentalThe value of the INP object's processingStart property. The unit is milliseconds.

13433.0

inp.processing_end

double

experimentalThe value of the INP object's processingEnd property. The unit is milliseconds.

13433.0

inp.processing_duration

double

experimentalHow long it took for the event handler to execute. This is calculated as inp.processing_end minus inp.processing_start.

0.0

inp.cancelable

boolean

experimentalThe value of the INP object's cancelable property.

true

inp.ui_element.xpath

string[]

experimentalThe element's xpath. Might be missing, for example for element's that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

inp.ui_element.tag_name

string

experimentalThe element's tag name. Might be missing, for example for element's that are inside a shadow DOM.

BUTTON

inp.status MUST be one of the following:

ValueDescription

below_threshold

INP is not reported because the value is below the threshold of 40 milliseconds.

disabled

INP is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

INP is not reported because no relevant user interaction happened.

not_supported

INP is not supported by the browser.

reported

INP is reported.

inp.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

First Contentful Paint (FCP) attributes

The fcp attributes contain detail information on the captured web_vitals.first_contentful_paint.

AttributeTypeDescriptionExamples

fcp.status

string

experimentalThe status information for FCP.

reported

fcp.loading_state

string

experimentalThe document's loading state recorded at the point in time when the FCP was captured.

complete

fcp.value

double

experimentalThe value of the FCP object's startTime property. The unit is milliseconds.

92.0

fcp.status MUST be one of the following:

ValueDescription

backgrounded

FCP is not reported because the browser tab was in the background before the value could be reported.

not_reported

FCP is not reported because no content was rendered.

not_supported

FCP is not supported by the browser.

reported

FCP is reported.

fcp.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

Cumulative Layout Shift (CLS) attributes

The cls attributes contain detail information on the captured web_vitals.cumulative_layout_shift.

AttributeTypeDescriptionExamples

cls.status

string

experimentalThe status information for CLS.

not_supported

cls.update_count

long

experimentalThe number of CLS updates during the entire lifespan.

0

cls.loading_state

string

experimentalThe document's loading state recorded at the point in time when the CLS was captured.

complete

cls.value

double

experimentalThe final CLS value.

0.1279

cls.ui_element.xpath

string[]

experimentalThe xpath of the element causing the largest layout shift. Might be missing, for example for elements that are inside a shadow DOM.

[html[1], body[1], div[@id="elementId"], section[1], form[1], div[5], button[1]]

cls.ui_element.tag_name

string

experimentalThe tag name of the element causing the largest layout shift. Might be missing, for example for elements that are inside a shadow DOM.

BUTTON

cls.ui_element.shift_time

double

experimentalThe time when the largest layout shift occurred. The value is relative to start_time. The unit is milliseconds.

2066.9

cls.ui_element.shift_value

double

experimentalThe layout shift score of the element causing the largest layout shift.

0.11

cls.status MUST be one of the following:

ValueDescription

disabled

CLS is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

CLS is not reported.

not_supported

CLS is not supported by the browser.

reported

CLS is reported.

cls.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

First Paint (FP) attributes

The fp attributes contain detail information on the captured web_vitals.first_paint.

AttributeTypeDescriptionExamples

fp.status

string

experimentalThe status information for FP.

reported

fp.loading_state

string

experimentalThe document's loading state recorded at the point in time when the FP was captured.

complete

fp.value

double

experimentalThe value of the FP object's startTime property, i.e. the FP. The unit is milliseconds.

92.0

fp.status MUST be one of the following:

ValueDescription

backgrounded

FP is not reported because the browser tab was in the background before the value could be reported.

not_reported

FP is not reported because no content was rendered.

not_supported

FP is not supported by the browser.

reported

FP is reported.

fp.loading_state MUST be one of the following:

ValueDescription

complete

The document and all sub-resources have finished loading.

dom_content_loaded

The document has been parsed and deferred scripts have finished loading but other sub-resources such as async scripts, images, stylesheets and frames are still loading.

dom_interactive

The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets and frames are still loading.

loading

The document is still loading.

Time to First Byte (TTFB) attributes

The Time to First Byte (TTFB) attributes contain additional information about the captured web_vitals.time_to_first_byte.

AttributeTypeDescriptionExamples

ttfb.status

string

experimentalThe status information for TTFB.

reported

ttfb.value

double

experimentalThe responseStart value of the navigation timing. The unit is milliseconds.

92.0

ttfb.waiting_duration

double

experimentalThe total time from when the user initiates loading to when the navigation request is handled, that is the workerStart or fetchStart value of the navigation timing. Long waiting durations are usually caused by HTTP redirects. The unit is milliseconds.

4.2

ttfb.cache_duration

double

experimentalThe total time spent checking the HTTP cache for a match, that is the domainLookupStart value of the navigation timing minus ttfb.waiting_duration. The unit is milliseconds.

10.12

ttfb.dns_duration

double

experimentalThe total time to resolve the DNS for the requested domain, that is the connectStart value minus the domainLookupStart value of the navigation timing. The unit is milliseconds.

3.3

ttfb.connection_duration

double

experimentalThe total time to create the connection to the requested domain, that is the connectEnd value minus the connectStart value of the navigation timing. The unit is milliseconds.

20.1

ttfb.request_duration

double

experimentalThe total time from when the request was sent until the first byte of the response was received, that is the responseStart value minus the connectEnd value of the navigation timing. The value includes network time and server processing time. The unit is milliseconds.

30.1

ttfb.status MUST be one of the following:

ValueDescription

not_reported

TTFB is not reported by the browser.

reported

TTFB is reported.

Long task attributes

AttributeTypeDescriptionExamples

long_task.status

string

experimentalThe status information for long task information.

not_supported

long_task.count

long

experimentalThe number of long tasks observed during the entire lifespan.

2

long_task.avg_duration

long

experimentalThe average duration of all observed long tasks in milliseconds.

60

long_task.slowest_occurrences

record[]

experimentalThe start time and the duration of the slowest observed long tasks in milliseconds. The start time is relative to the user event's start_time.

{'duration': 60, 'start_time': 1234}; {'duration': 58, 'start_time': 2999}

long_task.status MUST be one of the following:

ValueDescription

disabled

Long task information is not reported because capturing of page and view summaries is disabled (only used for activity events).

not_reported

Long task information is not reported because no long task was observed.

not_supported

Long tasks API is not supported by the browser.

reported

Long task information is reported.

Basic user event attributes

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

Visibility change

Semantic conventions for visibility change events.

Query

This query searches for all visibility changes.

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

User event characteristics

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value visibility_change.

visibility_change

characteristics.has_visibility_change

boolean

experimentalFixed value true.

true

Visibility attributes

AttributeTypeDescriptionExamples

visibility.state

string

experimentalThe visibility state.

foreground

visibility.state MUST be one of the following:

ValueDescription

background

The application or browser tab is in the background and the content is not visible to the user.

foreground

The application or browser tab is in the foreground and the content is at least partially visible.

prerender

The content is in the process of prerendering. Only supported by RUM JavaScript.

unknown

The visibility state of the user event cannot be determined. Only used by RUM JavaScript.

Performance attributes

Only available for user events sent by RUM JavaScript.

AttributeTypeDescriptionExamples

performance.time_origin

timestamp

experimentalThe timestamp of the beginning of the current page's lifetime. The value is a UNIX Epoch time in nanoseconds. Time correction is applied.

1667469141402000000

Basic user event attributes

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