• Home
  • Solutions
  • Digital Experience
  • RUM concepts
  • User and error events

User and error events

Besides detecting user actions, Dynatrace also captures additional events known as user events and error events. These events occur within a user session, but they're not directly generated via user interaction with UI controls.

User events

User events are page changes, rage clicks, rage taps, and user tagging events.

Page change

A page change event signifies that a user has navigated to a different page on a website. For example, if you navigated to a website "payment" page, the user session would show the following events.

  • Load: loading of page /payment
  • Page change: /payment

For more details, see RUM web: Page change events and Pages and page groups.

Rage event

When your application doesn't respond quickly or there's a user interface issue, users might repeatedly click the screen or a UI control in frustration. Dynatrace detects such behavior as a rage event: a rage click for a web application and a rage tap for a mobile application.

Three or more rapid clicks or taps within the same area are considered to be a rage event. Rage events commonly reflect slow load times or failed resources. Detected rage events affect the user experience score, but when required, you can choose to exclude rage clicks and rage taps from score calculation. See Configure user experience score thresholds to learn more.

You also have the option to completely disable rage event detection.

  • Web applications In your application settings, select Behavior analytics > Usability analytics and turn off Detect rage clicks.
  • Android See Rage tap detection.
  • iOS Set the DTXDetectRageTaps configuration key to false.

In the Dynatrace web UI, you can also check sessions with rage events to view the details of a rage click or rage tap event.

See also Discover frustrating user experiences with automatic rage click detection.

User tagging

One of the key features of Real User Monitoring is the ability to uniquely identify individual users across different browsers, devices, and user sessions. This is achieved by assigning a user tag, which is comprised of a username, nickname, or email, to a user session. When a user is tagged in your application, Dynatrace reports a user tagging event.

For web applications, you can set up user tagging using either the RUM JavaScript API or your application's page metadata.

For mobile and custom applications, Dynatrace offers a variant of a "user tagging" method.

  • Android SDK
  • iOS SDK
  • Cordova
  • Xamarin
  • .NET MAUI
  • Flutter
  • React Native
  • OpenKit

With user tags, you can analyze a specific user's behavior and experience via user session analysis. See Focus on sessions of an individual user and User details for more information.

Error events

Error events include errors and crashes.

Error

Dynatrace reports an error whenever a browser throws a JavaScript exception, a web request results in an error, a custom error is sent via API, and for other reasons.

The following error types are captured depending on your application type.

Error typeDescriptionWebMobileCustom
Request errorDetected by the browser and OneAgent on your servers
Reported errorManually reported via dedicated "report an error" API method
Custom errorManually reported via the RUM JavaScript API
JavaScript errorJavaScript exceptions thrown by the browser

To report a custom error for a web application or a reported error for a mobile or a custom application, use a dedicated API method.

  • Web
  • Android SDK
  • iOS SDK
  • Cordova
  • Xamarin
  • .NET MAUI
  • Flutter
  • React Native
  • OpenKit

Dynatrace offers numerous configuration options related to errors. For web applications, you can fine-tune error detection for each error type, for example, configure request error rules, add custom error rules, or ignore JavaScript errors. For mobile and custom applications, you can opt to ignore web request errors.

Note that errors affect both the user experience score and Apdex rating. However, you can change user experience score thresholds, adjust Apdex settings, and exclude errors from Apdex calculations in your application settings.

You can leverage performance, multidimensional, and user session analysis to get information on errors that occur in your application. You can check various error details such as the estimated error count, provider, technology, and more. For details, see the following pages.

  • Performance analysis | Top errors
  • Multidimensional analysis based on error type
  • Analyze individual user actions | Errors
  • User session analysis | View error details

Crash

Mobile and custom applications

When your application crashes, Dynatrace automatically reports a crash event. Dynatrace captures all unhandled exceptions and immediately sends the crash report to the server. The crash report includes the occurrence time and the full stack trace of the exception.

Crash reporting is enabled by default, but you can deactivate this feature.

  • Android See Crash reporting.
  • iOS Set the DTXCrashReportingEnabled configuration key to false.

For some technologies, you can report a crash manually.

  • Xamarin
  • .NET MAUI
  • Flutter
  • React Native
  • OpenKit

To view the complete sequence of user actions that preceded a crash, leverage user session analysis. You can also open a crash report to get all the code-level information and quickly trace the root cause of a crash. For additional details, see the following pages.

  • User session analysis | Examine crashes
  • View crash reports for mobile applications
  • View crash reports for custom applications

With Session Replay on crashes, you receive additional context for your crash analysis. You can watch video-like screen recordings that replay the user actions immediately preceding a detected crash. This feature is available for Android and iOS.

Note that crashes drastically affect the user experience score. See Calculate the user experience score to see why crashed sessions are usually rated as Frustrating.