Request user events capture network requests made during user interactions, including details about third-party content requests and service calls.
Semantic conventions for request events captured on the client in Dynatrace RUM.
This query searches for all request user events.
fetch user.events| filter characteristics.has_request == true
This query searches for all failed requests.
fetch user.events| filter characteristics.has_failed_request == true
RUM JavaScript doesn't capture data URL requests.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalIn case the request failed, |
|
| boolean | stableAdditional error characteristic: If set to |
|
| boolean | stablePrimary characteristic: If set to |
|
| boolean | stableAdditional error characteristic: If set to |
|
| boolean | stableAdditional error characteristic: If set to |
|
| boolean | stablePrimary characteristic: If set to |
|
| boolean | stableFixed value |
|
| boolean | stableAdditional request characteristic: If set to |
|
| boolean | stableAdditional request characteristic: If set to |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalOSI Application Layer or non-OSI equivalent. This is a mandatory field for request user events. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe URI domain component. This is extracted from |
|
| string | experimentalThe URI fragment component. This is extracted from |
|
| string | experimentalAbsolute URL describing a network resource according to RFC3986. OneAgent for Mobile removes the optional user information subcomponent. This is a mandatory field for request user events.Tags: |
|
| string | experimentalThe URI path component. This is extracted from |
|
| string | experimentalThe provider type for the host name of |
|
| string | experimentalThe URI query component. This is extracted from |
|
| string | experimentalThe URI scheme component identifying the used protocol. This is extracted from |
|
Only available for HTTP requests.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalHTTP request method. |
|
| string | experimentalThe HTTP reason phrase (HTTP1 only). |
|
| long | experimentalHTTP response status code. |
|
Only available for WebSocket connection request events sent by OneAgent for Mobile.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | experimentalThe WebSocket connection status code. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| uid | experimentalA unique identifier for a span within a trace. The |
|
| uid | experimentalA unique identifier for a trace. The |
|
| boolean | experimentalFlag indicating whether the trace was recorded. If set to |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalIndicates if and why Dynatrace RUM set the W3C Trace Context headers on the request. |
|
| string | experimentalIndicates if and why RUM JavaScript received trace information from OneAgent via the browser's performance API ( |
|
request.trace_context_hint MUST be one of the following:
| Value | Description |
|---|---|
| Trace Context headers were set using the Dyntrace API. |
| Trace Context headers were not set in the customer code using the Dyntrace API, therefore it's expected that the header is not set. |
| Trace Context headers were not set because the request is a cross-origin request. |
| Trace Context headers were not set for the request because the feature is disabled. |
| Trace Context headers were not set because the request is excluded by configuration. |
| Trace Context headers were not set because the |
| Trace Context headers were set based on the request's |
| Trace Context headers were set because the request is included by configuration. |
| Dynatrace RUM generated new and replaced the existing Trace Context headers because the existing |
| Trace Context headers were not set because the maximum length for the tracestate entry was exceeded. |
| Trace Context headers were not set because mandatory values were not available to Dyntrace RUM. |
| Trace Context headers were not set because the request is not an HTTP request. |
| Trace Context headers were not set because the initial configuration was not received. |
| Trace Context headers were not set for the request. |
| Trace Context headers were set for the request. |
request.server_timing_hint MUST be one of the following:
| Value | Description |
|---|---|
| RUM JavaScript ignored invalid trace information. |
| RUM JavaScript received trace information that doesn't match the Trace Context headers. |
| No trace information available. |
| Server-Timing not available. |
| Server-Timing not available due to an insecure HTTP connection. The |
| RUM JavaScript received valid trace information. |
Only available for user events sent by OneAgent for Mobile.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | experimentalThe estimated number of encoded/compressed bytes received for the request. This includes the response header fields plus the response payload body. |
|
| long | experimentalThe estimated number of encoded/compressed bytes sent for the request. This includes the request header fields plus the request payload body. |
|
Only available for user events sent by RUM JavaScript and based on W3C Resource Timing and W3C Navigation Timing.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalGives additional information about missing |
|
| timestamp | experimentalThe timestamp of the beginning of the current page's lifetime in client time. The value is a UNIX Epoch time in nanoseconds. |
|
| string | experimentalThe web platform feature that initiated the resource load. |
|
| string | experimentalThe network protocol used to fetch the resource. |
|
| string | experimentalThe render-blocking status of the resource. |
|
| string | experimentalThe delivery type of the resource, for example, |
|
| long | experimentalThe size (in octets) of the fetched resource. The size includes the response header fields plus the response payload body. |
|
| long | experimentalThe size (in octets) of the content encoded body. |
|
| long | experimentalThe size (in octets) of the body in bytes after removing content encoding. |
|
performance.incomplete_reason MUST be one of the following:
| Value | Description |
|---|---|
| The resource was retrieved from a cache or it was a cross-origin request without |
| The timings reported by the browser are invalid. |
| The browser only provides incomplete information because the HTTP request was aborted late in processing. |
| The resource was fetched from a local cache. Set in case |
| Not provided by the browser. |
| Page dismissal was triggered while RUM JavaScript waited for resources. |
performance.initiator_type MUST be one of the following:
| Value | Description |
|---|---|
| If the request was initiated by an |
| If the request was initiated by a |
| If the request was initiated by a |
| If the request was initiated by a CSS |
| If the request was initiated by an 103 Early Hint response. |
| If the request was initiated by an |
| If the request was initiated by a |
| If the request was initiated by loading a |
| If the request was initiated by a favicon. Non-standard and only reported by Safari. |
| If the request was initiated by an |
| If the request was initiated by an |
| If the request was initiated by an |
| If the request was initiated by an |
| If the request was initiated by a |
| If the request was initiated by a navigation request. |
| If the request was initiated by an |
| If no condition matches. |
| If the request was initiated by an |
| If the request was initiated by a |
| If the request was initiated by a |
| If the request was initiated by a |
| If the request was initiated by an XMLHttpRequest. |
performance.render_blocking_status MUST be one of the following:
| Value | Description |
|---|---|
| The resource might potentially block rendering. |
| The resource does not block rendering. |
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | experimentalThe start time of the resource fetching phase. The value is relative to |
|
| duration | experimentalThe start time of the redirect phase. The value is relative to |
|
| duration | experimentalThe end time of the redirect phase. The value is relative to |
|
| duration | experimentalThe start time of the service worker phase. The value is relative to |
|
| duration | experimentalThe start time of the resource fetching. (This is also the end time of the service worker phase.) The value is relative to |
|
| duration | experimentalThe start time of the domain name lookup phase. The value is relative to |
|
| duration | experimentalThe end time of the domain name lookup phase. The value is relative to |
|
| duration | experimentalThe start time of the complete server connection phase. The value is relative to |
|
| duration | experimentalThe start time of the secure server connection phase. The value is relative to |
|
| duration | experimentalThe end time of the complete server connection phase. The value is relative to |
|
| duration | experimentalThe start time of the resource request phase. The value is relative to |
|
| duration | experimentalThe time when the first byte was received for an interim 1xx response. The value is relative to |
|
| duration | experimentalThe time when the first byte of the final document response was received from the server. The value is relative to |
|
| duration | experimentalThe start time of the resource response phase. (This is also the end time of the resource request phase.) The value is relative to |
|
| duration | experimentalThe end time of the resource response phase. The value is relative to |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalThe navigation type according to the W3C navigation timing. |
|
| long | experimentalThe number of redirects since the last non-redirect navigation. |
|
| duration | experimentalThe time when a prerendered document is activated. The value is relative to |
|
| duration | experimentalThe start time of the unload event handler phase. The value is relative to |
|
| duration | experimentalThe end time of the unload event handler phase. The value is relative to |
|
| duration | experimentalThe time when the DOM construction has finished and interaction with it is possible. The value is relative to |
|
| duration | experimentalThe start time of the DOM content loaded event handler phase. The value is relative to |
|
| duration | experimentalThe end time of the DOM content loaded event handler phase. The value is relative to |
|
| duration | experimentalThe time when the DOM is complete. The value is relative to |
|
| duration | experimentalThe start time of the load event handler phase. The value is relative to |
|
| duration | experimentalThe end time of the load event handler phase. The value is relative to |
|
performance.type MUST be one of the following:
| Value | Description |
|---|---|
| Navigation through the browser's history traversal operation. |
| Navigation started by clicking a link, entering the URL in the browser's address bar, form submission, or initializing through a script operation that is not a |
| Navigation through the browser's reload operation, |
Only available for user events sent by RUM JavaScript that are based on W3C Navigation Timing.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | stableThe |
|
Only available for user events sent by RUM JavaScript and captured using the browser's XML Http Request API.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| duration | experimentalThe time from request start to XHR load end event. The value is relative to |
|
Navigation requests, i.e. page loads captured by RUM JavaScript that contain W3C Navigation Timings(https://www.w3.org/TR/navigation-timing-2/), contain additional attributes that are defined in the navigation model.
Failed requests can contain additional attributes that are defined in the exception model and the Content Security Policy (CSP) rule violation model.
The basic attributes for all user events are defined in the user event base model.