Try it free

Navigation-related events

  • Latest Dynatrace
  • Reference

Navigation-related events encompass page summaries, view summaries, and navigations, as well as app starts and visibility changes. These events capture information about how users navigate through the application.

Application start

An application start event represents the initialization of a mobile application and measures the time it takes for the first view to become visible after the app is launched by a user. Dynatrace RUM classifies each start as cold, warm, or hot based on the app's process state at launch time. Only supported by OneAgent for Mobile.

Query

This query searches for all application starts.

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

Application start characteristic fields

AttributeTypeDescriptionExamples
characteristics.has_app_startbooleanstable
Fixed value true.
true
characteristics.has_navigationbooleanstable
Fixed value true.
true
characteristics.has_visibility_changebooleanstable
Optional value true if visibility.state could be detected.
true

Application start fields

AttributeTypeDescriptionExamples
app_start.typestringstable
The type of app start.
cold; warm; hot
app_start.start_timedurationstable
The start time of the App Start. The value is relative to start_time.
0
app_start.end_timedurationstable
The end time of the App Start. The value is relative to start_time.
253

app_start.type MUST be one of the following:

ValueDescription
coldA 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.
hotA 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.
warmA 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.

Application start Android fields

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

AttributeTypeDescriptionExamples
app_start.android.application.on_create.start_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
The end time of the phase from Activity.onStart to the first Activity.onResume. The value is relative to start_time.
789
app_start.android.activity.on_resume.start_timedurationstable
The start time for phase going from Activity.onResume to Activity running state. The value is relative to start_time.
789
app_start.android.activity.on_resume.end_timedurationstable
The end time for phase going from Activity.onResume to Activity running state. The value is relative to start_time.
890

Application start iOS fields

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

AttributeTypeDescriptionExamples
app_start.ios.pre_runtime_init.start_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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

Application start Flutter fields

AttributeTypeDescriptionExamples
app_start.flutter.pre_plugin_init.start_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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

Application start React Native fields

AttributeTypeDescriptionExamples
app_start.react_native.run_js_bundle.load_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
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_timedurationstable
The end time for the React Native JavaScript bundle loading phase. The value is relative to start_time.
135
app_start.react_native.content_appeareddurationstable
The point in time when the initial component is mounted. The value is relative to start_time.
1234

Basic user event fields

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

Mobile view summary

A mobile view corresponds to a distinct screen displayed to the user. A mobile view summary event is emitted when the view instance ends and aggregates all captured data for that view instance. Only supported by OneAgent for Mobile.

Query

This query searches for all OneAgent for Mobile view summaries.

fetch user.events
| filter characteristics.has_view_summary == true
| filter dt.rum.agent.type != "javascript"

Mobile view summary characteristics fields

AttributeTypeDescriptionExamples
characteristics.has_view_summarybooleanstable
Fixed value true.
true

Error fields

AttributeTypeDescriptionExamples
error.countlongexperimental
Display name: Error count
The total number of errors that are observed.
1
error.exception_countlongexperimental
Display name: Error exception count
The total number of exceptions that are observed, including exceptions that are not captured.
1
error.has_crashbooleanexperimental
If set to true, a crash occurred during the lifetime of this event.
true
error.http_4xx_countlongexperimental
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_countlongexperimental
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_countlongexperimental
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_countlongexperimental
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.

Navigation

A navigation event marks the transition to a new view, supported across web and mobile via RUM JavaScript and OneAgent for Mobile.

Query

This query searches for all navigation events.

fetch user.events
| filter characteristics.has_navigation

Navigation characteristics fields

AttributeTypeDescriptionExamples
characteristics.has_navigationbooleanstable
Fixed value true.
true

User action status fields

AttributeTypeDescriptionExamples
user_action.statusstringexperimental
Indicates why no corresponding user action was created for this event. Only available for hard navigations and only supported by RUM JavaScript.
not_initialized

Navigation fields

AttributeTypeDescriptionExamples
navigation.typestringstable
The navigation type.
hard
navigation.tab_statestringstable
Gives additional information about the browser tab.
new

navigation.type MUST be one of the following:

ValueDescription
hardA hard navigation reloads the entire page by fetching it from the server.
softA soft navigation only updates parts of the webpage dynamically without a full reload.

navigation.tab_state MUST be one of the following:

ValueDescription
duplicatedNavigation through the browser's Duplicate Tab functionality.
existingNavigation within an existing tab.
existing_invalidNavigation 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.
newFirst navigation or navigation through the browser's Open in New Tab functionality.

Navigation view fields

AttributeTypeDescriptionExamples
view.sequence_numberlongstable
The number of views throughout the page's lifespan up to now. This is incremented consecutively with each navigation.
1

Navigation source page fields

AttributeTypeDescriptionExamples
page.source.url.domainstringstable
The URI host component of the source page URL. This is extracted from page.source.url.full.
www.foo.bar
page.source.url.fragmentstringstable
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.fullstringstable
The page URL of the previous page, provided in the format scheme://host[:port]/path[?query][#fragment]. This value is captured using document.referrer and may be missing or incomplete. Dynatrace can mask this field. To learn more, go to masking personal data in URIs.
https://www.foo.bar/path?q=value#dashboard;id=cff3752c-890d-4795-9955-3e1108fe3f6e;gf=all;gtf=-2h
page.source.url.pathstringstable
The URI path component of the source page URL. This is extracted from page.source.url.full.
/path
page.source.url.querystringstable
The URI query component of the source page URL. This is extracted from page.source.url.full.
q=value
page.source.url.schemestringstable
The URI scheme component of the source page URL. This is extracted from page.source.url.full.
https; http

Basic user event fields

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

New user

A new user event indicates that the end user accessed the frontend for the first time. Dynatrace RUM sends a new user event if the user state doesn't exist in the device's storage when a new user session starts.

Query

This query searches for all new user events.

fetch user.events
| filter characteristics.is_new_user

New user characteristics fields

AttributeTypeDescriptionExamples
characteristics.is_new_userbooleanexperimental
Fixed value true.
true

Basic user event fields

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

Page summary

A page represents a single HTML document and all events that occur during its lifetime. A page instance begins with each hard navigation and ends when the next document request starts or when the tab is closed. A page summary event is emitted when the page instance ends and aggregates all captured data for that page instance. Only supported by RUM JavaScript.

Query

This query searches for all page summaries.

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

Page summary characteristics fields

AttributeTypeDescriptionExamples
characteristics.has_page_summarybooleanstable
Fixed value true.
true

User action status fields

AttributeTypeDescriptionExamples
user_action.statusstringexperimental
Indicates why no corresponding user action was created for this event. Only supported by RUM JavaScript.
not_initialized

user_action.status MUST be one of the following:

ValueDescription
not_enabledThe RUM JavaScript was enabled after the onload event fired.
not_initializedThe RUM JavaScript was initialized after the onload event fired.

Page summary performance fields

AttributeTypeDescriptionExamples
performance.activation_startdurationexperimental
The time when a prerendered document is activated. The value is relative to performance.start_time. This is an experimental feature that is only available in some browsers.
0
performance.time_origintimestampexperimental
The timestamp of the beginning of the current page's lifetime in client time. The value is a UNIX Epoch time in nanoseconds.
1667469141402000000

Error fields

AttributeTypeDescriptionExamples
error.csp_violation_countlongexperimental
Display name: Error CSP violation count
The number of CSP rule violations.
1
error.dropped_exception_countlongexperimental
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_countlongexperimental
Display name: Error exception count
The total number of exceptions that are observed, including exceptions that are not captured.
1
error.http_4xx_countlongexperimental
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_countlongexperimental
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_countlongexperimental
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

Page summary page fields

AttributeTypeDescriptionExamples
page.background_timedurationstable
The aggregated time that the page was in the background.
0
page.foreground_timedurationstable
The aggregated time that the page was in the foreground.
900000000
page.prerender_timedurationstable
The aggregated time that the page was prerendering.
0

Navigation fields

AttributeTypeDescriptionExamples
navigation.typestringstable
The navigation type.
hard
navigation.tab_statestringstable
Gives additional information about the browser tab.
new

