User events provide deep visibility and insights into experience, behavior, performance, and errors of your customers and end-users in real-time.
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.
| Attribute | Type | Description | Examples |
|---|---|---|---|
duration | duration | experimental The difference between start_time and end_time in nanoseconds. | 42 |
end_time | timestamp | experimental End 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 | experimental Start 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 | experimental Unique identifier of an user event. | 357bf70f3c617cb34584b31bd4616af8 |
User event characteristics give high-level information about the event's contents. The dedicated user event models describe what characteristics are expected for the model.
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental The main characteristic of the user event determined with the following priority in case of overlapping characteristics: error, page_summary, view_summary, navigation, app_start, visibility_change, user_interaction, request, property, api, invalid, sfm. | error; navigation |
characteristics.has_activity | boolean | experimental Primary characteristic: If set to true, the user event contains an activity event. | true |
characteristics.has_anr | boolean | experimental Additional error characteristic: If set to true, the user event contains an ANR error. | true |
characteristics.has_app_start | boolean | experimental Primary characteristic: If set to true, the user event contains an app start event. | true |
characteristics.has_crash | boolean | experimental Additional error characteristic: If set to true, the user event contains a crash. | true |
characteristics.has_csp_violation | boolean | experimental Additional error characteristic: If set to true, the user event contains a CSP rule violation. | true |
characteristics.has_error | boolean | experimental Primary characteristic: If set to true, the user event contains at least one error. | true |
characteristics.has_event_properties | boolean | experimental Additional characteristic: If set to true, the user event contains event properties. | true |
characteristics.has_exception | boolean | experimental Additional error characteristic: If set to true, the user event contains an exception. | true |
characteristics.has_failed_request | boolean | experimental Additional error characteristic: If set to true, the user event contains a failed request. | true |
characteristics.has_long_task | boolean | experimental Primary characteristic: If set to true, the user event contains a long task event. | true |
characteristics.has_navigation | boolean | experimental Primary characteristic: If set to true, the user event contains navigation information. | true |
characteristics.has_page_summary | boolean | experimental Primary characteristic: If set to true, the user event contains a page summary. | true |
characteristics.has_request | boolean | experimental Primary characteristic: If set to true, the user event contains a request. | true |
characteristics.has_session_properties | boolean | experimental Primary characteristic: If set to true, the user event contains session properties. | true |
characteristics.has_user_interaction | boolean | experimental Primary characteristic: If set to true, the user event contains a user interaction. | true |
characteristics.has_user_tag | boolean | experimental Primary characteristic: If set to true, the user event contains a user tag. | true |
characteristics.has_view_summary | boolean | experimental Primary characteristic: If set to true, the user event contains a view summary. | true |
characteristics.has_visibility_change | boolean | experimental Primary characteristic: If set to true, the user event contains a visibility change event. | false |
characteristics.has_w3c_navigation_timings | boolean | experimental Additional request characteristic: If set to true, the user event contains W3C navigation timings. | true |
characteristics.has_w3c_resource_timings | boolean | experimental Additional request characteristic: If set to true, the user event contains W3C resource timings. | true |
characteristics.is_api_reported | boolean | experimental Additional characteristic: If set to true, the user event was sent using the Dynatrace API. | true |
characteristics.is_invalid | boolean | experimental Primary characteristic: If set to true, the user event was marked invalid during validation. | false |
characteristics.is_self_monitoring | boolean | experimental Primary characteristic: If set to true, the user event is a standalone self-monitoring event. | true |
characteristics.classifier MUST be one of the following:
| Value | Description |
|---|---|
api | The user event was reported via the Dynatrace API. |
app_start | The user event is an application start event. |
error | The user event contains an error. |
invalid | The user event is invalid. |
navigation | The user event contains a navigation. |
other | The user event could not be classified. |
page_summary | The user event is a page summary event. |
property | The user event contains event properties or session properties. |
request | The user event contains request information. |
sfm | The user event is a self-monitoring event. |
user_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 are custom-defined key-value pairs. Dynatrace RUM captures event properties as part of user journeys and uses these to enrich user events.
| Attribute | Type | Description | Examples |
|---|---|---|---|
event_properties.__property_name__ | record | experimental Contains the value for the event property named __property_name__ defined by the event and session property configuration. The data type of the value depends on the definition; default is data type string. | 42; value |
Time correction is applied on all timestamp fields of user events. For more details, go to time correction.
| Attribute | Type | Description | Examples |
|---|---|---|---|
time_correction.is_applied | boolean | experimental If set to true, time correction has been applied to the event's timestamps. | false |
time_correction.offset | long | experimental The offset (in nanoseconds) that is applied to all timestamp fields. The value may be negative. | 127927969312 |
App attributes are only available for user events sent by OneAgent for Mobile.
| Attribute | Type | Description | Examples |
|---|---|---|---|
app.bundle | string | resource experimental The name of the bundle, for example the bundle identifier on iOS or the applicationId on Android. | com.example.easytravel |
app.short_version | string | resource experimental The 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 experimental The application's internal build number, which can include information such as patch number and build number. | 5.23.15789; 143542 |
React Native attributes are only available for user events sent by the React Native plugin.
| Attribute | Type | Description | Examples |
|---|---|---|---|
react_native.bundle.name | string | resource experimental The name of the React Native bundle. | RNBundleName |
react_native.bundle.version | string | resource experimental The version of the React Native bundle. | 0.0.1 |
Browser attributes are only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
browser.frame.id | uid | experimental A 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 | experimental A 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 experimental The browser name. | Mozilla |
browser.tab.id | uid | experimental A 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 experimental The 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 experimental The browser version. | 5.0 |
browser.window.device_pixel_ratio | double | experimental The ratio of the resolution in physical pixels to the resolution in CSS pixels for the current display device. | 1.0 |
browser.window.height | long | experimental The browser window's inner height, in pixels. | 384 |
browser.window.width | long | experimental The browser window's inner width, in pixels. | 2048 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
client.ip | ipAddress | experimental The 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 | experimental The name of the Internet Service Provider (ISP) associated with the client's IP address. | Internet Service Provider Name |
| Attribute | Type | Description | Examples |
|---|---|---|---|
device.battery.level | long | experimental The device's battery level in the range 0% (discharged) to 100% (fully charged). | 100 |
device.is_rooted | boolean | resource experimental If set to true, the device is rooted or jailbroken. Only supported by OneAgent for Mobile. | false |
device.manufacturer | string | resource experimental The device manufacturer. Only supported by OneAgent for Mobile. | Apple |
device.model.identifier | string | resource experimental The device model identifier. Only supported by OneAgent for Mobile. | iPhone3,4 |
device.orientation | string | experimental The device orientation. | landscape |
device.screen.height | long | resource experimental The device's screen height in its natural orientation. | 1152 |
device.screen.width | long | resource experimental The device's screen width in its natural orientation. | 2048 |
device.type | string | resource experimental The type of the device. Only supported by RUM JavaScript. | mobile |
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.openpipeline.pipelines | string[] | resource experimental Collects 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 experimental Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. For user events the value is always rumagent. | rumagent |
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.rum.agent.type | string | resource experimental The Dynatrace RUM agent type. | android |
dt.rum.agent.version | string | resource experimental The 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 | experimental An entity ID of an entity of type APPLICATION or MOBILE_APPLICATION. Tags: entity-id | APPLICATION-DC92E74A7A844E6E; MOBILE_APPLICATION-E8A8751A60D5BCE8 |
dt.rum.application.id | string | experimental The 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 | experimental The browser session ID, taken from the dtCookie value. Not applicable for OneAgent for Mobile. | 4D3133F359A76AB05AAF39691696858A |
dt.rum.event.source.type | string | resource experimental The 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 experimental The 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 experimental The Dynatrace RUM enrichment version. | 0.1 |
dt.rum.session.id | string | experimental A unique ID that represents the user session. | HOPCPWKILUKHFHWRRQGBHHPAFLUJUOSH-0; 23626166142035610_1-0 |
dt.rum.user_type | string | resource experimental The RUM user type. | real_user |
| Attribute | Type | Description | Examples |
|---|---|---|---|
geo.country.iso_code | string | resource experimental The two-letter country code. The format complies with ISO 3316-1 alpha-2. | CA; GB |
geo.location.latitude | double | resource experimental The 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 experimental The 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 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
network.connection.type | string | experimental The internet connection type. Only supported by OneAgent for Mobile. | cell; wifi |
| Attribute | Type | Description | Examples |
|---|---|---|---|
os.name | string | resource experimental The OS name in a short, human-readable format. | iOS |
os.version | string | resource experimental The 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 are only available for RUM Events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
page.detected_name | string | experimental The 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 | experimental A 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 | experimental An identifier for grouping pages. The value is automatically calculated by Dynatrace from page.detected_name. | #dashboard;id=<uuid> |
page.title | string | experimental The HTML DOM document.title property. | FooBar - Title |
page.url.domain | string | experimental The URI host component of the page URL. This is extracted from page.url.full. | www.foo.bar |
page.url.fragment | string | experimental The URI fragment component of the page URL. This is extracted from page.url.full. | dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
page.url.full | string | experimental The 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 | experimental The URI path component of the page URL. This is extracted from page.url.full. | /path |
page.url.query | string | experimental The URI query component of the page URL. This is extracted from page.url.full. | q=value |
page.url.scheme | string | experimental The URI scheme component of the page URL. This is extracted from page.url.full. | https; http |
| Attribute | Type | Description | Examples |
|---|---|---|---|
view.detected_name | string | experimental The 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 | experimental A 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 | experimental An identifier for grouping views. The value can be reported via the Dynatrace API. If not reported via the Dynatrace API, the value is automatically calculated from view.detected_name for user events reported by RUM JavaScript. | #dashboard;id=<uuid>; LoginActivity |
view.url.domain | string | experimental The URI host component of the view URL. This is extracted from view.url.full. | www.foo.bar |
view.url.fragment | string | experimental The URI fragment component of the view URL. This is extracted from view.url.full. | dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
view.url.full | string | experimental The location.href at the time of the event. This is the full URL provided in the format scheme://host[:port]/path[?query][#fragment]. Not applicable for OneAgent for Mobile. | https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
view.url.path | string | experimental The URI path component of the view URL. This is extracted from view.url.full. | /path |
view.url.query | string | experimental The URI query component of the view URL. This is extracted from view.url.full. | q=value |
view.url.scheme | string | experimental The URI scheme component of the view URL. This is extracted from view.url.full. | https; http |
Visibility attributes are only available for RUM Events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
visibility.state | string | experimental The visibility state. | foreground |
visibility.state MUST be one of the following:
| Value | Description |
|---|---|
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. |
Semantic conventions for activity events in Dynatrace RUM. These conventions are only supported by RUM JavaScript.
This query searches for all activities.
fetch user.events| filter characteristics.has_activity == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value other. | other |
characteristics.has_activity | boolean | experimental Fixed value true. | true |
characteristics.has_navigation | boolean | experimental Primary characteristic: If set to true, the user event contains navigation information. | true |
characteristics.is_api_reported | boolean | experimental Additional characteristic: If set to true, the user event was sent using the Dynatrace API. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
activity.id | uid | experimental A 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 | experimental The activity name was reported via the Dynatrace API. | FooBar - Title |
activity.interrupted_by_id | uid | experimental The activity.id of the activity that interrupted this activity. | f76281848bd8288c |
activity.interrupted_id | uid | experimental The activity.id of the activity that was interrupted by this activity. | f76281848bd8288c |
activity.mutation_count | long | experimental The number of DOM mutations during the lifespan of the activity. | 3 |
activity.requests.pending_request_count | long | experimental The number of requests that were pending when the activity finished. | 2 |
activity.requests.data_url_request_count | long | experimental The number of requests to a data URL during the lifespan of the activity. | 2 |
activity.requests.count | long | experimental The number of requests during the lifespan of the activity. | 10 |
activity.resource.count | long | experimental The number of resources loaded during the lifespan of the activity. | 9 |
activity.resource.__initiator_type__.count | long | experimental The 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 | experimental The reason why the activity was completed. | timeout |
activity.complete_reason MUST be one of the following:
| Value | Description |
|---|---|
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. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
dom_event.is_trusted | boolean | experimental Interaction is genuine from real user and not a synthetic event. | true |
interaction.name | string | experimental Type of action performed by the user. | click |
ui_element.custom_name | string | experimental Custom 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 | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.tag_name | string | experimental User 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 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
error.csp_violation_count | long | experimental The number of CSP rule violations. | 1 |
error.dropped_exception_count | long | experimental The number of exceptions that are observed, but which are not captured due to error capture limits. | 1 |
error.exception_count | long | experimental The total number of exceptions that are observed, including exceptions that are not captured. | 1 |
error.http_4xx_count | long | experimental The number of HTTP request errors with a http.response.status_code of 400 - 499. | 1 |
error.http_5xx_count | long | experimental The number of HTTP request errors with a http.response.status_code of 500 - 599. | 1 |
error.http_other_count | long | experimental The number of HTTP request errors with a http.response.status_code of 0-99 or 600+ (undefined errors). | 1 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
web_vitals.cumulative_layout_shift | double | experimental The Cumulative Layout Shift (CLS) value. | 0.1279 |
web_vitals.first_input | duration | experimental The First Input value. | 6000000 |
web_vitals.first_input_delay | duration | experimental The First Input Delay (FID) value. | 6000000 |
web_vitals.interaction_to_next_paint | duration | experimental The Interaction to Next Paint (INP) value. | 190000000 |
web_vitals.largest_contentful_paint | duration | experimental The Largest Contentful Paint (LCP) value. | 880000000 |
The Largest Contentful Paint (LCP) attributes contain additional information about the captured web_vitals.largest_contentful_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
lcp.status | string | experimental The status information for LCP. | reported |
lcp.update_count | long | experimental The number of LCP updates during the entire lifespan. | 0 |
lcp.start_time | double | experimental The value of the LCP object's startTime property. The unit is milliseconds. | 880.0 |
lcp.url | string | experimental If the element is an image, the request URL of the image. | https://www.foo.bar/images/image.png |
lcp.load_time | double | experimental The 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 | experimental The 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 | experimental The 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 | experimental The element's ID. | productLogo |
lcp.ui_element.xpath | string[] | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
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. |
The First Input Delay (FID) attributes contain additional information about the captured web_vitals.first_input_delay.
| Attribute | Type | Description | Examples |
|---|---|---|---|
fid.status | string | experimental The status information for FID. | not_reported |
fid.loading_state | string | experimental The document's loading state recorded at the point in time when the FID was captured. | complete |
fid.start_time | double | experimental The value of the FID object's startTime property. The unit is milliseconds. | 13427.0 |
fid.duration | double | experimental The value of the FID object's duration property. The unit is milliseconds. | 24.0 |
fid.name | string | experimental The value of the FID object's name property, i.e. the user interaction event. | click |
fid.processing_start | double | experimental The value of the FID object's processingStart property. The unit is milliseconds. | 13433.0 |
fid.processing_end | double | experimental The value of the FID object's processingEnd property. The unit is milliseconds. | 13433.0 |
fid.processing_duration | double | experimental How 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 | experimental The value of the FID object's cancelable property. | true |
fid.ui_element.xpath | string[] | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The Interaction to Next Paint (INP) attributes contain additional information about the captured web_vitals.interaction_to_next_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
inp.status | string | experimental The status information for INP. | reported |
inp.update_count | long | experimental The number of INP updates during the entire lifespan. | 0 |
inp.interaction_count | long | experimental The number of interactions, during the entire lifespan, that exceed 40 milliseconds. | 0 |
inp.loading_state | string | experimental The document's loading state recorded at the point in time when the INP was captured. | complete |
inp.start_time | double | experimental The value of the INP object's startTime property. The unit is milliseconds. | 13427.0 |
inp.duration | double | experimental The value of the INP object's duration property. The unit is milliseconds. | 24.0 |
inp.name | string | experimental The value of the INP object's name property, i.e. the user interaction event. | click |
inp.processing_start | double | experimental The value of the INP object's processingStart property. The unit is milliseconds. | 13433.0 |
inp.processing_end | double | experimental The value of the INP object's processingEnd property. The unit is milliseconds. | 13433.0 |
inp.processing_duration | double | experimental How 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 | experimental The value of the INP object's cancelable property. | true |
inp.ui_element.xpath | string[] | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The Cumulative Layout Shift (CLS) attributes contain additional information about the captured web_vitals.cumulative_layout_shift.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cls.status | string | experimental The status information for CLS. | not_supported |
cls.update_count | long | experimental The number of CLS updates during the entire lifespan. | 0 |
cls.loading_state | string | experimental The document's loading state recorded at the point in time when the CLS was captured. | complete |
cls.value | double | experimental The final CLS value. | 0.1279 |
cls.ui_element.xpath | string[] | experimental The 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 | experimental The 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 | experimental The 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 | experimental The layout shift score of the element causing the largest layout shift. | 0.11 |
cls.status MUST be one of the following:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
long_task.status | string | experimental The status information for long task information. | not_supported |
long_task.all.count | long | experimental The number of all long tasks observed during the entire lifespan. | 2 |
long_task.all.avg_duration | long | experimental The average duration of all observed long tasks in milliseconds. | 60 |
long_task.all.slowest_occurrences | record[] | experimental The 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.self.count | long | experimental The number of long tasks from the same browser context or frame observed during the entire lifespan. Only long tasks with long_task.name set to self are considered. | 2 |
long_task.self.avg_duration | long | experimental The average duration of the observed long tasks from the same browser context or frame in milliseconds. Only long tasks with long_task.name set to self are considered. | 60 |
long_task.self.slowest_occurrences | record[] | experimental The start time and the duration of the slowest observed long tasks from the same browser context or frame in milliseconds. The start time is relative to the user event's start_time. Only long tasks with long_task.name set to self are considered. | {'duration': 60, 'start_time': 1234}; {'duration': 58, 'start_time': 2999} |
long_task.status MUST be one of the following:
| Value | Description |
|---|---|
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. |
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.
Semantic conventions to describe Application Not Responding (ANR) events in Dynatrace RUM. These conventions are supported only for OneAgent for Mobile.
This query searches for all ANR events.
fetch user.events| filter characteristics.has_anr == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value error. | error |
characteristics.has_anr | boolean | experimental Fixed value true. | true |
characteristics.has_error | boolean | experimental Fixed value true. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
error.display_name | string | experimental A human-readable version of error.id. | 500: foo.bar/path/file; path/file:1:5 |
error.id | uid | experimental A 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 | experimental Always true for ANR errors because the non-responsive app resulted in a fatal exit. | true |
error.type | string | experimental The main error type. This information is determined by Dynatrace RUM error grouping. | anr |
| Attribute | Type | Description | Examples |
|---|---|---|---|
exception.message | string | experimental A 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 | experimental The 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) |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions to describe application starts in Dynatrace RUM. These conventions are supported only for OneAgent for Mobile.
This query searches for all application starts.
fetch user.events| filter characteristics.has_app_start == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value app_start. | app_start |
characteristics.has_app_start | boolean | experimental Fixed value true. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
app_start.type | string | experimental The type of app start. | cold; warm; hot |
app_start.type MUST be one of the following:
| Value | Description |
|---|---|
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. |
OneAgent for Mobile sends native Android and cross platform app start attributes in a single event for cross platform implementations.
| Attribute | Type | Description | Examples |
|---|---|---|---|
app_start.android.application.on_create.start_time | duration | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The end time of the phase from Activity.onStart to the first Activity.onResume. The value is relative to start_time. | 789 |
OneAgent for Mobile sends native iOS and cross platform app start attributes in a single event for cross platform implementations.
| Attribute | Type | Description | Examples |
|---|---|---|---|
app_start.ios.pre_runtime_init.start_time | duration | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
app_start.flutter.pre_plugin_init.start_time | duration | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
app_start.react_native.run_js_bundle.load_time | duration | experimental The 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 | experimental Only 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 | experimental Only 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 | experimental The 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 | experimental The 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 | experimental The point in time when the initial component is mounted. The value is relative to start_time. | 1234 |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions for W3C Content Security Policy (CSP) rule violations in Dynatrace RUM. These conventions are only supported for RUM JavaScript.
This query searches for all violations of the Content Security Policy (CSP).
fetch user.events| filter characteristics.has_csp_violation == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value error. | error |
characteristics.has_csp_violation | boolean | experimental Fixed value true. | true |
characteristics.has_error | boolean | experimental Fixed value true. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
error.display_name | string | experimental A human-readable version of error.id. | 500: foo.bar/path/file; path/file:1:5 |
error.id | uid | experimental A 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 | experimental If 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 | experimental The error reason. RUM JavaScript reports a pre-defined set of values. | no network |
error.type | string | experimental The main error type. This information is determined by Dynatrace RUM error grouping. | csp |
| Attribute | Type | Description | Examples |
|---|---|---|---|
csp.blocked_uri.full | string | experimental The 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 | experimental The URI scheme component. This is extracted from csp.blocked_uri.full. | https |
csp.blocked_uri.domain | string | experimental The URI domain component. This is extracted from csp.blocked_uri.full. | www.foo.bar |
csp.blocked_uri.path | string | experimental The URI path component. This is extracted from csp.blocked_uri.full. | /resources/file.js |
csp.blocked_uri.query | string | experimental The URI query component. This is extracted from csp.blocked_uri.full. | |
csp.blocked_uri.fragment | string | experimental The URI fragment component. This is extracted from csp.blocked_uri.full. | |
csp.blocked_uri.provider | string | experimental The 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 | experimental The full URI of the document in which the violation occurred. | https://www.foo.bar/ |
csp.document_uri.scheme | string | experimental The URI scheme component. This is extracted from csp.document_uri.full. | https |
csp.document_uri.domain | string | experimental The URI domain component. This is extracted from csp.document_uri.full. | www.foo.bar |
csp.document_uri.path | string | experimental The URI path component. This is extracted from csp.document_uri.full. | / |
csp.document_uri.query | string | experimental The URI query component. This is extracted from csp.document_uri.full. | |
csp.document_uri.fragment | string | experimental The URI fragment component. This is extracted from csp.document_uri.full. | |
csp.referrer.full | string | experimental The referrer of the document in which the violation occurred. | https://www.foo.bar/ |
csp.disposition | string | experimental If 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 | experimental The policy directive that was violated, as it appears in the policy. | default-src |
csp.effective_directive | string | experimental The directive whose enforcement caused the violation. | style-src |
csp.original_policy | string | experimental The 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 | experimental The HTTP status code of the resource on which the global object was instantiated. | 200 |
csp.sample | string | experimental If 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 | experimental Line number where the violation occurred. | 32 |
csp.column_number | long | experimental Column number where the violation occurred. | 178 |
csp.source_file.full | string | experimental The full URL (from which the external file was loaded) that caused the violation. | https://www.foo.bar/ |
csp.reporter | string | experimental Either ReportingObserver or SecurityPolicyViolationEvent depending on how the CSP violation got captured on site. | ReportingObserver |
csp.stack_trace | string | experimental The 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:
| Value | Description |
|---|---|
cdn | CDN (content delivery network). |
first_party | First-party provider. |
third_party | Third-party provider. |
Only available for user events sent by RUM JavaScript and in case an activity was active when the CSP rule violation occurred.
| Attribute | Type | Description | Examples |
|---|---|---|---|
activity.id | uid | experimental The ID of the active activity. The activity.id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions to describe crash events in Dynatrace RUM. These conventions are supported only for OneAgent for Mobile.
This query searches for all crashes.
fetch user.events| filter characteristics.has_crash == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value error. | error |
characteristics.has_crash | boolean | experimental Fixed value true. | true |
characteristics.has_error | boolean | experimental Fixed value true. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
error.display_name | string | experimental A human-readable version of error.id. | 500: foo.bar/path/file; path/file:1:5 |
error.id | uid | experimental A 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 | experimental If 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 | experimental The main error type. This information is determined by Dynatrace RUM error grouping. | crash |
| Attribute | Type | Description | Examples |
|---|---|---|---|
exception.crash_signal_name | string | experimental The signal that was sent to the process. | SIGSEGV |
exception.message | string | experimental A message that describes the exception. | Division by zero |
exception.stack_trace | string | experimental The 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 | experimental The 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* |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions to describe exceptions in Dynatrace RUM.
This query searches for all exceptions.
fetch user.events| filter characteristics.has_exception == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value error. | error |
characteristics.has_error | boolean | experimental Fixed value true. | true |
characteristics.has_exception | boolean | experimental Fixed value true. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
error.display_name | string | experimental A human-readable version of error.id. | 500: foo.bar/path/file; path/file:1:5 |
error.id | uid | experimental A 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 | experimental If 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 | experimental The error reason. RUM JavaScript reports a pre-defined set of values. OneAgent for iOS reports nserror.domain. | no network |
error.source | string | experimental The error source. | fetch; console |
error.type | string | experimental The main error type. This information is determined by Dynatrace RUM error grouping. | exception |
| Attribute | Type | Description | Examples |
|---|---|---|---|
exception.column_number | long | experimental The 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 | experimental The URI domain component. This is extracted from exception.file.full. | www.foo.bar |
exception.file.full | string | experimental The 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 | experimental The URI path component. This is extracted from exception.file.full. | /path/main.js |
exception.file.provider | string | experimental The 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 | experimental If 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 | experimental If 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 | experimental The line number where the exception happened. Only supported by RUM JavaScript, the value is reported as provided by the browser. | 1401 |
exception.message | string | experimental A message that describes the exception. | Division by zero |
exception.stack_trace | string | experimental The 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 | experimental The type of the exception, for example its fully-qualified class name. | java.net.ConnectException; OSError |
Only available for user events sent by RUM JavaScript and in case an activity was active when the exception occurred.
| Attribute | Type | Description | Examples |
|---|---|---|---|
activity.id | uid | experimental The ID of the active activity. The activity.id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions for long task events in Dynatrace RUM. These conventions are only supported by RUM JavaScript.
This query searches for all long tasks.
fetch user.events| filter characteristics.has_long_task == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value other. | other |
characteristics.has_long_task | boolean | experimental Fixed value true. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
long_task.name | string | experimental One 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 | experimental The ID of the container where the long task happened. | app-iframe |
long_task.attribution.container_name | string | experimental The name of the container where the long task happened. | app-iframe |
long_task.attribution.container_src | string | experimental The source of the container where the long task happened. | http://www.dynatrace.com |
long_task.attribution.container_type | string | experimental The type of container where the long task happened. | iframe |
long_task.attribution.name | string | experimental The name of the attribution. | unknown |
Only available in case an activity was active during the long task.
| Attribute | Type | Description | Examples |
|---|---|---|---|
activity.id | uid | experimental The ID of the active activity. The activity.id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
Semantic conventions for navigation events. These conventions are only supported by RUM JavaScript.
This query searches for all navigation events.
fetch user.events| filter characteristics.has_navigation == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value navigation. | navigation |
characteristics.has_navigation | boolean | experimental Fixed value true. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
navigation.type | string | experimental The navigation type, including types as defined by W3C and additional Dynatrace-defined navigation types. | navigate |
navigation.tab_state | string | experimental Gives additional information about the browser tab. | new |
navigation.type MUST be one of the following:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
view.sequence_number | long | experimental The number of views throughout the page's lifespan up to now. This is incremented consecutively with each navigation. | 1 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
page.source.url.domain | string | experimental The URI host component of the source page URL. This is extracted from page.source.url.full. | www.foo.bar |
page.source.url.fragment | string | experimental The URI fragment component of the source page URL. This is extracted from page.source.url.full. | #dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
page.source.url.full | string | experimental The page URL of the previous page, provided in the format scheme://host[:port]/path[?query][#fragment]. This value is captured using document.referrer and may be missing or incomplete. | https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
page.source.url.path | string | experimental The URI path component of the source page URL. This is extracted from page.source.url.full. | /path |
page.source.url.query | string | experimental The URI query component of the source page URL. This is extracted from page.source.url.full. | q=value |
page.source.url.scheme | string | experimental The URI scheme component of the source page URL. This is extracted from page.source.url.full. | https; http |
| Attribute | Type | Description | Examples |
|---|---|---|---|
view.source.detected_name | string | experimental The 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 | experimental The view.name value of the previous view. Not supported by OneAgent for Mobile. | #dashboard;id=<uuid> |
view.source.url.domain | string | experimental The URI host component of the source view URL. This is extracted from view.source.url.full. | www.foo.bar |
view.source.url.fragment | string | experimental The URI fragment component of the source view URL. This is extracted from view.source.url.full. | #dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
view.source.url.full | string | experimental The location.href of the previous view. This is the full URL provided in the format scheme://host[:port]/path[?query][#fragment]. Not applicable for OneAgent for Mobile. | https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h |
view.source.url.path | string | experimental The URI path component of the source view URL. This is extracted from view.source.url.full. | /path |
view.source.url.query | string | experimental The URI query component of the source view URL. This is extracted from view.source.url.full. | q=value |
view.source.url.scheme | string | experimental The URI scheme component of the source view URL. This is extracted from view.source.url.full. | https; http |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions for page summary events in Dynatrace RUM. These conventions are only supported by RUM JavaScript.
This query searches for all page summaries.
fetch user.events| filter characteristics.has_page_summary == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value page_summary. | page_summary |
characteristics.has_page_summary | boolean | experimental Fixed value true. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
performance.activation_start | duration | experimental The 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 | experimental The timestamp of the beginning of the current page's lifetime. The value is a UNIX Epoch time in nanoseconds. Time correction is applied. | 1667469141402000000 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
error.csp_violation_count | long | experimental The number of CSP rule violations. | 1 |
error.dropped_exception_count | long | experimental The number of exceptions that are observed, but which are not captured due to error capture limits. | 1 |
error.exception_count | long | experimental The total number of exceptions that are observed, including exceptions that are not captured. | 1 |
error.http_4xx_count | long | experimental The number of HTTP request errors with a http.response.status_code of 400 - 499. | 1 |
error.http_5xx_count | long | experimental The number of HTTP request errors with a http.response.status_code of 500 - 599. | 1 |
error.http_other_count | long | experimental The number of HTTP request errors with a http.response.status_code of 0-99 or 600+ (undefined errors). | 1 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
page.background_time | duration | experimental The aggregated time that the page was in the background. | 0 |
page.foreground_time | duration | experimental The aggregated time that the page was in the foreground. | 900000000 |
page.prerender_time | duration | experimental The aggregated time that the page was prerendering. | 0 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
navigation.type | string | experimental The navigation type, including types as defined by W3C and additional Dynatrace-defined navigation types. | navigate |
navigation.tab_state | string | experimental Gives additional information about the browser tab. | new |
navigation.type MUST be one of the following:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
web_vitals.largest_contentful_paint | duration | experimental The Largest Contentful Paint (LCP) value. | 880000000 |
web_vitals.first_contentful_paint | duration | experimental The First Contentful Paint (FCP) value. | 92000000 |
web_vitals.first_input_delay | duration | experimental The First Input Delay (FID) value. | 6000000 |
web_vitals.cumulative_layout_shift | double | experimental The Cumulative Layout Shift (CLS) value. | 0.1279 |
web_vitals.interaction_to_next_paint | duration | experimental The Interaction to Next Paint (INP) value. | 190000000 |
web_vitals.first_input | duration | experimental The First Input value. | 6000000 |
web_vitals.first_paint | duration | experimental The First Paint value. | 92451200 |
web_vitals.time_to_first_byte | duration | experimental The Time to First Byte value. | 92000000 |
The Largest Contentful Paint (LCP) attributes contain additional information about the captured web_vitals.largest_contentful_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
lcp.status | string | experimental The status information for LCP. | reported |
lcp.update_count | long | experimental The number of LCP updates during the entire lifespan. | 0 |
lcp.start_time | double | experimental The value of the LCP object's startTime property. The unit is milliseconds. | 880.0 |
lcp.url | string | experimental If the element is an image, the request URL of the image. | https://www.foo.bar/images/image.png |
lcp.load_time | double | experimental The 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 | experimental The 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 | experimental The 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 | experimental The element's ID. | productLogo |
lcp.ui_element.xpath | string[] | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
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. |
The First Input Delay (FID) attributes contain additional information about the captured web_vitals.first_input_delay.
| Attribute | Type | Description | Examples |
|---|---|---|---|
fid.status | string | experimental The status information for FID. | not_reported |
fid.loading_state | string | experimental The document's loading state recorded at the point in time when the FID was captured. | complete |
fid.start_time | double | experimental The value of the FID object's startTime property. The unit is milliseconds. | 13427.0 |
fid.duration | double | experimental The value of the FID object's duration property. The unit is milliseconds. | 24.0 |
fid.name | string | experimental The value of the FID object's name property, i.e. the user interaction event. | click |
fid.processing_start | double | experimental The value of the FID object's processingStart property. The unit is milliseconds. | 13433.0 |
fid.processing_end | double | experimental The value of the FID object's processingEnd property. The unit is milliseconds. | 13433.0 |
fid.processing_duration | double | experimental How 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 | experimental The value of the FID object's cancelable property. | true |
fid.ui_element.xpath | string[] | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The Interaction to Next Paint (INP) attributes contain additional information about the captured web_vitals.interaction_to_next_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
inp.status | string | experimental The status information for INP. | reported |
inp.update_count | long | experimental The number of INP updates during the entire lifespan. | 0 |
inp.interaction_count | long | experimental The number of interactions, during the entire lifespan, that exceed 40 milliseconds. | 0 |
inp.loading_state | string | experimental The document's loading state recorded at the point in time when the INP was captured. | complete |
inp.start_time | double | experimental The value of the INP object's startTime property. The unit is milliseconds. | 13427.0 |
inp.duration | double | experimental The value of the INP object's duration property. The unit is milliseconds. | 24.0 |
inp.name | string | experimental The value of the INP object's name property, i.e. the user interaction event. | click |
inp.processing_start | double | experimental The value of the INP object's processingStart property. The unit is milliseconds. | 13433.0 |
inp.processing_end | double | experimental The value of the INP object's processingEnd property. The unit is milliseconds. | 13433.0 |
inp.processing_duration | double | experimental How 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 | experimental The value of the INP object's cancelable property. | true |
inp.ui_element.xpath | string[] | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The First Contentful Paint (FCP) attributes contain additional information about the captured web_vitals.first_contentful_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
fcp.status | string | experimental The status information for FCP. | reported |
fcp.loading_state | string | experimental The document's loading state recorded at the point in time when the FCP was captured. | complete |
fcp.value | double | experimental The value of the FCP object's startTime property. The unit is milliseconds. | 92.0 |
fcp.status MUST be one of the following:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The Cumulative Layout Shift (CLS) attributes contain additional information about the captured web_vitals.cumulative_layout_shift.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cls.status | string | experimental The status information for CLS. | not_supported |
cls.update_count | long | experimental The number of CLS updates during the entire lifespan. | 0 |
cls.loading_state | string | experimental The document's loading state recorded at the point in time when the CLS was captured. | complete |
cls.value | double | experimental The final CLS value. | 0.1279 |
cls.ui_element.xpath | string[] | experimental The 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 | experimental The 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 | experimental The 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 | experimental The layout shift score of the element causing the largest layout shift. | 0.11 |
cls.status MUST be one of the following:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The First Paint (FP) attributes contain additional information about the captured web_vitals.first_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
fp.status | string | experimental The status information for FP. | reported |
fp.loading_state | string | experimental The document's loading state recorded at the point in time when the FP was captured. | complete |
fp.value | double | experimental The 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The Time to First Byte (TTFB) attributes contain additional information about the captured web_vitals.time_to_first_byte.
| Attribute | Type | Description | Examples |
|---|---|---|---|
ttfb.status | string | experimental The status information for TTFB. | reported |
ttfb.value | double | experimental The responseStart value of the navigation timing. The unit is milliseconds. | 92.0 |
ttfb.waiting_duration | double | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
not_reported | TTFB is not reported by the browser. |
reported | TTFB is reported. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
long_task.status | string | experimental The status information for long task information. | not_supported |
long_task.all.count | long | experimental The number of all long tasks observed during the entire lifespan. | 2 |
long_task.all.avg_duration | long | experimental The average duration of all observed long tasks in milliseconds. | 60 |
long_task.all.slowest_occurrences | record[] | experimental The 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.self.count | long | experimental The number of long tasks from the same browser context or frame observed during the entire lifespan. Only long tasks with long_task.name set to self are considered. | 2 |
long_task.self.avg_duration | long | experimental The average duration of the observed long tasks from the same browser context or frame in milliseconds. Only long tasks with long_task.name set to self are considered. | 60 |
long_task.self.slowest_occurrences | record[] | experimental The start time and the duration of the slowest observed long tasks from the same browser context or frame in milliseconds. The start time is relative to the user event's start_time. Only long tasks with long_task.name set to self are considered. | {'duration': 60, 'start_time': 1234}; {'duration': 58, 'start_time': 2999} |
long_task.status MUST be one of the following:
| Value | Description |
|---|---|
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. |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions for request events captured on the client in Dynatrace RUM.
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
RUM JavaScript doesn't capture data URL requests.
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental In case the request failed error, for page loads navigation, or otherwise request. | request |
characteristics.has_csp_violation | boolean | experimental Additional error characteristic: If set to true, the user event contains a CSP rule violation. | true |
characteristics.has_error | boolean | experimental Primary characteristic: If set to true, the user event contains at least one error. | true |
characteristics.has_exception | boolean | experimental Additional error characteristic: If set to true, the user event contains an exception. | true |
characteristics.has_failed_request | boolean | experimental Additional error characteristic: If set to true, the user event contains a failed request. | true |
characteristics.has_navigation | boolean | experimental Primary characteristic: If set to true, the user event contains navigation information. | true |
characteristics.has_request | boolean | experimental Fixed value true. | true |
characteristics.has_w3c_navigation_timings | boolean | experimental Additional request characteristic: If set to true, the user event contains W3C navigation timings. | true |
characteristics.has_w3c_resource_timings | boolean | experimental Additional request characteristic: If set to true, the user event contains W3C resource timings. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
network.protocol.name | string | experimental OSI Application Layer or non-OSI equivalent. This is a mandatory field for request user events. | amqp; http; mqtt |
| Attribute | Type | Description | Examples |
|---|---|---|---|
url.domain | string | experimental The URI domain component. This is extracted from url.full. | www.foo.bar; google.com; wikipedia.org |
url.fragment | string | experimental The URI fragment component. This is extracted from url.full. | SemConv |
url.full | string | experimental Absolute 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 | experimental The URI path component. This is extracted from url.full. | /docs/search |
url.provider | string | experimental The provider type for the host name of url.full. This information is determined by Dynatrace RUM resource detection. | third_party |
url.query | string | experimental The URI query component. This is extracted from url.full.Tags: sensitive-spans | q=OpenTelemetry |
url.scheme | string | experimental The URI scheme component identifying the used protocol. This is extracted from url.full. | https; ftp; telnet |
Only available for HTTP requests.
| Attribute | Type | Description | Examples |
|---|---|---|---|
http.request.method | string | experimental HTTP request method. | GET; POST; HEAD |
http.response.reason_phrase | string | experimental The HTTP reason phrase (HTTP1 only). | Not found |
http.response.status_code | long | experimental HTTP response status code. | 200 |
Only available for WebSocket connection request events sent by OneAgent for Mobile.
| Attribute | Type | Description | Examples |
|---|---|---|---|
websocket.connection.status_code | long | experimental The WebSocket connection status code. | 1001 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
span.id | uid | experimental A 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 | experimental A 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 | experimental Flag 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. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
request.trace_context_hint | string | experimental Indicates if and why RUM JavaScript set the W3C Trace Context headers on the request. | excluded |
request.server_timing_hint | string | experimental Indicates 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
Only available for user events sent by OneAgent for Mobile.
| Attribute | Type | Description | Examples |
|---|---|---|---|
request.bytes_received | long | experimental The 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 | experimental The estimated number of encoded/compressed bytes sent for the request. This includes the request header fields plus the request payload body. | 456 |
Only available for user events sent by RUM JavaScript and based on W3C Resource Timing and W3C Navigation Timing.
| Attribute | Type | Description | Examples |
|---|---|---|---|
performance.incomplete_reason | string | experimental Gives additional information about missing performance fields. | not_detected |
performance.time_origin | timestamp | experimental The 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 | experimental The size (in octets) of the fetched resource. The size includes the response header fields plus the response payload body. | 36917 |
performance.initiator_type | string | experimental The web platform feature that initiated the resource load. | xmlhttprequest |
performance.next_hop_protocol | string | experimental The network protocol used to fetch the resource. | http/1.1 |
performance.start_time | duration | experimental The 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 | experimental The start time of the domain name lookup phase. The value is relative to performance.time_origin. | 3000000 |
performance.domain_lookup_end | duration | experimental The end time of the domain name lookup phase. The value is relative to performance.time_origin. | 3000000 |
performance.connect_start | duration | experimental The start time of the complete server connection phase. The value is relative to performance.time_origin. | 3000000 |
performance.connect_end | duration | experimental The end time of the complete server connection phase. The value is relative to performance.time_origin. | 3000000 |
performance.secure_connection_start | duration | experimental The start time of the secure server connection phase. The value is relative to performance.time_origin. | 3000000 |
performance.request_start | duration | experimental The start time of the resource request phase. The value is relative to performance.time_origin. | 17000000 |
performance.response_start | duration | experimental The 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 | experimental The end time of the resource response phase. The value is relative to performance.time_origin. | 150000000 |
performance.encoded_body_size | long | experimental The size (in octets) of the content encoded body. | 31580 |
performance.decoded_body_size | long | experimental The size (in octets) of the body in bytes after removing content encoding. | 31580 |
performance.redirect_start | duration | experimental The start time of the redirect phase. The value is relative to performance.time_origin. | 0 |
performance.redirect_end | duration | experimental The end time of the redirect phase. The value is relative to performance.time_origin. | 0 |
performance.worker_start | duration | experimental The start time of the service worker phase. The value is relative to performance.time_origin. | 0 |
performance.fetch_start | duration | experimental The 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 | experimental The render-blocking status of the resource. | blocking; non-blocking |
performance.first_interim_response_start | duration | experimental The 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 | experimental The 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 | experimental The 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 | experimental The start time of the unload event handler phase. The value is relative to performance.time_origin. | 154000000 |
performance.unload_event_end | duration | experimental The end time of the unload event handler phase. The value is relative to performance.time_origin. | 167000000 |
performance.dom_interactive | duration | experimental The 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 | experimental The 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 | experimental The end time of the DOM content loaded event handler phase. The value is relative to performance.time_origin. | 424000000 |
performance.dom_complete | duration | experimental The time when the DOM is complete. The value is relative to performance.time_origin. | 899000000 |
performance.load_event_start | duration | experimental The start time of the load event handler phase. The value is relative to performance.time_origin. | 899000000 |
performance.load_event_end | duration | experimental The end time of the load event handler phase. The value is relative to performance.time_origin. | 900000000 |
performance.redirect_count | long | experimental The number of redirects since the last non-redirect navigation. | 0 |
performance.activation_start | duration | experimental The 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
blocking | The resource might potentially block rendering. |
non-blocking | The resource does not block rendering. |
Only available for user events sent by RUM JavaScript that are based on W3C Navigation Timing.
| Attribute | Type | Description | Examples |
|---|---|---|---|
web_vitals.time_to_first_byte | duration | experimental The Time to First Byte value. | 92000000 |
Only available for user events sent by RUM JavaScript and captured using the browser's XML Http Request API.
| Attribute | Type | Description | Examples |
|---|---|---|---|
xhr.load_end | duration | experimental The time from request start to XHR load end event. The value is relative to performance.time_origin. | 150000000 |
Only available for user events sent by RUM JavaScript and in case an activity was active when the request started.
| Attribute | Type | Description | Examples |
|---|---|---|---|
activity.id | uid | experimental The ID of the active activity. The activity.id is an 8-byte ID and hex-encoded if shown as a string. | f76281848bd8288c |
Navigation requests, i.e. page loads captured by RUM JavaScript that contain W3C Navigation Timings(https://www.w3.org/TR/navigation-timing-2/), contain additional attributes that are defined in the navigation model.
Failed requests can contain additional attributes that are defined in the exception model and the Content Security Policy (CSP) rule violation model.
The basic attributes for all user events are defined in the user event base model.
Semantic conventions for user event properties in Dynatrace RUM.
This query searches for all user event properties events.
fetch user.events| filter characteristics.has_event_properties == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value property. | property |
characteristics.has_event_properties | boolean | experimental Fixed value true. | true |
characteristics.is_api_reported | boolean | experimental Fixed value true. | true |
Event properties are custom-defined key-value pairs. Dynatrace RUM captures event properties as part of user journeys and uses these to enrich user events.
| Attribute | Type | Description | Examples |
|---|---|---|---|
event_properties.__property_name__ | record | experimental Contains the value for the event property named __property_name__ defined by the event and session property configuration. The data type of the value depends on the definition; default is data type string. | 42; value |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions for user session properties in Dynatrace RUM.
This query searches for all user session properties events.
fetch user.events| filter characteristics.has_session_properties == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value property. | property |
characteristics.has_session_properties | boolean | experimental Fixed value true. | true |
characteristics.is_api_reported | boolean | experimental Additional characteristic: If set to true, the user event was sent using the Dynatrace API. | true |
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.
| Attribute | Type | Description | Examples |
|---|---|---|---|
session_properties.__property_name__ | record | experimental Contains the value for the session property named __property_name__ defined by the event and session property configuration. The data type of the value depends on the definition; default is data type string. | 42; value |
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.
Semantic conventions for user tags in Dynatrace RUM.
This query searches for all user tag events.
fetch user.events| filter characteristics.has_user_tag == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value property. | property |
characteristics.has_user_tag | boolean | experimental Fixed value true. | true |
characteristics.is_api_reported | boolean | experimental Additional characteristic: If set to true, the user event was sent using the Dynatrace API. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.rum.user_tag | string | experimental The user tag. | john.doe@dynatrace.com |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions for standalone user interaction in Dynatrace RUM for web applications.
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value user_interaction. | user_interaction |
characteristics.has_user_interaction | boolean | experimental Fixed value true. | true |
dom_event.is_trusted | boolean | experimental Interaction is genuine from real user and not a synthetic event. | true |
interaction.name | string | experimental Type of action performed by the user. | click |
positions | record[] | experimental Array 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}] |
interaction.name = blur
Only if attribute data-dt-blur is present
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
interaction.name = change
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.value.content | string | experimental Content of the form field. Field only captured if the DOM attribute data-dt-content is present. | dark |
ui_element.value.length | long | experimental Only for some form elements: input and textarea. Length of the value. | 89 |
ui_element.value.selection_count | long | experimental Only for some form elements: checkbox, select, etc. Count of selected elements where more than one is possible. | 4 |
ui_element.value.type | string | experimental Type of the form field. | radio; password |
ui_element.value.validity | string | experimental Status of the validity for the given field | valid; tooShort |
| Attribute | Type | Description | Examples |
|---|---|---|---|
form_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
form_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
form_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
form_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
form_element.name | string | experimental User 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 | experimental Field used to fill form_element.name. | title; name; id; content; value |
form_element.properties | string[] | experimental Custom 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
label_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
label_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
label_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
label_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
label_element.name | string | experimental User 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 | experimental Field used to fill label_element.name. | title; name; id; content; value |
label_element.properties | string[] | experimental Custom 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
interaction.name = click
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
mouse_button | long | experimental Mouse button used for the click interaction. Follows Mouse Button definition. | 0 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
pointer_positions | record[] | deprecated positions Array 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}] |
interaction.name = drag
ui_element.* refers to the dragged object
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
drag_resolve | string | experimental Result of the drag action. | valid_drop |
| Attribute | Type | Description | Examples |
|---|---|---|---|
pointer_positions | record[] | deprecated positions Array 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}] |
interaction.name = drop
ui_element.* refers to the landing object
drag_element.* refers to the dragged object
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
pointer_positions | record[] | deprecated positions Array 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}] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
drag_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
drag_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
drag_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
drag_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
drag_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
drag_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
drag_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
drag_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
drag_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
drag_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
drag_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
drag_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
drag_element.name | string | experimental User 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 | experimental Field used to fill drag_element.name. | title; name; id; content; value |
drag_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
interaction.name = focus
Only if attribute data-dt-focus is present
| Attribute | Type | Description | Examples |
|---|---|---|---|
pointer_positions | record[] | deprecated positions Array 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}] |
interaction.name = key_press
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
keys | string[] | experimental Key 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']] |
interaction.name = long_press
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
pointer_positions | record[] | deprecated positions Array 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}] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
duration | duration | experimental The difference between start_time and end_time in nanoseconds. | 42 |
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.
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
pointer_positions | record[] | deprecated positions Array 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}] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
duration | duration | experimental The difference between start_time and end_time in nanoseconds. | 42 |
interaction.name = resize
interaction.name = scroll
Only for mobile: pointer_positions are required
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
scroll_position.x | long | deprecated positions Delta on horizontal scroll associated to element.scrollLeft. | 200 |
scroll_position.y | long | deprecated positions Delta on vertical scroll associated to element.scrollTop. | 200 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
scroll_target.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
scroll_target.id | string[] | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | [UIButtonLabel_234] |
scroll_target.xpath | string[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
interaction.name = touch
| Attribute | Type | Description | Examples |
|---|---|---|---|
ui_element.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.accessibility_id | string | deprecated For mobile only. The accessibility ID of the element. | cartButtonID |
ui_element.ancestor.alt | string | experimental For web and <img> only. Alternative text for an image. | Birds flying over the sea |
ui_element.ancestor.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.ancestor.css_class | string[] | experimental For 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 | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | https://dynatrace.com |
ui_element.ancestor.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.ancestor.name | string | experimental User 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 | experimental Field 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[] | experimental Custom 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 | experimental For 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 | experimental Ancestor 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[] | experimental For web only. The xpath of the user interface element ancestor split as an array. | [//*[@id="cart"], div, div] |
ui_element.component | string | experimental For mobile only. Type of component. Dependent on the technology and its possibilities. | UIButtonLabel |
ui_element.css_class | string[] | experimental For web only. All classes for the current element. | [button--primary, slideshow__image--selected] |
ui_element.custom_name | string | experimental Custom 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[] | experimental Grouping 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 | experimental For web and <a> only. URL of the link converted to an absolute URL. | /; https://dynatrace.com |
ui_element.id | string | experimental For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities. | UIButtonLabel_234 |
ui_element.name | string | experimental User 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 | experimental Field used to fill ui_element.name. | title; name; id; content; value |
ui_element.properties | string[] | experimental Custom 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 | experimental Name 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 | experimental For 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 | experimental User 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[] | experimental For web only. The xpath of the user interface element split as an array. | [//*[@id="cart"], div, div] |
| Attribute | Type | Description | Examples |
|---|---|---|---|
pointer_positions | record[] | deprecated positions Array 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}] |
interaction.name = zoom
| Attribute | Type | Description | Examples |
|---|---|---|---|
zoom.level | double | experimental Level of zoom applied to the page. | 1.5 |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions for view summary events in Dynatrace RUM. Only supported by RUM JavaScript.
This query searches for all view summaries.
fetch user.events| filter characteristics.has_view_summary == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value view_summary. | view_summary |
characteristics.has_view_summary | boolean | experimental Fixed value true. | true |
Only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
performance.activation_start | duration | experimental The 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 | experimental The timestamp of the beginning of the current page's lifetime. The value is a UNIX Epoch time in nanoseconds. Time correction is applied. | 1667469141402000000 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
error.csp_violation_count | long | experimental The number of CSP rule violations. | 1 |
error.dropped_exception_count | long | experimental The number of exceptions that are observed, but which are not captured due to error capture limits. | 1 |
error.exception_count | long | experimental The total number of exceptions that are observed, including exceptions that are not captured. | 1 |
error.http_4xx_count | long | experimental The number of HTTP request errors with a http.response.status_code of 400 - 499. | 1 |
error.http_5xx_count | long | experimental The number of HTTP request errors with a http.response.status_code of 500 - 599. | 1 |
error.http_other_count | long | experimental The number of HTTP request errors with a http.response.status_code of 0-99 or 600+ (undefined errors). | 1 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
view.background_time | duration | experimental Aggregated time that the view was in the background. | 0 |
view.foreground_time | duration | experimental Aggregated time that the view was in the foreground. | 900000000 |
view.prerender_time | duration | experimental Aggregated time that the view was prerendering. | 0 |
view.sequence_number | long | experimental The number of views throughout the page's entire lifespan. | 1 |
| Attribute | Type | Description | Examples |
|---|---|---|---|
navigation.type | string | experimental The navigation type, including types as defined by W3C and additional Dynatrace-defined navigation types. | navigate |
navigation.tab_state | string | experimental Gives additional information about the browser tab. | new |
navigation.type MUST be one of the following:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
Only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
web_vitals.largest_contentful_paint | duration | experimental The Largest Contentful Paint (LCP) value. | 880000000 |
web_vitals.first_contentful_paint | duration | experimental The First Contentful Paint (FCP) value. | 92000000 |
web_vitals.first_input_delay | duration | experimental The First Input Delay (FID) value. | 6000000 |
web_vitals.cumulative_layout_shift | double | experimental The Cumulative Layout Shift (CLS) value. | 0.1279 |
web_vitals.interaction_to_next_paint | duration | experimental The Interaction to Next Paint (INP) value. | 190000000 |
web_vitals.first_input | duration | experimental The First Input value. | 6000000 |
web_vitals.first_paint | duration | experimental The First Paint value. | 92451200 |
web_vitals.time_to_first_byte | duration | experimental The Time to First Byte value. | 92000000 |
The lcp attributes contain detail information on the captured web_vitals.largest_contentful_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
lcp.status | string | experimental The status information for LCP. | reported |
lcp.update_count | long | experimental The number of LCP updates during the entire lifespan. | 0 |
lcp.start_time | double | experimental The value of the LCP object's startTime property. The unit is milliseconds. | 880.0 |
lcp.url | string | experimental If the element is an image, the request URL of the image. | https://www.foo.bar/images/image.png |
lcp.load_time | double | experimental The 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 | experimental The 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 | experimental The 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 | experimental The element's ID. | productLogo |
lcp.ui_element.xpath | string[] | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
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. |
The fid attributes contain detail information on the captured web_vitals.first_input_delay.
| Attribute | Type | Description | Examples |
|---|---|---|---|
fid.status | string | experimental The status information for FID. | not_reported |
fid.loading_state | string | experimental The document's loading state recorded at the point in time when the FID was captured. | complete |
fid.start_time | double | experimental The value of the FID object's startTime property. The unit is milliseconds. | 13427.0 |
fid.duration | double | experimental The value of the FID object's duration property. The unit is milliseconds. | 24.0 |
fid.name | string | experimental The value of the FID object's name property, i.e. the user interaction event. | click |
fid.processing_start | double | experimental The value of the FID object's processingStart property. The unit is milliseconds. | 13433.0 |
fid.processing_end | double | experimental The value of the FID object's processingEnd property. The unit is milliseconds. | 13433.0 |
fid.processing_duration | double | experimental How 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 | experimental The value of the FID object's cancelable property. | true |
fid.ui_element.xpath | string[] | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The inp attributes contain detail information on the captured web_vitals.interaction_to_next_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
inp.status | string | experimental The status information for INP. | reported |
inp.update_count | long | experimental The number of INP updates during the entire lifespan. | 0 |
inp.interaction_count | long | experimental The number of interactions, during the entire lifespan, that exceed 40 milliseconds. | 0 |
inp.loading_state | string | experimental The document's loading state recorded at the point in time when the INP was captured. | complete |
inp.start_time | double | experimental The value of the INP object's startTime property. The unit is milliseconds. | 13427.0 |
inp.duration | double | experimental The value of the INP object's duration property. The unit is milliseconds. | 24.0 |
inp.name | string | experimental The value of the INP object's name property, i.e. the user interaction event. | click |
inp.processing_start | double | experimental The value of the INP object's processingStart property. The unit is milliseconds. | 13433.0 |
inp.processing_end | double | experimental The value of the INP object's processingEnd property. The unit is milliseconds. | 13433.0 |
inp.processing_duration | double | experimental How 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 | experimental The value of the INP object's cancelable property. | true |
inp.ui_element.xpath | string[] | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The fcp attributes contain detail information on the captured web_vitals.first_contentful_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
fcp.status | string | experimental The status information for FCP. | reported |
fcp.loading_state | string | experimental The document's loading state recorded at the point in time when the FCP was captured. | complete |
fcp.value | double | experimental The value of the FCP object's startTime property. The unit is milliseconds. | 92.0 |
fcp.status MUST be one of the following:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The cls attributes contain detail information on the captured web_vitals.cumulative_layout_shift.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cls.status | string | experimental The status information for CLS. | not_supported |
cls.update_count | long | experimental The number of CLS updates during the entire lifespan. | 0 |
cls.loading_state | string | experimental The document's loading state recorded at the point in time when the CLS was captured. | complete |
cls.value | double | experimental The final CLS value. | 0.1279 |
cls.ui_element.xpath | string[] | experimental The 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 | experimental The 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 | experimental The 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 | experimental The layout shift score of the element causing the largest layout shift. | 0.11 |
cls.status MUST be one of the following:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The fp attributes contain detail information on the captured web_vitals.first_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
fp.status | string | experimental The status information for FP. | reported |
fp.loading_state | string | experimental The document's loading state recorded at the point in time when the FP was captured. | complete |
fp.value | double | experimental The 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:
| Value | Description |
|---|---|
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:
| Value | Description |
|---|---|
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. |
The Time to First Byte (TTFB) attributes contain additional information about the captured web_vitals.time_to_first_byte.
| Attribute | Type | Description | Examples |
|---|---|---|---|
ttfb.status | string | experimental The status information for TTFB. | reported |
ttfb.value | double | experimental The responseStart value of the navigation timing. The unit is milliseconds. | 92.0 |
ttfb.waiting_duration | double | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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 | experimental The 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:
| Value | Description |
|---|---|
not_reported | TTFB is not reported by the browser. |
reported | TTFB is reported. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
long_task.status | string | experimental The status information for long task information. | not_supported |
long_task.all.count | long | experimental The number of all long tasks observed during the entire lifespan. | 2 |
long_task.all.avg_duration | long | experimental The average duration of all observed long tasks in milliseconds. | 60 |
long_task.all.slowest_occurrences | record[] | experimental The 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.self.count | long | experimental The number of long tasks from the same browser context or frame observed during the entire lifespan. Only long tasks with long_task.name set to self are considered. | 2 |
long_task.self.avg_duration | long | experimental The average duration of the observed long tasks from the same browser context or frame in milliseconds. Only long tasks with long_task.name set to self are considered. | 60 |
long_task.self.slowest_occurrences | record[] | experimental The start time and the duration of the slowest observed long tasks from the same browser context or frame in milliseconds. The start time is relative to the user event's start_time. Only long tasks with long_task.name set to self are considered. | {'duration': 60, 'start_time': 1234}; {'duration': 58, 'start_time': 2999} |
long_task.status MUST be one of the following:
| Value | Description |
|---|---|
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. |
The basic attributes for all user events are defined in the user event base model.
Semantic conventions for visibility change events.
This query searches for all visibility changes.
fetch user.events| filter characteristics.has_visibility_change == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
characteristics.classifier | string | experimental Fixed value visibility_change. | visibility_change |
characteristics.has_visibility_change | boolean | experimental Fixed value true. | true |
| Attribute | Type | Description | Examples |
|---|---|---|---|
visibility.state | string | experimental The visibility state. | foreground |
visibility.state MUST be one of the following:
| Value | Description |
|---|---|
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. |
Only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
performance.time_origin | timestamp | experimental The timestamp of the beginning of the current page's lifetime. The value is a UNIX Epoch time in nanoseconds. Time correction is applied. | 1667469141402000000 |
The basic attributes for all user events are defined in the user event base model.