User sessions API - User session structure

This page provides descriptions of all possible fields that a user session might include.

Be aware that with Dynatrace version 1.204, we’ve introduced new error counts in USQL and Session export for every user action, which are fully consistent across Dynatrace. In turn, we'll deprecate the following error counts with Dynatrace version 1.217:

useraction.errorCount — Only includes JavaScript errors.
useraction.httpRequestsWithErrors — Only considers server-side errors.
useraction.failedXHRRequests — Only considers failed XHR calls made in your end user's browser.
useraction.failedImages — Will be included with the new requestErrorCount. Read more about how to best replace existing error counts with the new ones.

The `UserSession` object

A user session, encompassing multiple user actions and additional information about a user's visit.

Element	Type	Description
tenantId	string	The ID of the Dynatrace environment that captured the user session. This field can not be queried via the User Session Query Language.
userSessionId	string	The unique ID of the user session.
startTime	integer	The timestamp of the first user action in the user session, in UTC milliseconds.
endTime	integer	The timestamp of the last user action in the user session, in UTC milliseconds.
duration	integer	The duration of the user session, in milliseconds. This is calculated as the amount of time between the start of the first user action and the end of the last user action.
internalUserId	string	The unique ID of the user that triggered the user session.
userType	string	The type of the user. Indicates either a real human user (`REAL_USER`) or a robot (`ROBOT` or `SYNTHETIC`). The element can hold these values `REAL_USER` `ROBOT` `SYNTHETIC`
reasonForNoSessionReplay	string	The reason for absence of Session Replay. The element can hold these values `KILLED_EMERGENCY` `KILLED_ERROR` `KILLED_MIN_JS_AGENT_VERSION` `KILLED_NO_LICENSE` `KILLED_WRONG_CONTENT_TYPE` `MISCONFIGURED_CLUSTER` `MODULE_DISABLED` `NO_ACTIVITY` `OPTED_OUT_SESSION` `OPT_IN_MODE` `ROBOT_DETECTED` `SAMPLED_OUT` `UNABLE_TO_LOAD_WORKER` `UNHANDLED_EXCEPTION` `UNKNOWN` `UNSUPPORTED_BROWSER` `VIEW_EXCLUDED`
reasonForNoSessionReplayMobile	string	The reason for absence of Session Replay on mobile. The element can hold these values `DISABLED` `NO_AGENT` `OPTED_OUT` `UNKNOWN`
applicationType	string	The type of the application used in the user session. The element can hold these values `AMP_APPLICATION` `CUSTOM_APPLICATION` `MOBILE_APPLICATION` `WEB_APPLICATION`
bounce	boolean	The user session has (`true`) or doesn't have (`false`) a bounce. A bounce means there is only one (or less) user action in the user session.
newUser	boolean	The user is a first-time (`true`) or a returning user (`false`).
userActionCount	integer	The number of user actions in the user session.
totalErrorCount	integer	The number of errors detected in the user session.
totalLicenseCreditCount	integer	The amount of DEM units consumed by the session.
matchingConversionGoalsCount	integer	The number of conversion goals achieved by the user session.
matchingConversionGoals	string[]	A list of conversion goals achieved by the user session. Additionally, you can define conversion goals for a single user action.
ip	string	The IP address (IPv4 or IPv6) from which the user session originates.
continent	string	The continent from which the user session originates (based on the IP address).
country	string	The country from which the user session originates (based on the IP address).
region	string	The region from which the user session originates (based on the IP address).
city	string	The city from which the user session originates (based on the IP address).
browserType	string	The type of browser used for the user session.
browserFamily	string	The family of the browser used for the user session.
browserMajorVersion	string	The version of the browser used for the user session.
osFamily	string	The type of operating system used for the user session.
osVersion	string	The version of the operating system used for the user session.
manufacturer	string	The detected manufacturer of the device used for the user session.
device	string	The detected device used for the user session.
userId	string	The user ID provided for the user session by session tagging.
screenHeight	integer	The detected screen height of the device used for the user session.
screenWidth	integer	The detected screen width of the device used for the user session.
screenOrientation	string	The detected screen orientation of the device used on the device for the user session. The element can hold these values `LANDSCAPE` `PORTRAIT` `UNDEFINED`
displayResolution	string	The detected screen resolution of the device used for the user session. The element can hold these values `CGA` `DCI2K` `DCI4K` `DVGA` `FHD` `FWVGA` `FWXGA` `GHDPlus` `HD` `HQVGA` `HQVGA2` `HSXGA` `HUXGA` `HVGA` `HXGA` `NTSC` `PAL` `QHD` `QQVGA` `QSXGA` `QUXGA` `QVGA` `QWXGA` `QXGA` `SVGA` `SXGA` `SXGAMinus` `SXGAPlus` `UGA` `UHD16K` `UHD4K` `UHD8K` `UHDPlus` `UNKNOWN` `UWQHD` `UXGA` `VGA` `WHSXGA` `WHUXGA` `WHXGA` `WQSXGA` `WQUXGA` `WQVGA` `WQVGA2` `WQVGA3` `WQXGA` `WQXGA2` `WSVGA` `WSVGA2` `WSXGA` `WSXGAPlus` `WUXGA` `WVGA` `WVGA2` `WXGA` `WXGA2` `WXGA3` `WXGAPlus` `XGA` `XGAPLUS` `_1280x854` `nHD` `qHD`
hasCrash	boolean	The user session includes (`true`) or doesn't include (`false`) a crash.
crashGroupId	string	If a mobile session crashed, this is the ID of the group to which the crashed session belongs. If the session did not crash or the session is not a mobile session, it has the `null` value.
hasSessionReplay	boolean	Session Replay is (`true`) or is not (`false`) available for the session.
isp	string	The internet service provider from which the user session originates (based on the IP address).
clientType	string	Additional information about the client. This field can not be queried via the user session query language. Use the browserType field instead.
browserMonitorId	string	The ID of the Synthetic browser monitor that created the session.
browserMonitorName	string	The name of the Synthetic browser monitor that created the session.
stringProperties	StringProperty[]	A list of custom properties of the user session with string values.
longProperties	LongProperty[]	A list of custom properties of the user session with integer (short or long) values.
doubleProperties	DoubleProperty[]	A list of custom properties of the user session with floating-point numerical values.
dateProperties	DateProperty[]	A list of custom properties of the user session with date values.
userActions	UserSessionUserAction[]	A list of user actions recorded in the user session.
events	UserSessionEvents[]	A list of additional events recorded in the user session.
errors	UserSessionErrors[]	A list of errors recorded in the user session.
syntheticEvents	UserSessionSyntheticEvent[]	A list of synthetic events recorded in the user session.
appVersion	string	The version of the application where the user session has been recorded. This information is provided by another integration, such as OpenKit.
endReason	string	The reason for the end of the user session. The element can hold these values `DURATION_LIMIT` `END_EVENT` `EXTENDED_TIMEOUT` `TEST_FAILED` `TIMEOUT` `USER_ACTION_LIMIT`
numberOfRageClicks	integer	The number of rage clicks detected in the user session.
numberOfRageTaps	integer	The number of rage taps detected in the user session.
userExperienceScore	string	The user experience score of the user session. The element can hold these values `FRUSTRATED` `SATISFIED` `TOLERATED` `UNDEFINED`
carrier	string	The carrier information of the mobile user session.
networkTechnology	string	The network technology information of the mobile user session.
connectionType	string	The serialized connection type of the mobile user session. The element can hold these values `LAN` `MOBILE` `OFFLINE` `UNKNOWN` `WIFI`
replayStart	integer	The timestamp of the Session Replay start, in UTC milliseconds.
replayEnd	integer	The timestamp of the Session Replay end, in UTC milliseconds.
clientTimeOffset	integer	The time offset of the client, in milliseconds
rootedOrJailbroken	boolean	The mobile device is rooted/jailbroken (`true`) or genuine (`false`). Has the value of `null` if the status is unknown or undefined. Custom applications always report unknown/undefined.
hasError	boolean	The user session includes (`true`) or doesn't include (`false`) an error.
partNumber	integer	User sessions can be split into multiple parts for various technical reasons (e.g. after 200 user actions). This `partNumber` represents the number of each part of the overall user session.