navigation.type MUST be one of the following:

ValueDescription
hardA hard navigation reloads the entire page by fetching it from the server.
softA soft navigation only updates parts of the webpage dynamically without a full reload.

navigation.tab_state MUST be one of the following:

ValueDescription
duplicatedNavigation through the browser's Duplicate Tab functionality.
existingNavigation within an existing tab.
existing_invalidNavigation 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.
newFirst navigation or navigation through the browser's Open in New Tab functionality.

Web vitals fields

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

AttributeTypeDescriptionExamples
web_vitals.largest_contentful_paintdurationstable
The Largest Contentful Paint (LCP) value.
880000000
web_vitals.first_contentful_paintdurationstable
The First Contentful Paint (FCP) value.
92000000
web_vitals.first_input_delaydurationstable
The First Input Delay (FID) value.
6000000
web_vitals.cumulative_layout_shiftdoublestable
The Cumulative Layout Shift (CLS) value.
0.1279
web_vitals.interaction_to_next_paintdurationstable
The Interaction to Next Paint (INP) value.
190000000
web_vitals.first_inputdurationstable
The First Input value.
6000000
web_vitals.first_paintdurationstable
The First Paint value.
92451200
web_vitals.time_to_first_bytedurationstable
The Time to First Byte value.
92000000

Largest Contentful Paint (LCP) fields

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

AttributeTypeDescriptionExamples
lcp.statusstringexperimental
The status information for LCP.
reported
lcp.update_countlongexperimental
The number of LCP updates during the entire lifespan.
0
lcp.start_timedoubleexperimental
The value of the LCP object's startTime property. The unit is milliseconds.
880.0
lcp.urlstringexperimental
If the element is an image, the request URL of the image.
https://www.foo.bar/images/image.png
lcp.load_timedoubleexperimental
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_timedoubleexperimental
The value of the LCP object's renderTime property (the time that the element was rendered). The unit is milliseconds.
880.0
lcp.sizelongexperimental
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.idstringexperimental
The element's ID.
productLogo
lcp.ui_element.xpathstring[]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_namestringexperimental
The element's tag name. Might be missing, for example, for element's that are inside a shadow DOM.
BUTTON
lcp.ui_element.render_delaydoubleexperimental
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_delaydoubleexperimental
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_durationdoubleexperimental
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:

ValueDescription
backgroundedLCP is not reported because the browser tab was loaded in the background.
disabledLCP is not reported because capturing of page and view summaries is disabled (only used for activity events).
not_reportedLCP is not reported because the page has no content.
not_supportedLCP is not supported by the browser.
reportedLCP is reported.

First Input Delay (FID) fields

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

AttributeTypeDescriptionExamples
fid.statusstringexperimental
The status information for FID.
not_reported
fid.loading_statestringexperimental
The document's loading state recorded at the point in time when the FID was captured.
complete
fid.start_timedoubleexperimental
The value of the FID object's startTime property. The unit is milliseconds.
13427.0
fid.durationdoubleexperimental
The value of the FID object's duration property. The unit is milliseconds.
24.0
fid.namestringexperimental
The value of the FID object's name property (the user interaction event).
click
fid.processing_startdoubleexperimental
The value of the FID object's processingStart property. The unit is milliseconds.
13433.0
fid.processing_enddoubleexperimental
The value of the FID object's processingEnd property. The unit is milliseconds.
13433.0
fid.processing_durationdoubleexperimental
How long it took for the event handler to execute. This is calculated as fid.processing_end minus fid.processing_start.
0.0
fid.cancelablebooleanexperimental
The value of the FID object's cancelable property.
true
fid.ui_element.xpathstring[]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_namestringexperimental
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:

ValueDescription
disabledFID is not reported because capturing of page and view summaries is disabled (only used for activity events).
not_reportedFID is not reported because there was no user interaction.
not_supportedFID is not supported by the browser.
reportedFID is reported.

fid.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe 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.

