User sessions

  • Latest Dynatrace
  • Reference
  • Published Oct 22, 2025
  • Preview

User sessions provide a summary of the user events from the same customer or end-user of your application during a limited period of time.

User Session

Query

Searches for all user sessions.

fetch user.sessions

Top-level attributes

AttributeTypeDescriptionExamples
durationdurationexperimental
The difference between start_time and end_time in nanoseconds.
42
end_reasonstringexperimental
The reason why the user session was closed.
timeout
end_timetimestampexperimental
End time of a data point. Value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time.
1649822520123123165
navigation_countlongexperimental
The number of navigation events.
1
page_summary_countlongexperimental
The number of page summary events.
1
request_countlongexperimental
The number of request events.
1
start_timetimestampexperimental
Start time of a data point. Value is a UNIX Epoch time in nanoseconds and less than or equal to the end_time.
1649822520123123123
user_interaction_countlongexperimental
The number of user interaction events.
1
view_summary_countlongexperimental
The number of view summary events.
1

User session properties

AttributeTypeDescriptionExamples
session_properties.__property_name__recordexperimental
Contains the value for the session property named __property_name__ defined by the event and session property configuration. The data type of the value depends on the definition; default is data type string.
42; value

User session characteristics

AttributeTypeDescriptionExamples
characteristics.has_replaybooleanexperimental
true indicates that the user session contains replay events.
true
characteristics.is_invalidbooleanexperimental
Primary characteristic: If set to true, the user event was marked invalid during validation.
false

User session errors

AttributeTypeDescriptionExamples
error.anr_countlongexperimental
The number of ANR (Application Not Responding) errors.
1
error.countlongexperimental
The overall number of errors.
1
error.csp_violation_countlongexperimental
The number of CSP rule violations.
1
error.exception_countlongexperimental
The total number of exceptions that are observed, including exceptions that are not captured.
1
error.has_crashbooleanexperimental
true indicates that the user session contains a crash.
true
error.http_4xx_countlongexperimental
The number of HTTP request errors with an http.response.status_code of 400 - 499.
1
error.http_5xx_countlongexperimental
The number of HTTP request errors with an http.response.status_code of 500 - 599.
1

App attributes

AttributeTypeDescriptionExamples
app.short_versionstringresource experimental
The application's publicly visible version number, as, for example, displayed in App Store or Google Play. Usually this is just the major and minor version with no patch number.
5.23
app.versionstringresource experimental
The application's internal build number, which can include information such as patch number and build number.
5.23.15789; 143542

Browser attributes

AttributeTypeDescriptionExamples
browser.namestringresource experimental
The browser name.
Mozilla
browser.versionstringresource experimental
The browser version.
5.0
browser.window.heightlongexperimental
The browser window's inner height, in pixels.
384
browser.window.widthlongexperimental
The browser window's inner width, in pixels.
2048

OS attributes

AttributeTypeDescriptionExamples
os.namestringresource experimental
The OS name in a short, human-readable format.
iOS
os.versionstringresource experimental
The complete OS version, including patch, build, and other information.
15.3.1; Ubuntu 16.04.7 LTS (Xenial Xerus) (kernel 4.15.0-206-generic); Windows Server 2022 Datacenter 21H2 2009, ver. 10.0.20348

Device attributes

AttributeTypeDescriptionExamples
device.is_rootedbooleanresource experimental
If set to true, the device is rooted or jailbroken.
false
device.manufacturerstringresource experimental
The device manufacturer.
Apple
device.model.identifierstringresource experimental
The device model identifier.
iPhone3,4
device.screen.heightlongresource experimental
The device's screen height in its natural orientation.
1152
device.screen.widthlongresource experimental
The device's screen width in its natural orientation.
2048
device.typestringresource experimental
The type of the device.
mobile

Client attributes

AttributeTypeDescriptionExamples
client.ipipAddressexperimental
The IP address of the client that makes the request. This can be IPv4 or IPv6.
Tags: sensitive-spans
194.232.104.141; 2a01:468:1000:9::140
client.ispstringexperimental
The name of the Internet Service Provider (ISP) associated with the client's IP address.
Internet Service Provider Name

RUM attributes

AttributeTypeDescriptionExamples
dt.rum.application.entitiesarrayexperimental
The entity IDs of type APPLICATION or MOBILE_APPLICATION based on dt.rum.application.entity.
Tags: entity-id
['APPLICATION-EA7C4B59F27D43EB', 'MOBILE_APPLICATION-E8A8751A60D5BCE8']
dt.rum.application.typestringexperimental
The application type determined based on dt.rum.agent.type.
web
dt.rum.instance.idstringresource experimental
The RUM application instance ID. (This was formerly called the "Visitor id", "internal user ID", and "rxVisitor cookie value".)
3735928559; 1742973444821E7E6Q3E3SG28ATQPAGTT6T8HU92VFRFQ
dt.rum.session.idstringexperimental
A unique ID that represents the user session.
HOPCPWKILUKHFHWRRQGBHHPAFLUJUOSH-0; 23626166142035610_1-0
dt.rum.user_tagstringexperimental
The user tag.
john.doe@dynatrace.com
dt.rum.user_typestringresource experimental
The RUM user type.
real_user

DT attributes

AttributeTypeDescriptionExamples
dt.retain.sizelongexperimental
The size of the retained data point in bytes.
2005

Geolocation attributes

AttributeTypeDescriptionExamples
geo.country.iso_codestringresource experimental
The two-letter country code. The format complies with ISO 3316-1 alpha-2.
CA; GB

OpenPipeline attributes

AttributeTypeDescriptionExamples
dt.openpipeline.sourcestringresource experimental
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
Related tags
Digital Experience