The `StringProperty` object

A custom property of the user action with a string value.

Element	Type	Description
key	string	The custom key of the property.
value	string	The string value of the property.

The `LongProperty` object

A custom property of the user action with a Long value.

Element	Type	Description
key	string	The custom key of the property.
value	integer	The Long value of the property.

The `DoubleProperty` object

A custom property of the user action with a Double value.

Element	Type	Description
key	string	The custom key of the property.
value	number	The floating-point numeric value of the property.

The `DateProperty` object

A custom property of the user-action with a date value.

Element	Type	Description
key	string	The custom key of the property.
value	string	The date value of the property.

The `UserSessionUserAction` object

A user action.

A user action is a single action performed by the user as part of a user session, for example a mouse click.

Element	Type	Description
name	string	The name of the user action. Typically, this is the name of the page that is loaded as part of a user action or a textual description of the action, such as a mouse click.
domain	string	The DNS domain where the user action has been recorded.
targetUrl	string	The target URL of the user action.
type	string	The type of the user action. The element can hold these values `Custom` `EndVisit` `Error` `Load` `RageClick` `SyntheticHiddenAction` `UserSessionProperties` `VisitTag` `Xhr`
startTime	integer	The start timestamp of the user action, in UTC milliseconds.
endTime	integer	The end timestamp of the user action, in UTC milliseconds.
duration	integer	The duration of the user action, in milliseconds. This is calculated as the of time between the start and the end timestamps of the user action.
application	string	The name of the application where the user action has been recorded.
internalApplicationId	string	The Dynatrace entity ID of the application where the user action has been recorded. This information is useful when calling various REST APIs, for example as a key for time series queries.
internalKeyUserActionId	string	The Dynatrace entity ID of the key user action.
speedIndex	integer	The speed index of the user action, in milliseconds. This is calculated as average time it takes for all visible parts of a page to display.
apdexCategory	string	The user experience index of the user action. The element can hold these values `FRUSTRATED` `SATISFIED` `TOLERATING` `UNKNOWN`
matchingConversionGoals	string[]	A list of conversion goals achieved by the user action. Additionally, you can define conversion goals for a user session as a whole.
networkTime	integer	The amount of time spent on the data transfer for the user action, in milliseconds.
serverTime	integer	The amount of time spent on the server-side processing for the user action, in milliseconds.
frontendTime	integer	The amount of time spent on the frontend rendering for the user action, in milliseconds.
documentInteractiveTime	integer	The amount of time spent until the document for the user action became interactive, in milliseconds.
thirdPartyResources	integer	The number of third party resources loaded for the user action.
thirdPartyBusyTime	integer	The time spent waiting for third party resources for the user action, in milliseconds.
cdnResources	integer	The number of resources fetched from a CDN for the user action.
cdnBusyTime	integer	The time spent waiting for CDN resources for the user action, in milliseconds.
firstPartyResources	integer	The number of resources fetched from the originating server for the user action.
firstPartyBusyTime	integer	The time spent waiting for resources from the originating server for the user action, in milliseconds.
hasCrash	boolean	The user action has (`true`) or doesn't have (`false`) a crash.
domCompleteTime	integer	The amount of time until the DOM tree is completed, in milliseconds.
domContentLoadedTime	integer	The amount of time until the DOM tree is loaded, in milliseconds.
loadEventStart	integer	The amount of time until the load event started, in milliseconds.
loadEventEnd	integer	The amount of time until the load event ended, in milliseconds.
navigationStart	integer	The timestamp of the navigation start, in UTC milliseconds.
requestStart	integer	The amount of time until the request started, in milliseconds.
responseStart	integer	The amount of time until the response started, in milliseconds.
responseEnd	integer	The amount of time until the response ended, in milliseconds.
visuallyCompleteTime	integer	The amount of time until the page is visually complete, in milliseconds.
syntheticEvent	string	The name of the Synthetic event that triggered the user action.
syntheticEventId	string	The ID of the Synthetic event that triggered the user action.
keyUserAction	boolean	The action is (`true`) or is not (`false`) a key action.
stringProperties	StringProperty[]	A list of custom properties of the user session with string values.
longProperties	LongProperty[]	A list of custom properties of the user session with integer (short or long) values.
doubleProperties	DoubleProperty[]	A list of custom properties of the user session with floating-point numerical values.
dateProperties	DateProperty[]	A list of custom properties of the user session with date values.
userActionPropertyCount	integer	The total number of properties in the user action.
customErrorCount	integer	The total number of custom errors during the user action.
javascriptErrorCount	integer	The total number of Javascript errors during the user action.
requestErrorCount	integer	The total number of request errors during the user action.
largestContentfulPaint	integer	The largest contentful paint (LCP) is the time (in milliseconds) that the largest element on the page took to render. The LCP is an important user-centric metric for measuring load speed. It marks the point when the page's main content is likely loaded. A low LCP indicates that the page loads quickly.
firstInputDelay	integer	The first input delay (FID) is the time (in milliseconds) that the browser took to respond to the first user input. The FID is an important user-centric metric for measuring load responsiveness. It quantifies the user experience when trying to interact with unresponsive pages. A low FID indicates that the page is usable.
~~totalBlockingTime~~	integer	DEPRECATED The total blocking time is the total time (in milliseconds) between the first contentful paint and the time to interactive, during which the browser has been blocked long enough to prevent input responsiveness.
cumulativeLayoutShift	number	The cumulative layout shift (CLS) is the total amount of all individual scores for every unexpected layout shift that occurs during the entire lifespan of the page. The CLS is an important user-centric metric for measuring visual stability. It quantifies how often users experience unexpected layout shifts. A low CLS indicates that the page is delightful.