AttributeTypeDescriptionExamples
inp.statusstringexperimental
The status information for INP.
reported
inp.update_countlongexperimental
The number of INP updates during the entire lifespan.
0
inp.interaction_countlongexperimental
The number of interactions, during the entire lifespan, that exceed 40 milliseconds.
0
inp.loading_statestringexperimental
The document's loading state recorded at the point in time when the INP was captured.
complete
inp.start_timedoubleexperimental
The value of the INP object's startTime property. The unit is milliseconds.
13427.0
inp.durationdoubleexperimental
The value of the INP object's duration property. The unit is milliseconds.
24.0
inp.namestringexperimental
The value of the INP object's name property (the user interaction event).
click
inp.processing_startdoubleexperimental
The value of the INP object's processingStart property. The unit is milliseconds.
13433.0
inp.processing_enddoubleexperimental
The value of the INP object's processingEnd property. The unit is milliseconds.
13433.0
inp.processing_durationdoubleexperimental
How long it took for the event handler to execute. This is calculated as inp.processing_end minus inp.processing_start.
0.0
inp.cancelablebooleanexperimental
The value of the INP object's cancelable property.
true
inp.ui_element.xpathstring[]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_namestringexperimental
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:

ValueDescription
below_thresholdINP is not reported because the value is below the threshold of 40 milliseconds.
disabledINP is not reported because capturing of page and view summaries is disabled (only used for activity events).
not_reportedINP is not reported because no relevant user interaction happened.
not_supportedINP is not supported by the browser.
reportedINP is reported.

inp.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe document is still loading.

First Contentful Paint (FCP) fields

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

AttributeTypeDescriptionExamples
fcp.statusstringexperimental
The status information for FCP.
reported
fcp.loading_statestringexperimental
The document's loading state recorded at the point in time when the FCP was captured.
complete
fcp.valuedoubleexperimental
The value of the FCP object's startTime property. The unit is milliseconds.
92.0

fcp.status MUST be one of the following:

ValueDescription
backgroundedFCP is not reported because the browser tab was in the background before the value could be reported.
not_reportedFCP is not reported because no content was rendered.
not_supportedFCP is not supported by the browser.
reportedFCP is reported.

fcp.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe 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.

AttributeTypeDescriptionExamples
cls.statusstringexperimental
The status information for CLS.
not_supported
cls.update_countlongexperimental
The number of CLS updates during the entire lifespan.
0
cls.loading_statestringexperimental
The document's loading state recorded at the point in time when the CLS was captured.
complete
cls.valuedoubleexperimental
The final CLS value.
0.1279
cls.ui_element.xpathstring[]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_namestringexperimental
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_timedoubleexperimental
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_valuedoubleexperimental
The layout shift score of the element causing the largest layout shift.
0.11

cls.status MUST be one of the following:

ValueDescription
backgroundedCLS is not reported because the page was loaded in the background or backgrounded before the browser painted any content.
disabledCLS is not reported because capturing of page and view summaries is disabled (only used for activity events).
not_supportedCLS is not supported by the browser.
reportedCLS is reported.

cls.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe document is still loading.

First Paint (FP) fields

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

AttributeTypeDescriptionExamples
fp.statusstringexperimental
The status information for FP.
reported
fp.loading_statestringexperimental
The document's loading state recorded at the point in time when the FP was captured.
complete
fp.valuedoubleexperimental
The value of the FP object's startTime property (the FP value). The unit is milliseconds.
92.0

fp.status MUST be one of the following:

ValueDescription
backgroundedFP is not reported because the browser tab was in the background before the value could be reported.
not_reportedFP is not reported because no content was rendered.
not_supportedFP is not supported by the browser.
reportedFP is reported.

fp.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe document is still loading.

Time to First Byte (TTFB) fields

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

AttributeTypeDescriptionExamples
ttfb.statusstringexperimental
The status information for TTFB.
reported
ttfb.valuedoubleexperimental
The responseStart value of the navigation timing. The unit is milliseconds.
92.0
ttfb.waiting_durationdoubleexperimental
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_durationdoubleexperimental
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_durationdoubleexperimental
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_durationdoubleexperimental
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_durationdoubleexperimental
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:

ValueDescription
not_reportedTTFB is not reported by the browser.
reportedTTFB is reported.

