User action events capture user-initiated actions within the application, providing insights into user behavior and interaction patterns.
Mobile user action
A mobile user action represents a significant mobile frontend operation and its downstream effects. Dynatrace RUM groups the triggering interaction together with the resulting requests and navigations into a single user action event. Only supported by OneAgent for Mobile.
Query
This query searches for all OneAgent for Mobile user actions.
fetch user.events
|filter characteristics.has_user_action
|filter dt.rum.agent.type == "android" OR dt.rum.agent.type == "ios"
Mobile user action characteristics fields
Attribute
Type
Description
Examples
characteristics.classifier
string
experimental Fixed value other.
other
characteristics.has_user_action
boolean
stable Fixed value true.
true
characteristics.is_api_reported
boolean
stable Additional characteristic: If set to true, the user event was sent using the Dynatrace API.
true
User action fields
Attribute
Type
Description
Examples
user_action.instance_id
uid
experimental A random ID that is generated for every user action. The user_action.instance_id is an 8-byte ID and hex-encoded if shown as a string.
f76281848bd8288c
user_action.custom_name
string
deprecatedThe attribute user_action.custom_name will be replaced with user_action.name soon. The user action name reported via the Dynatrace API.
FooBar - Title
user_action.id
uid
experimental A unique identifier for user action grouping. The user_action.id is a 8-byte ID and hex-encoded if shown as a string.
f76281848bd8288c
user_action.name
string
experimental A human-readable version of user_action.id. The value can be reported via the Dynatrace API. If not reported via the Dynatrace API, the value is automatically calculated.
click on checkout on #dashboard;id=<uuid>; Loading of /; Reported user action name
user_action.interrupted_by_instance_id
uid
experimental The user_action.instance_id of the user action that interrupted this user action.
f76281848bd8288c
user_action.interrupted_instance_id
uid
experimental The user_action.instance_id of the user action that was interrupted by this user action.
f76281848bd8288c
user_action.hard_navigation_count
long
experimental The number of hard navigations that happened during the lifespan of the user action.
0
user_action.soft_navigation_count
long
experimental The number of soft navigations that happened during the lifespan of the user action.
2
user_action.navigation_count
long
experimental The number of navigations that happened during the lifespan of the user action. Includes all detected navigations, regardless of whether the corresponding event may be canceled via the modify event API later. Only supported by OneAgent for Mobile.
1
user_action.mutation_count
long
experimental The number of DOM mutations during the lifespan of the user action.
3
user_action.requests.pending_request_count
long
experimental The number of requests that were pending when the user action finished.
2
user_action.requests.data_url_request_count
long
experimental The number of requests to a data URL during the lifespan of the user action.
2
user_action.requests.count
long
experimental The number of requests during the lifespan of the user action.
10
user_action.resources.count
long
experimental The number of resources loaded during the lifespan of the user action.
9
user_action.resources.__initiator_type__.count
long
experimental The number of resources loaded during the lifespan of the user action split by initiator type, for example, user_action.resources.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
user_action.complete_reason
string
experimental The reason why the user action was completed.
timeout
user_action.type
string
experimental The user action type.
same_view
user_action.complete_reason MUST be one of the following:
Value
Description
background
The user action was closed because the app was moved to the background. Only supported by OneAgent for Mobile.
completed
The user action was normally completed.
completed_by_api
The user action was completed using the Dynatrace API.
interrupted_by_api
The user action was interrupted by a new user action started with the Dynatrace API.
interrupted_by_automatic
The user action was interrupted by a new auto-captured user action.
page_hide
The user action was closed because the page was left. Only supported by RUM JavaScript.
timeout
The user action timed out.
user_action.type MUST be one of the following:
Value
Description
api
The user action was reported via the Dynatrace API.
app_start
The user action was triggered by an app start. Only supported by OneAgent for Mobile.
hard_navigation
The user action was triggered by a hard navigation (full page load). Only supported by RUM JavaScript.
navigation
The user action was triggered by a mobile navigation. Only supported by OneAgent for Mobile.
same_view
The user action was triggered by a user interaction, followed by an XHR or fetch request.
soft_navigation
The user action was triggered by a soft navigation that led to a view change. Only supported by RUM JavaScript.
xhr
Replaced with same_view starting with RUM JavaScript version 1.339.
User interaction fields
User interaction fields are only present if the user action was triggered by a user interaction.
Attribute
Type
Description
Examples
interaction.type
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.
Add to cart; Homepage logo
ui_element.detected_name
string
experimental User interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > 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
Error fields
Attribute
Type
Description
Examples
error.count
long
experimental Display name: Error count The total number of errors that are observed.
1
error.exception_count
long
experimental Display name: Error exception count The total number of exceptions that are observed, including exceptions that are not captured.
1
error.has_crash
boolean
experimental If set to true, a crash occurred during the lifetime of this event.
true
error.http_4xx_count
long
experimental Display name: Error HTTP 4xx count The number of HTTP request errors with an http.response.status_code of 400-499.
1
error.http_5xx_count
long
experimental Display name: Error HTTP 5xx count The number of HTTP request errors with an http.response.status_code of 500-599.
1
error.http_other_count
long
experimental Display name: Error HTTP other count The number of HTTP request errors with an http.response.status_code of 0-99 or 600+ (undefined errors).
1
error.request_other_count
long
experimental Display name: Error request other count The number of errors not related to HTTP status codes—for example, timeout or connectivity errors (Android) or other failed-request errors such as WebSocket failures (iOS).
1
Basic user event fields
The basic attributes for all user events are defined in the user event base model.
User action
A user action represents a significant frontend operation and its downstream effects. Dynatrace RUM groups the triggering event, for example the user interaction, together with the resulting requests and DOM mutations into a single user action event. Only supported by RUM JavaScript.
Query
This query searches for all RUM JavaScript user actions.
fetch user.events
|filter characteristics.has_user_action
|filter dt.rum.agent.type == "javascript"
User action characteristics fields
Attribute
Type
Description
Examples
characteristics.classifier
string
experimental Fixed value other.
other
characteristics.has_user_action
boolean
stable Fixed value true.
true
characteristics.is_api_reported
boolean
stable Additional characteristic: If set to true, the user event was sent using the Dynatrace API.
true
User action fields
Attribute
Type
Description
Examples
user_action.instance_id
uid
experimental A random ID that is generated for every user action. The user_action.instance_id is an 8-byte ID and hex-encoded if shown as a string.
f76281848bd8288c
user_action.custom_name
string
deprecatedThe attribute user_action.custom_name will be replaced with user_action.name soon. The user action name reported via the Dynatrace API.
FooBar - Title
user_action.id
uid
experimental A unique identifier for user action grouping. The user_action.id is a 8-byte ID and hex-encoded if shown as a string.
f76281848bd8288c
user_action.name
string
experimental A human-readable version of user_action.id. The value can be reported via the Dynatrace API. If not reported via the Dynatrace API, the value is automatically calculated.
click on checkout on #dashboard;id=<uuid>; Loading of /; Reported user action name
user_action.interrupted_by_instance_id
uid
experimental The user_action.instance_id of the user action that interrupted this user action.
f76281848bd8288c
user_action.interrupted_instance_id
uid
experimental The user_action.instance_id of the user action that was interrupted by this user action.
f76281848bd8288c
user_action.hard_navigation_count
long
experimental The number of hard navigations that happened during the lifespan of the user action.
0
user_action.soft_navigation_count
long
experimental The number of soft navigations that happened during the lifespan of the user action.
2
user_action.navigation_count
long
experimental The number of navigations that happened during the lifespan of the user action. Includes all detected navigations, regardless of whether the corresponding event may be canceled via the modify event API later. Only supported by OneAgent for Mobile.
1
user_action.mutation_count
long
experimental The number of DOM mutations during the lifespan of the user action.
3
user_action.requests.pending_request_count
long
experimental The number of requests that were pending when the user action finished.
2
user_action.requests.data_url_request_count
long
experimental The number of requests to a data URL during the lifespan of the user action.
2
user_action.requests.count
long
experimental The number of requests during the lifespan of the user action.
10
user_action.resources.count
long
experimental The number of resources loaded during the lifespan of the user action.
9
user_action.resources.__initiator_type__.count
long
experimental The number of resources loaded during the lifespan of the user action split by initiator type, for example, user_action.resources.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
user_action.complete_reason
string
experimental The reason why the user action was completed.
timeout
user_action.type
string
experimental The user action type.
same_view
user_action.complete_reason MUST be one of the following:
Value
Description
background
The user action was closed because the app was moved to the background. Only supported by OneAgent for Mobile.
completed
The user action was normally completed.
completed_by_api
The user action was completed using the Dynatrace API.
interrupted_by_api
The user action was interrupted by a new user action started with the Dynatrace API.
interrupted_by_automatic
The user action was interrupted by a new auto-captured user action.
page_hide
The user action was closed because the page was left. Only supported by RUM JavaScript.
timeout
The user action timed out.
user_action.type MUST be one of the following:
Value
Description
api
The user action was reported via the Dynatrace API.
app_start
The user action was triggered by an app start. Only supported by OneAgent for Mobile.
hard_navigation
The user action was triggered by a hard navigation (full page load). Only supported by RUM JavaScript.
navigation
The user action was triggered by a mobile navigation. Only supported by OneAgent for Mobile.
same_view
The user action was triggered by a user interaction, followed by an XHR or fetch request.
soft_navigation
The user action was triggered by a soft navigation that led to a view change. Only supported by RUM JavaScript.
xhr
Replaced with same_view starting with RUM JavaScript version 1.339.
User interaction fields
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
deprecatedReplaced with interaction.type. Type of action performed by the user.
click
interaction.type
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.
Add to cart; Homepage logo
ui_element.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.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
Performance fields
Attribute
Type
Description
Examples
performance.type
string
experimental The navigation type according to the W3C navigation timing. Only available for hard navigations.
navigate
Network fields
Attribute
Type
Description
Examples
network.protocol.name
string
stable Display name: Network protocol OSI Application Layer or non-OSI equivalent. This is a mandatory field for request user events.
amqp; http; mqtt
URL fields
Attribute
Type
Description
Examples
url.domain
string
experimental Display name: URL domain The URI domain component. This is extracted from url.full.
www.foo.bar; google.com; wikipedia.org
url.fragment
string
stable Display name: URL fragment The URI fragment component. This is extracted from url.full.
SemConv
url.full
string
stable Display name: Full URL 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. Dynatrace can mask this field. To learn more, go to masking personal data in URIs. Tags: sensitive-spans
stable Display name: URL path The URI path component. This is extracted from url.full.
/docs/search
url.provider
string
experimental Display name: URL provider The provider type for the host name of url.full. This information is determined by Dynatrace RUM resource detection.
third_party
url.query
string
stable Display name: URL query The URI query component. This is extracted from url.full. Tags: sensitive-spans
q=OpenTelemetry
url.scheme
string
stable Display name: URL scheme The URI scheme component identifying the used protocol. This is extracted from url.full.
https; ftp; telnet
Error fields
Attribute
Type
Description
Examples
error.csp_violation_count
long
experimental Display name: Error CSP violation count The number of CSP rule violations.
1
error.dropped_exception_count
long
experimental Display name: Error dropped exception count The number of exceptions that are observed, but which are not captured due to error capture limits.
1
error.exception_count
long
experimental Display name: Error exception count The total number of exceptions that are observed, including exceptions that are not captured.
1
error.http_4xx_count
long
experimental Display name: Error HTTP 4xx count The number of HTTP request errors with an http.response.status_code of 400-499.
1
error.http_5xx_count
long
experimental Display name: Error HTTP 5xx count The number of HTTP request errors with an http.response.status_code of 500-599.
1
error.http_other_count
long
experimental Display name: Error HTTP other count The number of HTTP request errors with an http.response.status_code of 0-99 or 600+ (undefined errors).
1
User action web vitals attributes
Attribute
Type
Description
Examples
web_vitals.cumulative_layout_shift
double
stable The Cumulative Layout Shift (CLS) value.
0.1279
web_vitals.first_input
duration
stable The First Input value.
6000000
web_vitals.first_input_delay
duration
stable The First Input Delay (FID) value.
6000000
web_vitals.interaction_to_next_paint
duration
stable The Interaction to Next Paint (INP) value.
190000000
web_vitals.largest_contentful_paint
duration
stable The Largest Contentful Paint (LCP) value.
880000000
Largest Contentful Paint (LCP) fields
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 (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 (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.
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 the page has no content.
not_supported
LCP is not supported by the browser.
reported
LCP is reported.
First Input Delay (FID) fields
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 (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.
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.
Interaction to Next Paint (INP) fields
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 (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.
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.
Cumulative Layout Shift (CLS) fields
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.
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
backgrounded
CLS is not reported because the page was loaded in the background or backgrounded before the browser painted any content.
disabled
CLS is not reported because capturing of page and view summaries is disabled (only used for activity events).
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.
Long task fields
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.
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.