User actions
A user action is an interaction with an end-user interface that involves a call to a web server, which can potentially have multiple nested calls. It is a transformation from one view to another view that is triggered by a user input, for example, a page load, click, or touch.
User action types for web applications
Web applications
The following types of user actions are available in Dynatrace for web applications:
The key difference among these action types is the way action duration is calculated and the list of available metrics.
Load actions
A load action is defined as an actual page loading in your browser. If you type a URL in your browser and use Enter, a load action occurs. During this action type, many resources are loaded, including images, HTML, and CSS.
Load action duration
The action duration is the time required for the complete load action. More specifically, the start time of the user action equals the W3C navigationStart
time. If this attribute is not available, the start time equals the time when the RUM JavaScript is initialized in the browser. The end time is when the last onload
handler has completed its task. The onload
handler is an event handler in JavaScript that's used to call the execution of JavaScript after a page, frame, or image has completely loaded. If any XMLHttpRequests
are started by an onload
handler, the user action ends when the XMLHttpRequest
is complete.
Load action timings
The following measures are used to chart the duration of specific steps in the load action process.
Measure
Description
Definition in terms of W3C specification
DNS lookup
The time taken to resolve the hostname for a target URL
window.performance.timing.domainLookupEnd
− window.performance.timing.domainLookupStart
TCP connect
The time taken to establish a TCP connection to the server (including SSL)
window.performance.timing.connectEnd
− window.performance.timing.connectStart
Secure connect
The time taken to secure the connection established to the server
This includes the SSL handshake and SOCKS.
window.performance.timing.connectEnd
− window.performance.timing.secureConnectionStart
Redirect time
The time taken to follow any HTTP redirects
window.performance.timing.redirectEnd
− window.performance.timing.redirectStart
Request
The time taken to request the page from the server until the first byte is received
window.performance.timing.responseStart
− window.performance.timing.requestStart
Response
The time taken to receive the response
window.performance.timing.responseEnd
− window.performance.timing.responseStart
Time to first byte (TTFB)
The time taken until the first byte of the response is received from the server, relevant application caches, or a local resource
window.performance.timing.responseStart
Server time
The time spent on server-side processing for a page
window.performance.timing.responseStart
− window.performance.timing.requestStart
Network time
The time taken to request and receive resources (including DNS lookup, redirect, and TCP connect time)
window.performance.timing.responseEnd
− window.performance.timing.fetchStart
− (window.performance.timing.responseStart
− window.performance.timing.requestStart
)
Frontend time
The time taken by the browser to render a page
User action duration
− Server time
− Network time
Processing
The time between DOM loading and Load event start
window.performance.timing.loadEventStart
− window.performance.timing.domLoading
Application cache
The time spent checking any relevant application caches
This includes the time before the connection to the server is established.
window.performance.timing.domainLookupStart
− window.performance.timing.fetchStart
OnDomContentLoaded
The time taken to execute OnDomContentLoaded
handlers
window.performance.timing.domContentLoaded
− window.performance.timing.domLoading
OnLoad
The time taken to process the load event
window.performance.timing.loadEventEnd
− window.performance.timing.loadEventStart
Callback
The time taken to execute XHR callbacks
N/A
First paint
The time taken to render the first non-default background element
N/A
First input start
The moment when the user first interacts with a page, for example, clicks a UI control
N/A
First input delay
The time from the first interaction with the page to when the user agent can respond to that interaction
N/A
First contentful paint
The time taken to render the first bit of content, such as text or images
N/A
Largest contentful paint
The time taken to render the largest element in the viewport
N/A
Cumulative layout shift
The score measuring the unexpected shifting of visible webpage elements for a load action
N/A
Visually complete
The time taken to fully render content in the viewport
N/A
Speed index
The score measuring how quickly the visible parts of the page are rendered
N/A
User action duration
The time taken to complete the page load
This includes load time of XHR requests initiated before loadEventEnd
and load time of dynamic resources and script executions triggered by DOM modifications.
N/A
XHR actions
Dynatrace continuously tracks user interactions with each page. If user interaction leads to XmlHttpRequests
or fetch()
calls, an XHR action is created. Dynatrace also detects if there are additional XHRs triggered in the callback of the initial XHR and so on. In this case, Dynatrace waits until all requests are finished. By monitoring the DOM, Dynatrace can also identify resources that have been added in the callbacks. Dynatrace then waits until those resources have finished downloading before ending the action.
An XHR action starts with the user's click on a control on a web page. All metrics are calculated in relation to this point in time and are based on the initial XHR that triggers the user action.
By default, RUM captures certain interaction types. You can configure RUM to detect even more interaction types. For details, see Capture additional interaction types for web applications.
XmlHttpRequest
Most modern applications, including single-page applications, rely on a single load action that downloads the framework and initializes the page. After that, the DOM of the page is changed via JavaScript, and all communication with the web server is done via XmlHttpRequest
.
Fetch API
The Fetch API provides an interface for fetching resources, including resources across the network. It is similar to XMLHttpRequest
, but the API provides a more flexible feature set. The generic definitions of Request
, Response
, and other network request objects in Fetch allow them to be used at any time they are needed, whether it's for service workers, Cache API, or anything that handles or modifies requests and responses. Fetch also supports the Cross Origin Resource Sharing (CORS).
User actions based on the Fetch API appear in Dynatrace as XHR actions. You can configure RUM to automatically detect and capture Fetch API request information.
Custom user actions
Rather than relying on default user action generation, you may want to fine-tune your Real User Monitoring by adding additional user actions directly into your application's HTML. This can be useful if our automated user-action generation doesn't catch specific actions or you want to introduce specific fine-grained timings into your application monitoring. For example, you can measure how long it takes to open a JavaScript-only dropdown menu, or you can measure the duration time of some JavaScript code. To define custom actions, use the RUM JavaScript API.
User action duration
Below, you can find information on the maximum user action duration in Dynatrace and the user action contributors for web applications.
Maximum user action duration
The maximum user action duration depends on the application type.
User action contributors for web applications
The duration of a user action can be broken down into three components:
- Server time: The time spent on server-side processing for a page
- Network time: The time taken to request and receive resources (including DNS lookup, redirect, and TCP connect time)
- Frontend time: The time taken by the browser to render a page
These components contribute to the overall duration of a user action.
The user action duration is calculated as follows.
User action duration = (loadEventEnd
or endTimeOfLastXHR
) − actionStart
In this calculation
- actionStart
navigationStart
for page loads or "click time" for XHR actions and user navigations, such as a click on a button or a link- endTimeOfLastXHR
When XHR calls are triggered during the process and aren't completed before
loadEventEnd
, then the end time of the last XHR call is used instead of theloadEventEnd
time.
The user action contributors are calculated as follows.
Server time = responseStart
− requestStart
Network time = (requestStart
− actionStart
) + (responseEnd
− responseStart
)
Frontend time = User action duration
− Server time
− Network time
View the examples of user action contributors below.
User action naming rules
Many applications allow users to accomplish the same goal using different UI controls and following different paths. When monitoring such applications, it can be difficult to differentiate between actions that have the same result and goal but are executed using different parts of the application UI. Likewise, if the application is translated into multiple languages, the same application function or UI element can appear under varying names. With user action naming rules, Dynatrace can detect such subtle variations and intelligently group user actions that achieve the same goal into logical groups for monitoring.
Dynatrace automatically removes certain common sessionid
tokens from user action names, for example, jsessionid
for Java containers, default sessionid
for PHP, and CFID
and CFTOKEN
for ColdFusion. Nonetheless, there are numerous session ID variations that may be present in your environment. If Dynatrace doesn't automatically recognize and remove session IDs from certain user action names you encounter, you'll need to configure custom naming rules for your web, mobile, and custom applications.
When you configure custom naming rules for your web, mobile, and custom applications, remember that your input in the Add placeholder and Add naming rule sections is case-sensitive. Only the already configured user action name can be set to case-insensitive.
Child actions
Child actions are actions attached to the main, or parent, user action. You can create child actions for web, mobile, and custom applications.
For web applications, you can create child actions using the RUM JavaScript API, specifically, the enterXhrAction
method.
For mobile and custom applications, Dynatrace offers an API method for creating a child action.
The possible child action nesting depends on the application type and technology used.
There's no limit on the number of child actions attached to a parent action, and there's no limit on the number of levels.
However, note that child actions are not displayed on the user session details page, and child action nesting is not preserved on the waterfall analysis page for a parent action to which these child actions are attached.
There's no limit on the number of child actions attached to a parent action. However, note that you can have only nine levels of child actions—you can create one parent action and nine levels of child actions (when child action A is added to a parent action, child action B is added to child action A, child action C is added to child action B, and so on). Also, refer to User session structure for individual user.
Child actions are not displayed on the user session details page, but you can view them on the waterfall analysis page for a parent action to which these child actions are attached. Even though the child action nesting is not fully preserved in the waterfall analysis view and all child actions are displayed as child actions of level 1, you can still grasp the action nesting from the timings.
There's no limit on the number of child actions attached to a custom action. However, note that you can have only one level of child actions—you can't create a child action for another child action (child actions can't have their own child actions). Also, refer to User session structure for individual user.
Child actions are not displayed on the user session details page, but you can view them on the waterfall analysis page for a custom action to which these child actions are attached.
Key user actions
Most applications include user actions that are particularly important to the success of your digital business. Examples of these actions are signups, checkouts, and product searches. Such key user actions might take longer to execute than others, or they might have the requirement to be of a shorter-than-average duration.
For instance, consider that you've set your global Apdex threshold to 3 seconds. While this threshold might be acceptable for the majority of user actions, it might not be acceptable for a signup user action. Alternatively, there could be a search action that is quite complex and requires more time than the allotted 3 seconds.
You can mark a user action as a key user action and configure Apdex rating for key user actions in your web, mobile, and custom application settings.