Long task fields

AttributeTypeDescriptionExamples
long_task.statusstringexperimental
The status information for long task information.
not_supported
long_task.all.countlongexperimental
The number of all long tasks observed during the entire lifespan.
2
long_task.all.avg_durationlongexperimental
The average duration of all observed long tasks in milliseconds.
60
long_task.all.slowest_occurrencesrecord[]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.countlongexperimental
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_durationlongexperimental
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_occurrencesrecord[]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:

ValueDescription
disabledLong task information is not reported because capturing of long task summary metrics is disabled.
not_reportedLong task information is not reported because no long task was observed.
not_supportedLong tasks API is not supported by the browser.
reportedLong task information is reported.

Long animation frame summary fields

AttributeTypeDescriptionExamples
loaf.statusstringexperimental
The status of long animation frame summary information.
not_supported
loaf.countlongexperimental
The number of long animation frames observed during the entire lifespan.
2
loaf.avg_durationdoubleexperimental
The average duration of all observed long animation frames in milliseconds.
75.5
loaf.total_blocking_durationdoubleexperimental
The total blocking duration across all observed long animation frames in milliseconds.
120.3
loaf.max_blocking_durationdoubleexperimental
The maximum blocking duration of a single observed long animation frame in milliseconds.
80.1
loaf.slowest_occurrencesrecord[]experimental
The start time, duration, and blocking duration of the slowest observed long animation frames in milliseconds, including optional attribution details such as render_start, style_and_layout_start, presentation_time, script_count, has_interaction, and longest_script. The start time is relative to the user event's start_time.
{'start_time': 1234.0, 'duration': 75.5, 'blocking_duration': 45.6}; {'start_time': 1234.0, 'duration': 75.5, 'blocking_duration': None}

loaf.status MUST be one of the following:

ValueDescription
disabledLong animation frame information is not reported because capturing of long animation frame summary metrics is disabled.
not_reportedLong animation frame information is not reported because no long animation frame was observed.
not_supportedLong Animation Frames API is not supported by the browser.
reportedLong animation frame information is reported.

Basic user event fields

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

View summary

A view represents the content displayed to a user at a given time. A new view instance begins with every navigation, whether it is a hard navigation (full page load) or a soft navigation (SPA route change). A view summary event is emitted when the view instance ends and aggregates all captured data for that view instance. Only supported by RUM JavaScript.

Query

This query searches for all RUM JavaScript view summaries.

fetch user.events
| filter characteristics.has_view_summary == true
| filter dt.rum.agent.type == "javascript"

View summary characteristics fields

AttributeTypeDescriptionExamples
characteristics.has_view_summarybooleanstable
Fixed value true.
true

User action status fields

AttributeTypeDescriptionExamples
user_action.statusstringexperimental
Indicates why no corresponding user action was created for this event. Only supported by RUM JavaScript.
not_initialized

user_action.status MUST be one of the following:

ValueDescription
not_enabledThe RUM JavaScript was enabled after the onload event fired.
not_initializedThe RUM JavaScript was initialized after the onload event fired.

View summary performance fields

Only available for user events sent by RUM JavaScript.

AttributeTypeDescriptionExamples
performance.activation_startdurationexperimental
The time when a prerendered document is activated. The value is relative to performance.start_time. This is an experimental feature that is only available in some browsers.
0
performance.time_origintimestampexperimental
The timestamp of the beginning of the current page's lifetime in client time. The value is a UNIX Epoch time in nanoseconds.
1667469141402000000

Error fields

AttributeTypeDescriptionExamples
error.csp_violation_countlongexperimental
Display name: Error CSP violation count
The number of CSP rule violations.
1
error.dropped_exception_countlongexperimental
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_countlongexperimental
Display name: Error exception count
The total number of exceptions that are observed, including exceptions that are not captured.
1
error.http_4xx_countlongexperimental
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_countlongexperimental
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_countlongexperimental
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

View fields

AttributeTypeDescriptionExamples
view.background_timedurationstable
Aggregated time that the view was in the background.
0
view.foreground_timedurationstable
Aggregated time that the view was in the foreground.
900000000
view.prerender_timedurationstable
Aggregated time that the view was prerendering.
0
view.sequence_numberlongstable
The number of views throughout the page's entire lifespan.
1

