Navigation-related events encompass navigations, app starts, visibility changes, as well as page and view summary events. These events capture information about how users navigate through the application.
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.
This query searches for all application starts.
fetch user.events| filter characteristics.has_app_start == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalFixed value |
|
| boolean | stableFixed value |
|
| boolean | stableFixed value |
|
| boolean | stableOptional value |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe type of app start. |
|
| duration | experimentalThe start time of the App Start. The value is relative to |
|
| duration | experimentalThe end time of the App Start. The value is relative to |
|
app_start.type MUST be one of the following:
| Value | Description |
|---|---|
| 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. |
| 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. |
| 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 |
|---|---|---|---|
| duration | experimentalThe start time of the phase from |
|
| duration | experimentalThe end time of the phase from |
|
| duration | experimentalThe start time of the phase from |
|
| duration | experimentalThe end time of the phase from |
|
| duration | experimentalThe start time of the phase from |
|
| duration | experimentalThe end time of the phase from |
|
| duration | experimentalThe start time for phase going from |
|
| duration | experimentalThe end time for phase going from |
|
OneAgent for Mobile sends native iOS and cross platform app start attributes in a single event for cross platform implementations.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | experimentalThe start time for the system interface phase, which goes from |
|
| duration | experimentalThe end time for the system interface phase, which goes from |
|
| duration | experimentalThe start time for the runtime init phase, which goes from |
|
| duration | experimentalThe end time for the runtime init phase, which goes from |
|
| duration | experimentalThe start time for the UIKit init phase, which goes from |
|
| duration | experimentalThe end time for the UIKit init phase, which goes from |
|
| duration | experimentalThe start time for application init phase, which goes from |
|
| duration | experimentalThe end time for application init phase, which goes from |
|
| duration | experimentalThe start time for initial frame renderer phase, which goes from |
|
| duration | experimentalThe end time for the initial frame renderer phase, which goes from |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | experimentalThe start time for the Flutter engine initialization phase, which triggers the init of the Dynatrace plugin. The value is relative to |
|
| duration | experimentalThe end time for the Flutter engine initialization phase, which triggers the init of the Dynatrace plugin. The value is relative to |
|
| duration | experimentalThe start time for the main init phase, which includes the main function call and Dynatrace functionality setup. The value is relative to |
|
| duration | experimentalThe end time for the main init phase, which includes the main function call and Dynatrace functionality setup. The value is relative to |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | experimentalThe point in time when the bridge is started, essentially when a load or reload happens. The value is relative to |
|
| duration | experimentalOnly available in development. The start time of the development bundle download phase. The value is relative to |
|
| duration | experimentalOnly available in development. The end time of the development bundle download phase. The value is relative to |
|
| duration | experimentalThe start time for the React Native JavaScript bundle loading phase. The value is relative to |
|
| duration | experimentalThe end time for the React Native JavaScript bundle loading phase. The value is relative to |
|
| duration | experimentalThe point in time when the initial component is mounted. The value is relative to |
|
The basic attributes for all user events are defined in the user event base model.
A navigation event marks the transition to a new view. Supported by RUM JavaScript and OneAgent for Mobile.
This query searches for all navigation events.
fetch user.events| filter characteristics.has_navigation
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalFixed value |
|
| boolean | stableFixed value |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalIndicates why no corresponding user action was created for this event. Only available for hard navigations and only supported by RUM JavaScript. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe navigation type. |
|
| string | experimentalGives additional information about the browser tab. |
|
navigation.type MUST be one of the following:
| Value | Description |
|---|---|
| A hard navigation reloads the entire page by fetching it from the server. |
| A soft navigation only updates parts of the webpage dynamically without a full reload. |
navigation.tab_state MUST be one of the following:
| Value | Description |
|---|---|
| Navigation through the browser's |
| Navigation within an existing tab. |
| 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. |
| First navigation or navigation through the browser's |
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | experimentalThe number of views throughout the page's lifespan up to now. This is incremented consecutively with each navigation. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe URI host component of the source page URL. This is extracted from |
|
| string | experimentalThe URI fragment component of the source page URL. This is extracted from |
|
| string | experimentalThe page URL of the previous page, provided in the format |
|
| string | experimentalThe URI path component of the source page URL. This is extracted from |
|
| string | experimentalThe URI query component of the source page URL. This is extracted from |
|
| string | experimentalThe URI scheme component of the source page URL. This is extracted from |
|
The basic attributes for all user events are defined in the user event base model.
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.
This query searches for all page summaries.
fetch user.events| filter characteristics.has_page_summary == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalFixed value |
|
| boolean | stableFixed value |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalIndicates why no corresponding user action was created for this event. Only supported by RUM JavaScript. |
|
user_action.status MUST be one of the following:
| Value | Description |
|---|---|
| The RUM JavaScript was enabled after the |
| The RUM JavaScript was initialized after the |
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | experimentalThe time when a prerendered document is activated. The value is relative to |
|
| timestamp | experimentalThe timestamp of the beginning of the current page's lifetime in client time. The value is a UNIX Epoch time in nanoseconds. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | experimentalThe number of CSP rule violations. |
|
| long | experimentalThe number of exceptions that are observed, but which are not captured due to error capture limits. |
|
| long | experimentalThe total number of exceptions that are observed, including exceptions that are not captured. |
|
| long | experimentalThe number of HTTP request errors with an |
|
| long | experimentalThe number of HTTP request errors with an |
|
| long | experimentalThe number of HTTP request errors with an |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | experimentalThe aggregated time that the page was in the background. |
|
| duration | experimentalThe aggregated time that the page was in the foreground. |
|
| duration | experimentalThe aggregated time that the page was prerendering. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe navigation type. |
|
| string | experimentalGives additional information about the browser tab. |
|
navigation.type MUST be one of the following:
| Value | Description |
|---|---|
| A hard navigation reloads the entire page by fetching it from the server. |
| A soft navigation only updates parts of the webpage dynamically without a full reload. |
navigation.tab_state MUST be one of the following:
| Value | Description |
|---|---|
| Navigation through the browser's |
| Navigation within an existing tab. |
| 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. |
| First navigation or navigation through the browser's |
The web vitals fields contain the web vitals attributes captured by Dynatrace RUM. Only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | stableThe |
|
| duration | stableThe |
|
| duration | stableThe |
|
| double | stableThe |
|
| duration | stableThe |
|
| duration | stableThe |
|
| duration | stableThe |
|
| duration | stableThe |
|
The Largest Contentful Paint (LCP) attributes contain additional information about the captured web_vitals.largest_contentful_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe status information for LCP. |
|
| long | experimentalThe number of LCP updates during the entire lifespan. |
|
| double | experimentalThe value of the LCP object's |
|
| string | experimentalIf the element is an image, the request URL of the image. |
|
| double | experimentalThe value of the LCP object's |
|
| double | experimentalThe value of the LCP object's |
|
| long | experimentalThe intrinsic size of the element representing its area on the screen. The value is equal to the element's width multiplied by its height, in pixels. |
|
| string | experimentalThe element's ID. |
|
| string[] | experimentalThe element's xpath. Might be missing, for example, for element's that are inside a shadow DOM. |
|
| string | experimentalThe element's tag name. Might be missing, for example, for element's that are inside a shadow DOM. |
|
| double | experimentalThe element's render delay, that is the time between when the element finishes loading and when it is fully rendered. The unit is milliseconds. Only available if a resource timing is available for the element. |
|
| double | experimentalThe resource's load delay, that is the time between |
|
| double | experimentalThe resource's load duration, that is the total time it takes to load the resource. The unit is milliseconds. Only available if a resource timing is available for the resource. |
|
lcp.status MUST be one of the following:
| Value | Description |
|---|---|
| LCP is not reported because the browser tab was loaded in the background. |
| LCP is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| LCP is not reported because the browser tab was in the background before the value could be 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 |
|---|---|---|---|
| string | experimentalThe status information for FID. |
|
| string | experimentalThe document's loading state recorded at the point in time when the FID was captured. |
|
| double | experimentalThe value of the FID object's |
|
| double | experimentalThe value of the FID object's |
|
| string | experimentalThe value of the FID object's |
|
| double | experimentalThe value of the FID object's |
|
| double | experimentalThe value of the FID object's |
|
| double | experimentalHow long it took for the event handler to execute. This is calculated as |
|
| boolean | experimentalThe value of the FID object's |
|
| string[] | experimentalThe element's xpath. Might be missing, for example, for element's that are inside a shadow DOM. |
|
| string | experimentalThe element's tag name. Might be missing, for example, for element's that are inside a shadow DOM. |
|
fid.status MUST be one of the following:
| Value | Description |
|---|---|
| FID is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| FID is not reported because there was no user interaction. |
| FID is not supported by the browser. |
| FID is reported. |
fid.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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 |
|---|---|---|---|
| string | experimentalThe status information for INP. |
|
| long | experimentalThe number of INP updates during the entire lifespan. |
|
| long | experimentalThe number of interactions, during the entire lifespan, that exceed 40 milliseconds. |
|
| string | experimentalThe document's loading state recorded at the point in time when the INP was captured. |
|
| double | experimentalThe value of the INP object's |
|
| double | experimentalThe value of the INP object's |
|
| string | experimentalThe value of the INP object's |
|
| double | experimentalThe value of the INP object's |
|
| double | experimentalThe value of the INP object's |
|
| double | experimentalHow long it took for the event handler to execute. This is calculated as |
|
| boolean | experimentalThe value of the INP object's |
|
| string[] | experimentalThe element's xpath. Might be missing, for example, for element's that are inside a shadow DOM. |
|
| string | experimentalThe element's tag name. Might be missing, for example, for element's that are inside a shadow DOM. |
|
inp.status MUST be one of the following:
| Value | Description |
|---|---|
| INP is not reported because the value is below the threshold of 40 milliseconds. |
| INP is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| INP is not reported because no relevant user interaction happened. |
| INP is not supported by the browser. |
| INP is reported. |
inp.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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 |
|---|---|---|---|
| string | experimentalThe status information for FCP. |
|
| string | experimentalThe document's loading state recorded at the point in time when the FCP was captured. |
|
| double | experimentalThe value of the FCP object's |
|
fcp.status MUST be one of the following:
| Value | Description |
|---|---|
| FCP is not reported because the browser tab was in the background before the value could be reported. |
| FCP is not reported because no content was rendered. |
| FCP is not supported by the browser. |
| FCP is reported. |
fcp.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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 |
|---|---|---|---|
| string | experimentalThe status information for CLS. |
|
| long | experimentalThe number of CLS updates during the entire lifespan. |
|
| string | experimentalThe document's loading state recorded at the point in time when the CLS was captured. |
|
| double | experimentalThe final CLS value. |
|
| string[] | experimentalThe xpath of the element causing the largest layout shift. Might be missing, for example, for elements that are inside a shadow DOM. |
|
| string | experimentalThe tag name of the element causing the largest layout shift. Might be missing, for example, for elements that are inside a shadow DOM. |
|
| double | experimentalThe time when the largest layout shift occurred. The value is relative to |
|
| double | experimentalThe layout shift score of the element causing the largest layout shift. |
|
cls.status MUST be one of the following:
| Value | Description |
|---|---|
| CLS is not reported because the page was loaded in the background or backgrounded before the browser painted any content. |
| CLS is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| CLS is not supported by the browser. |
| CLS is reported. |
cls.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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 |
|---|---|---|---|
| string | experimentalThe status information for FP. |
|
| string | experimentalThe document's loading state recorded at the point in time when the FP was captured. |
|
| double | experimentalThe value of the FP object's |
|
fp.status MUST be one of the following:
| Value | Description |
|---|---|
| FP is not reported because the browser tab was in the background before the value could be reported. |
| FP is not reported because no content was rendered. |
| FP is not supported by the browser. |
| FP is reported. |
fp.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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 |
|---|---|---|---|
| string | experimentalThe status information for TTFB. |
|
| double | experimentalThe |
|
| double | experimentalThe total time from when the user initiates loading to when the navigation request is handled, that is the |
|
| double | experimentalThe total time spent checking the HTTP cache for a match, that is the |
|
| double | experimentalThe total time to resolve the DNS for the requested domain, that is the |
|
| double | experimentalThe total time to create the connection to the requested domain, that is the |
|
| double | experimentalThe total time from when the request was sent until the first byte of the response was received, that is the |
|
ttfb.status MUST be one of the following:
| Value | Description |
|---|---|
| TTFB is not reported by the browser. |
| TTFB is reported. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe status information for long task information. |
|
| long | experimentalThe number of all long tasks observed during the entire lifespan. |
|
| long | experimentalThe average duration of all observed long tasks in milliseconds. |
|
| record[] | experimentalThe start time and the duration of the slowest observed long tasks in milliseconds. The start time is relative to the user event's |
|
| long | experimentalThe number of long tasks from the same browser context or frame observed during the entire lifespan. Only long tasks with |
|
| long | experimentalThe average duration of the observed long tasks from the same browser context or frame in milliseconds. Only long tasks with |
|
| record[] | experimentalThe 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 |
|
long_task.status MUST be one of the following:
| Value | Description |
|---|---|
| Long task information is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| Long task information is not reported because no long task was observed. |
| Long tasks API is not supported by the browser. |
| Long task information is reported. |
The basic attributes for all user events are defined in the user event base model.
A view represents the content displayed to a user at a given time. On web, a new view instance begins with every navigation, whether it is a hard navigation (full page load) or a soft navigation (SPA route change). On mobile, a view corresponds to a distinct screen displayed to the user. A view summary event is emitted when the view instance ends and aggregates all captured data for that view instance. Supported by RUM JavaScript and OneAgent for Mobile.
This query searches for all view summaries.
fetch user.events| filter characteristics.has_view_summary == true
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalFixed value |
|
| boolean | stableFixed value |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalIndicates why no corresponding user action was created for this event. Only supported by RUM JavaScript. |
|
user_action.status MUST be one of the following:
| Value | Description |
|---|---|
| The RUM JavaScript was enabled after the |
| The RUM JavaScript was initialized after the |
Only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | experimentalThe time when a prerendered document is activated. The value is relative to |
|
| timestamp | experimentalThe timestamp of the beginning of the current page's lifetime in client time. The value is a UNIX Epoch time in nanoseconds. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | experimentalThe number of CSP rule violations. |
|
| long | experimentalThe number of exceptions that are observed, but which are not captured due to error capture limits. |
|
| long | experimentalThe total number of exceptions that are observed, including exceptions that are not captured. |
|
| long | experimentalThe number of HTTP request errors with an |
|
| long | experimentalThe number of HTTP request errors with an |
|
| long | experimentalThe number of HTTP request errors with an |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | experimentalAggregated time that the view was in the background. |
|
| duration | experimentalAggregated time that the view was in the foreground. |
|
| duration | experimentalAggregated time that the view was prerendering. |
|
| long | experimentalThe number of views throughout the page's entire lifespan. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe navigation type. |
|
| string | experimentalGives additional information about the browser tab. |
|
navigation.type MUST be one of the following:
| Value | Description |
|---|---|
| A hard navigation reloads the entire page by fetching it from the server. |
| A soft navigation only updates parts of the webpage dynamically without a full reload. |
navigation.tab_state MUST be one of the following:
| Value | Description |
|---|---|
| Navigation through the browser's |
| Navigation within an existing tab. |
| 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. |
| First navigation or navigation through the browser's |
The web vitals fields contain the web vitals attributes captured by Dynatrace RUM. Only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | stableThe |
|
| duration | stableThe |
|
| duration | stableThe |
|
| double | stableThe |
|
| duration | stableThe |
|
| duration | stableThe |
|
| duration | stableThe |
|
| duration | stableThe |
|
The Largest Contentful Paint (LCP) attributes contain additional information about the captured web_vitals.largest_contentful_paint.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe status information for LCP. |
|
| long | experimentalThe number of LCP updates during the entire lifespan. |
|
| double | experimentalThe value of the LCP object's |
|
| string | experimentalIf the element is an image, the request URL of the image. |
|
| double | experimentalThe value of the LCP object's |
|
| double | experimentalThe value of the LCP object's |
|
| long | experimentalThe intrinsic size of the element representing its area on the screen. The value is equal to the element's width multiplied by its height, in pixels. |
|
| string | experimentalThe element's ID. |
|
| string[] | experimentalThe element's xpath. Might be missing, for example, for element's that are inside a shadow DOM. |
|
| string | experimentalThe element's tag name. Might be missing, for example, for element's that are inside a shadow DOM. |
|
| double | experimentalThe element's render delay, that is the time between when the element finishes loading and when it is fully rendered. The unit is milliseconds. Only available if a resource timing is available for the element. |
|
| double | experimentalThe resource's load delay, that is the time between |
|
| double | experimentalThe resource's load duration, that is the total time it takes to load the resource. The unit is milliseconds. Only available if a resource timing is available for the resource. |
|
lcp.status MUST be one of the following:
| Value | Description |
|---|---|
| LCP is not reported because the browser tab was loaded in the background. |
| LCP is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| LCP is not reported because the browser tab was in the background before the value could be 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 |
|---|---|---|---|
| string | experimentalThe status information for FID. |
|
| string | experimentalThe document's loading state recorded at the point in time when the FID was captured. |
|
| double | experimentalThe value of the FID object's |
|
| double | experimentalThe value of the FID object's |
|
| string | experimentalThe value of the FID object's |
|
| double | experimentalThe value of the FID object's |
|
| double | experimentalThe value of the FID object's |
|
| double | experimentalHow long it took for the event handler to execute. This is calculated as |
|
| boolean | experimentalThe value of the FID object's |
|
| string[] | experimentalThe element's xpath. Might be missing, for example, for element's that are inside a shadow DOM. |
|
| string | experimentalThe element's tag name. Might be missing, for example, for element's that are inside a shadow DOM. |
|
fid.status MUST be one of the following:
| Value | Description |
|---|---|
| FID is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| FID is not reported because there was no user interaction. |
| FID is not supported by the browser. |
| FID is reported. |
fid.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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 |
|---|---|---|---|
| string | experimentalThe status information for INP. |
|
| long | experimentalThe number of INP updates during the entire lifespan. |
|
| long | experimentalThe number of interactions, during the entire lifespan, that exceed 40 milliseconds. |
|
| string | experimentalThe document's loading state recorded at the point in time when the INP was captured. |
|
| double | experimentalThe value of the INP object's |
|
| double | experimentalThe value of the INP object's |
|
| string | experimentalThe value of the INP object's |
|
| double | experimentalThe value of the INP object's |
|
| double | experimentalThe value of the INP object's |
|
| double | experimentalHow long it took for the event handler to execute. This is calculated as |
|
| boolean | experimentalThe value of the INP object's |
|
| string[] | experimentalThe element's xpath. Might be missing, for example, for element's that are inside a shadow DOM. |
|
| string | experimentalThe element's tag name. Might be missing, for example, for element's that are inside a shadow DOM. |
|
inp.status MUST be one of the following:
| Value | Description |
|---|---|
| INP is not reported because the value is below the threshold of 40 milliseconds. |
| INP is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| INP is not reported because no relevant user interaction happened. |
| INP is not supported by the browser. |
| INP is reported. |
inp.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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 |
|---|---|---|---|
| string | experimentalThe status information for FCP. |
|
| string | experimentalThe document's loading state recorded at the point in time when the FCP was captured. |
|
| double | experimentalThe value of the FCP object's |
|
fcp.status MUST be one of the following:
| Value | Description |
|---|---|
| FCP is not reported because the browser tab was in the background before the value could be reported. |
| FCP is not reported because no content was rendered. |
| FCP is not supported by the browser. |
| FCP is reported. |
fcp.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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 |
|---|---|---|---|
| string | experimentalThe status information for CLS. |
|
| long | experimentalThe number of CLS updates during the entire lifespan. |
|
| string | experimentalThe document's loading state recorded at the point in time when the CLS was captured. |
|
| double | experimentalThe final CLS value. |
|
| string[] | experimentalThe xpath of the element causing the largest layout shift. Might be missing, for example, for elements that are inside a shadow DOM. |
|
| string | experimentalThe tag name of the element causing the largest layout shift. Might be missing, for example, for elements that are inside a shadow DOM. |
|
| double | experimentalThe time when the largest layout shift occurred. The value is relative to |
|
| double | experimentalThe layout shift score of the element causing the largest layout shift. |
|
cls.status MUST be one of the following:
| Value | Description |
|---|---|
| CLS is not reported because the page was loaded in the background or backgrounded before the browser painted any content. |
| CLS is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| CLS is not supported by the browser. |
| CLS is reported. |
cls.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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 |
|---|---|---|---|
| string | experimentalThe status information for FP. |
|
| string | experimentalThe document's loading state recorded at the point in time when the FP was captured. |
|
| double | experimentalThe value of the FP object's |
|
fp.status MUST be one of the following:
| Value | Description |
|---|---|
| FP is not reported because the browser tab was in the background before the value could be reported. |
| FP is not reported because no content was rendered. |
| FP is not supported by the browser. |
| FP is reported. |
fp.loading_state MUST be one of the following:
| Value | Description |
|---|---|
| The document and all sub-resources have finished loading. |
| 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. |
| The document has finished loading and the document has been parsed but sub-resources such as scripts, images, stylesheets, and frames are still 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.
The Time to First Byte (TTFB) attributes contain additional information about the captured web_vitals.time_to_first_byte.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe status information for TTFB. |
|
| double | experimentalThe |
|
| double | experimentalThe total time from when the user initiates loading to when the navigation request is handled, that is the |
|
| double | experimentalThe total time spent checking the HTTP cache for a match, that is the |
|
| double | experimentalThe total time to resolve the DNS for the requested domain, that is the |
|
| double | experimentalThe total time to create the connection to the requested domain, that is the |
|
| double | experimentalThe total time from when the request was sent until the first byte of the response was received, that is the |
|
ttfb.status MUST be one of the following:
| Value | Description |
|---|---|
| TTFB is not reported by the browser. |
| TTFB is reported. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe status information for long task information. |
|
| long | experimentalThe number of all long tasks observed during the entire lifespan. |
|
| long | experimentalThe average duration of all observed long tasks in milliseconds. |
|
| record[] | experimentalThe start time and the duration of the slowest observed long tasks in milliseconds. The start time is relative to the user event's |
|
| long | experimentalThe number of long tasks from the same browser context or frame observed during the entire lifespan. Only long tasks with |
|
| long | experimentalThe average duration of the observed long tasks from the same browser context or frame in milliseconds. Only long tasks with |
|
| record[] | experimentalThe 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 |
|
long_task.status MUST be one of the following:
| Value | Description |
|---|---|
| Long task information is not reported because capturing of page and view summaries is disabled (only used for activity events). |
| Long task information is not reported because no long task was observed. |
| Long tasks API is not supported by the browser. |
| Long task information is reported. |
The basic attributes for all user events are defined in the user event base model.
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.
This query searches for all visibility changes.
fetch user.events| filter characteristics.has_visibility_change == true
Only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalFixed value |
|
| boolean | stableFixed value |
|
Visibility attributes are only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe visibility state. |
|
visibility.state MUST be one of the following:
| Value | Description |
|---|---|
| The application or browser tab is in the background and the content is not visible to the user. |
| The application or browser tab is in the foreground and the content is at least partially visible. |
| The content is in the process of prerendering. Only supported by RUM JavaScript. Not applicable to visibility change events. |
| 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 |
|---|---|---|---|
| timestamp | experimentalThe timestamp of the beginning of the current page's lifetime in client time. The value is a UNIX Epoch time in nanoseconds. |
|
Only available for user events sent by RUM JavaScript.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| boolean | experimentalInteraction is genuine from real user and not a synthetic event. |
|
The basic attributes for all user events are defined in the user event base model.