The `UserSessionEvents` object

The external event of a user session.

Element	Type	Description
type	string	The type of event. The element can hold these values `Behavioral` `Crash` `Error` `PageChange` `RageClick` `RageTap` `UserTag` `UserTagFromMetaData` `VisitTag`
name	string	The name of the event.
domain	string	The DNS domain where the event has been recorded.
startTime	integer	The timestamp of the event, in UTC milliseconds.
application	string	The name of the application, based on the configured detection rules.
internalApplicationId	string	The Dynatrace entity ID of the application. This information is useful when calling various REST APIs, for example, as a key for time series queries.
metadata	string	The metadata attached to the event.
page	string	The name of the page the user navigated to during a page change event.
pageGroup	string	The page group is automatically derived from the page.
pageReferrer	string	The name of the previous page from which the user navigated from during a page change event.
pageReferrerGroup	string	The page referrer group is automatically derived from the page referrer.

The `UserSessionErrors` object

The error of a user session.

Element	Type	Description
type	string	The type of error. The element can hold these values `Behavioral` `Crash` `Error` `PageChange` `RageClick` `RageTap` `UserTag` `UserTagFromMetaData` `VisitTag`
name	string	The name of the error.
domain	string	The DNS domain where the error has been recorded.
startTime	integer	The timestamp of the error, in UTC milliseconds.
application	string	The name of the application, based on the configured detection rules.
internalApplicationId	string	The Dynatrace entity ID of the application. This information is useful when calling various REST APIs, for example, as a key for time series queries.

The `UserSessionSyntheticEvent` object

A synthetic event of a user session.

Element	Type	Description
name	string	The name of the synthetic event.
syntheticEventId	string	The Dynatrace entity ID for the synthetic event.
sequenceNumber	integer	The sequence number of the synthetic event in scope of the complete browser monitor.
timestamp	integer	The timestamp when the synthetic event was simulated, in UTC milliseconds.
type	string	The type of the synthetic event. For example click or keystroke.
errorCode	integer	The error code of the error that occurred during this event.
errorName	string	Description of the error that occurred during this event.

User sessions API - User session structure

The UserSession object

The StringProperty object

The LongProperty object

The DoubleProperty object

The DateProperty object

The UserSessionUserAction object

The UserSessionEvents object

The UserSessionErrors object

The UserSessionSyntheticEvent object