Navigation fields

AttributeTypeDescriptionExamples
navigation.typestringstable
The navigation type.
hard
navigation.tab_statestringstable
Gives additional information about the browser tab.
new

navigation.type MUST be one of the following:

ValueDescription
hardA hard navigation reloads the entire page by fetching it from the server.
softA soft navigation only updates parts of the webpage dynamically without a full reload.

navigation.tab_state MUST be one of the following:

ValueDescription
duplicatedNavigation through the browser's Duplicate Tab functionality.
existingNavigation within an existing tab.
existing_invalidNavigation 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.
newFirst navigation or navigation through the browser's Open in New Tab functionality.

Web vitals fields

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

AttributeTypeDescriptionExamples
web_vitals.largest_contentful_paintdurationstable
The Largest Contentful Paint (LCP) value.
880000000
web_vitals.first_contentful_paintdurationstable
The First Contentful Paint (FCP) value.
92000000
web_vitals.first_input_delaydurationstable
The First Input Delay (FID) value.
6000000
web_vitals.cumulative_layout_shiftdoublestable
The Cumulative Layout Shift (CLS) value.
0.1279
web_vitals.interaction_to_next_paintdurationstable
The Interaction to Next Paint (INP) value.
190000000
web_vitals.first_inputdurationstable
The First Input value.
6000000
web_vitals.first_paintdurationstable
The First Paint value.
92451200
web_vitals.time_to_first_bytedurationstable
The Time to First Byte value.
92000000

Largest Contentful Paint (LCP) fields

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

AttributeTypeDescriptionExamples
lcp.statusstringexperimental
The status information for LCP.
reported
lcp.update_countlongexperimental
The number of LCP updates during the entire lifespan.
0
lcp.start_timedoubleexperimental
The value of the LCP object's startTime property. The unit is milliseconds.
880.0
lcp.urlstringexperimental
If the element is an image, the request URL of the image.
https://www.foo.bar/images/image.png
lcp.load_timedoubleexperimental
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_timedoubleexperimental
The value of the LCP object's renderTime property (the time that the element was rendered). The unit is milliseconds.
880.0
lcp.sizelongexperimental
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.idstringexperimental
The element's ID.
productLogo
lcp.ui_element.xpathstring[]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_namestringexperimental
The element's tag name. Might be missing, for example, for element's that are inside a shadow DOM.
BUTTON
lcp.ui_element.render_delaydoubleexperimental
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_delaydoubleexperimental
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_durationdoubleexperimental
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:

ValueDescription
backgroundedLCP is not reported because the browser tab was loaded in the background.
disabledLCP is not reported because capturing of page and view summaries is disabled (only used for activity events).
not_reportedLCP is not reported because the page has no content.
not_supportedLCP is not supported by the browser.
reportedLCP is reported.

First Input Delay (FID) fields

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

AttributeTypeDescriptionExamples
fid.statusstringexperimental
The status information for FID.
not_reported
fid.loading_statestringexperimental
The document's loading state recorded at the point in time when the FID was captured.
complete
fid.start_timedoubleexperimental
The value of the FID object's startTime property. The unit is milliseconds.
13427.0
fid.durationdoubleexperimental
The value of the FID object's duration property. The unit is milliseconds.
24.0
fid.namestringexperimental
The value of the FID object's name property (the user interaction event).
click
fid.processing_startdoubleexperimental
The value of the FID object's processingStart property. The unit is milliseconds.
13433.0
fid.processing_enddoubleexperimental
The value of the FID object's processingEnd property. The unit is milliseconds.
13433.0
fid.processing_durationdoubleexperimental
How long it took for the event handler to execute. This is calculated as fid.processing_end minus fid.processing_start.
0.0
fid.cancelablebooleanexperimental
The value of the FID object's cancelable property.
true
fid.ui_element.xpathstring[]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_namestringexperimental
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:

ValueDescription
disabledFID is not reported because capturing of page and view summaries is disabled (only used for activity events).
not_reportedFID is not reported because there was no user interaction.
not_supportedFID is not supported by the browser.
reportedFID is reported.

fid.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe 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.

AttributeTypeDescriptionExamples
inp.statusstringexperimental
The status information for INP.
reported
inp.update_countlongexperimental
The number of INP updates during the entire lifespan.
0
inp.interaction_countlongexperimental
The number of interactions, during the entire lifespan, that exceed 40 milliseconds.
0
inp.loading_statestringexperimental
The document's loading state recorded at the point in time when the INP was captured.
complete
inp.start_timedoubleexperimental
The value of the INP object's startTime property. The unit is milliseconds.
13427.0
inp.durationdoubleexperimental
The value of the INP object's duration property. The unit is milliseconds.
24.0
inp.namestringexperimental
The value of the INP object's name property (the user interaction event).
click
inp.processing_startdoubleexperimental
The value of the INP object's processingStart property. The unit is milliseconds.
13433.0
inp.processing_enddoubleexperimental
The value of the INP object's processingEnd property. The unit is milliseconds.
13433.0
inp.processing_durationdoubleexperimental
How long it took for the event handler to execute. This is calculated as inp.processing_end minus inp.processing_start.
0.0
inp.cancelablebooleanexperimental
The value of the INP object's cancelable property.
true
inp.ui_element.xpathstring[]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_namestringexperimental
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:

ValueDescription
below_thresholdINP is not reported because the value is below the threshold of 40 milliseconds.
disabledINP is not reported because capturing of page and view summaries is disabled (only used for activity events).
not_reportedINP is not reported because no relevant user interaction happened.
not_supportedINP is not supported by the browser.
reportedINP is reported.

inp.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe document is still loading.

First Contentful Paint (FCP) fields

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

AttributeTypeDescriptionExamples
fcp.statusstringexperimental
The status information for FCP.
reported
fcp.loading_statestringexperimental
The document's loading state recorded at the point in time when the FCP was captured.
complete
fcp.valuedoubleexperimental
The value of the FCP object's startTime property. The unit is milliseconds.
92.0

fcp.status MUST be one of the following:

ValueDescription
backgroundedFCP is not reported because the browser tab was in the background before the value could be reported.
not_reportedFCP is not reported because no content was rendered.
not_supportedFCP is not supported by the browser.
reportedFCP is reported.

fcp.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe 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.

AttributeTypeDescriptionExamples
cls.statusstringexperimental
The status information for CLS.
not_supported
cls.update_countlongexperimental
The number of CLS updates during the entire lifespan.
0
cls.loading_statestringexperimental
The document's loading state recorded at the point in time when the CLS was captured.
complete
cls.valuedoubleexperimental
The final CLS value.
0.1279
cls.ui_element.xpathstring[]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_namestringexperimental
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_timedoubleexperimental
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_valuedoubleexperimental
The layout shift score of the element causing the largest layout shift.
0.11

cls.status MUST be one of the following:

ValueDescription
backgroundedCLS is not reported because the page was loaded in the background or backgrounded before the browser painted any content.
disabledCLS is not reported because capturing of page and view summaries is disabled (only used for activity events).
not_supportedCLS is not supported by the browser.
reportedCLS is reported.

cls.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe document is still loading.

First Paint (FP) fields

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

AttributeTypeDescriptionExamples
fp.statusstringexperimental
The status information for FP.
reported
fp.loading_statestringexperimental
The document's loading state recorded at the point in time when the FP was captured.
complete
fp.valuedoubleexperimental
The value of the FP object's startTime property (the FP value). The unit is milliseconds.
92.0

fp.status MUST be one of the following:

ValueDescription
backgroundedFP is not reported because the browser tab was in the background before the value could be reported.
not_reportedFP is not reported because no content was rendered.
not_supportedFP is not supported by the browser.
reportedFP is reported.

fp.loading_state MUST be one of the following:

ValueDescription
completeThe document and all sub-resources have finished loading.
dom_content_loadedThe 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_interactiveThe document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still loading.
loadingThe document is still loading.

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

Time to First Byte (TTFB) fields

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

AttributeTypeDescriptionExamples
ttfb.statusstringexperimental
The status information for TTFB.
reported
ttfb.valuedoubleexperimental
The responseStart value of the navigation timing. The unit is milliseconds.
92.0
ttfb.waiting_durationdoubleexperimental
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_durationdoubleexperimental
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_durationdoubleexperimental
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_durationdoubleexperimental
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_durationdoubleexperimental
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:

ValueDescription
not_reportedTTFB is not reported by the browser.
reportedTTFB is reported.

Long task fields

AttributeTypeDescriptionExamples
long_task.statusstringexperimental
The status information for long task information.
not_supported
long_task.all.countlongexperimental
The number of all long tasks observed during the entire lifespan.
2
long_task.all.avg_durationlongexperimental
The average duration of all observed long tasks in milliseconds.
60
long_task.all.slowest_occurrencesrecord[]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.countlongexperimental
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_durationlongexperimental
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_occurrencesrecord[]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:

ValueDescription
disabledLong task information is not reported because capturing of long task summary metrics is disabled.
not_reportedLong task information is not reported because no long task was observed.
not_supportedLong tasks API is not supported by the browser.
reportedLong task information is reported.

Long animation frame summary fields

AttributeTypeDescriptionExamples
loaf.statusstringexperimental
The status of long animation frame summary information.
not_supported
loaf.countlongexperimental
The number of long animation frames observed during the entire lifespan.
2
loaf.avg_durationdoubleexperimental
The average duration of all observed long animation frames in milliseconds.
75.5
loaf.total_blocking_durationdoubleexperimental
The total blocking duration across all observed long animation frames in milliseconds.
120.3
loaf.max_blocking_durationdoubleexperimental
The maximum blocking duration of a single observed long animation frame in milliseconds.
80.1
loaf.slowest_occurrencesrecord[]experimental
The start time, duration, and blocking duration of the slowest observed long animation frames in milliseconds, including optional attribution details such as render_start, style_and_layout_start, presentation_time, script_count, has_interaction, and longest_script. The start time is relative to the user event's start_time.
{'start_time': 1234.0, 'duration': 75.5, 'blocking_duration': 45.6}; {'start_time': 1234.0, 'duration': 75.5, 'blocking_duration': None}

loaf.status MUST be one of the following:

ValueDescription
disabledLong animation frame information is not reported because capturing of long animation frame summary metrics is disabled.
not_reportedLong animation frame information is not reported because no long animation frame was observed.
not_supportedLong Animation Frames API is not supported by the browser.
reportedLong animation frame information is reported.

Basic user event fields

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

Visibility change

A visibility change event is captured whenever the page transitions between foreground (visible) and background (hidden or minimized) states. Supported by RUM JavaScript. For OneAgent for Mobile, visibility state changes are captured as part of navigation events.

Query

This query searches for all visibility changes.

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

Visibility change characteristics fields

Only available for user events sent by RUM JavaScript.

AttributeTypeDescriptionExamples
characteristics.has_visibility_changebooleanstable
Fixed value true.
true

Visibility fields

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

AttributeTypeDescriptionExamples
visibility.statestringstable
The visibility state.
foreground

visibility.state MUST be one of the following:

ValueDescription
backgroundThe application or browser tab is in the background and the content is not visible to the user.
foregroundThe application or browser tab is in the foreground and the content is at least partially visible.
prerenderingThe content is in the process of prerendering. Only supported by RUM JavaScript. Not applicable to visibility change events.
unknownThe visibility state of the user event cannot be determined. Only used by RUM JavaScript.

Visibility change performance fields

Only available for user events sent by RUM JavaScript.

AttributeTypeDescriptionExamples
performance.time_origintimestampexperimental
The timestamp of the beginning of the current page's lifetime in client time. The value is a UNIX Epoch time in nanoseconds.
1667469141402000000

Visibility change DOM event fields

Only available for user events sent by RUM JavaScript.

AttributeTypeDescriptionExamples
dom_event.is_trustedbooleanexperimental
Interaction is genuine from real user and not a synthetic event.
true

Basic user event fields

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