Try it free

Errors

  • Latest Dynatrace
  • Reference

Error user events capture various types of errors that occur during user interactions, including application crashes, ANR errors, JavaScript exceptions, CSP violations, and API-reported errors.

Application Not Responding (ANR)

Semantic conventions to describe Application Not Responding (ANR) events in Dynatrace RUM. These conventions are supported only for OneAgent for Mobile.

Query

This query searches for all ANR events.

fetch user.events
| filter characteristics.has_anr == true

ANR characteristics fields

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value error.

error

characteristics.has_anr

boolean

stableFixed value true.

true

characteristics.has_error

boolean

stableFixed value true.

true

ANR error fields

AttributeTypeDescriptionExamples

error.id

uid

experimentalDisplay name: Error IDA unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string.

357bf70f3c617cb34584b31bd4616af8

error.is_fatal

boolean

experimentalDisplay name: Error is fatalAlways true for ANR errors because the non-responsive app resulted in a fatal exit.

true

error.name

string

experimentalDisplay name: Error nameA human-readable version of error.id.

500: foo.bar/path/file; path/file:1:5

error.type

string

experimentalDisplay name: Error typeThe main error type. This information is determined by Dynatrace RUM error grouping.

anr

ANR exception fields

AttributeTypeDescriptionExamples

exception.message

string

experimentalDisplay name: Exception messageA message that describes the exception.

user request after error: Input dispatching timed out (f9276c4 com.example\/com.example.MainActivity (server) is not responding. Waited 10001ms for MotionEvent)

exception.stack_trace

string

experimentalDisplay name: Exception stack traceThe stack trace of the ANR error. The format depends on the technology and source.

"main" prio=5 tid=1 Sleeping\n | group="main" sCount=1 ucsCount=0 flags=1 obj=0x739329b8 self=0x7f3c8a64c7b0\n at java.lang.Thread.sleep(Native method)

Basic user event fields

The basic attributes for all user events are defined in the user event base model.

Content Security Policy (CSP) rule violation

Semantic conventions for W3C Content Security Policy (CSP) rule violations in Dynatrace RUM. These conventions are only supported for RUM JavaScript.

Query

This query searches for all violations of the Content Security Policy (CSP).

fetch user.events
| filter characteristics.has_csp_violation == true

CSP characteristics fields

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value error.

error

characteristics.has_csp_violation

boolean

stableFixed value true.

true

characteristics.has_error

boolean

stableFixed value true.

true

CSP error fields

AttributeTypeDescriptionExamples

error.id

uid

experimentalDisplay name: Error IDA unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string.

357bf70f3c617cb34584b31bd4616af8

error.is_fatal

boolean

experimentalDisplay name: Error is fatalIf set to true, the error resulted in a fatal exit (for example, an unhandled exception).

false

error.name

string

experimentalDisplay name: Error nameA human-readable version of error.id.

500: foo.bar/path/file; path/file:1:5

error.reason

string

experimentalDisplay name: Error reasonThe error reason. RUM JavaScript reports a pre-defined set of values.

no_network

error.type

string

experimentalDisplay name: Error typeThe main error type. This information is determined by Dynatrace RUM error grouping.

csp

CSP rule violation report fields

AttributeTypeDescriptionExamples

csp.blocked_uri.full

string

experimentalThe absolute URI of the resource that was blocked from loading by the Content Security Policy. The field may also contain one of these special values instead of a URL: data, inline, blob, wasm-eval, eval, attachment, chrome-extension.

https://www.foo.bar/resources/file.js; inline; blob

csp.blocked_uri.scheme

string

experimentalThe URI scheme component. This is extracted from csp.blocked_uri.full.

https

csp.blocked_uri.domain

string

experimentalThe URI domain component. This is extracted from csp.blocked_uri.full.

www.foo.bar

csp.blocked_uri.path

string

experimentalThe URI path component. This is extracted from csp.blocked_uri.full.

/resources/file.js

csp.blocked_uri.query

string

experimentalThe URI query component. This is extracted from csp.blocked_uri.full.

csp.blocked_uri.fragment

string

experimentalThe URI fragment component. This is extracted from csp.blocked_uri.full.

csp.blocked_uri.provider

string

experimentalThe provider type for the host name of csp.blocked_uri.full. This information is determined by Dynatrace RUM resource detection.

third_party

csp.document_uri.full

string

experimentalThe full URI of the document in which the violation occurred.

https://www.foo.bar/

csp.document_uri.scheme

string

experimentalThe URI scheme component. This is extracted from csp.document_uri.full.

https

csp.document_uri.domain

string

experimentalThe URI domain component. This is extracted from csp.document_uri.full.

www.foo.bar

csp.document_uri.path

string

experimentalThe URI path component. This is extracted from csp.document_uri.full.

/

csp.document_uri.query

string

experimentalThe URI query component. This is extracted from csp.document_uri.full.

csp.document_uri.fragment

string

experimentalThe URI fragment component. This is extracted from csp.document_uri.full.

csp.referrer.full

string

experimentalThe referrer of the document in which the violation occurred.

https://www.foo.bar/

csp.disposition

string

experimentalIndicates whether the Content Security Policy was enforced or only reported.

enforce

csp.violated_directive

string

experimentalThe policy directive that was violated, as it appears in the policy.

default-src

csp.effective_directive

string

experimentalThe directive whose enforcement caused the violation.

style-src

csp.original_policy

string

experimentalThe original policy as specified by the HTTP Content-Security-Policy or the HTTP Content-Security-Policy-Report-Only response header.

default-src 'none'; style-src cdn.foo.bar; report-to /_/csp-reports

csp.status_code

long

experimentalThe HTTP status code of the resource on which the global object was instantiated.

200

csp.sample

string

experimentalIf the directive's value contains the expression report-sample, this is set to the first 40 characters of the source file.

csp.line_number

long

experimentalLine number where the violation occurred.

32

csp.column_number

long

experimentalColumn number where the violation occurred.

178

csp.source_file.full

string

experimentalThe full URL (from which the external file was loaded) that caused the violation.

https://www.foo.bar/

csp.reporter

string

experimentalHow the CSP violation was captured on site.

ReportingObserver

csp.stack_trace

string

experimentalThe stack trace that RUM JavaScript collected for the CSP rule violation by firing an exception.

@https://www.foo.bar/path/main.js:59:26 e@https://www.foo.bar/path/lib/1.1/lib.js:2:30315

csp.blocked_uri.provider MUST be one of the following:

ValueDescription

cdn

CDN (content delivery network).

first_party

First-party provider.

third_party

Third-party provider.

csp.disposition MUST be one of the following:

ValueDescription

enforce

The HTTP Content-Security-Policy response header is used and the request was actually blocked.

report

The HTTP Content-Security-Policy-Report-Only response header is used and the request was not blocked.

csp.reporter MUST be one of the following:

ValueDescription

ReportingObserver

The CSP violation was captured via the ReportingObserver API.

SecurityPolicyViolationEvent

The CSP violation was captured via the SecurityPolicyViolationEvent API.

Basic user event fields

The basic attributes for all user events are defined in the user event base model.

Crash

Semantic conventions to describe crash events in Dynatrace RUM. These conventions are supported only for OneAgent for Mobile.

Query

This query searches for all crashes.

fetch user.events
| filter characteristics.has_crash == true

Crash characteristics fields

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value error.

error

characteristics.has_crash

boolean

stableFixed value true.

true

characteristics.has_error

boolean

stableFixed value true.

true

Crash error fields

AttributeTypeDescriptionExamples

error.id

uid

experimentalDisplay name: Error IDA unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string.

357bf70f3c617cb34584b31bd4616af8

error.is_fatal

boolean

experimentalDisplay name: Error is fatalIf set to true, the error resulted in a fatal exit (for example, an unhandled exception).

true

error.name

string

experimentalDisplay name: Error nameA human-readable version of error.id.

500: foo.bar/path/file; path/file:1:5

error.type

string

experimentalDisplay name: Error typeThe main error type. This information is determined by Dynatrace RUM error grouping.

crash

Crash exception fields

AttributeTypeDescriptionExamples

exception.crash_signal_name

string

experimentalThe signal that was sent to the process.

SIGSEGV

exception.message

string

experimentalDisplay name: Exception messageA message that describes the exception.

Division by zero

exception.stack_trace

string

experimentalDisplay name: Exception stack traceThe stack trace of the crash or a full crash report. The format depends on the technology and source.

java.lang.ArithmeticException: divide by zero\n at com.example.Foo.bar(Foo.kt:14); signal 6 (SIGABRT), code -1 (SI_QUEUE), fault addr 0000000000000000\nThread-18:\n #00 pc 000000000005cb90 /apex/com.android.runtime/lib64/bionic/libc.so (abort+192) (BuildId: eb58b4d427279994f00c0e1818477e4f)

exception.type

string

experimentalDisplay name: Exception typeThe type of the exception, for example, its fully-qualified class name or the crash type of a native crash in an Android application.

java.net.ConnectException; OSError; char*

Basic user event fields

The basic attributes for all user events are defined in the user event base model.

Dynatrace API reported error

Semantic conventions to describe error events reported via the Dynatrace API. These conventions are supported only for OneAgent for Mobile.

Query

This query searches for all errors reported via the Dynatrace API.

fetch user.events
| filter characteristics.has_error AND characteristics.is_api_reported

Dynatrace API reported error characteristics fields

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value error.

error

characteristics.has_error

boolean

stableFixed value true.

true

characteristics.is_api_reported

boolean

stableFixed value true.

true

Dynatrace API reported error fields

AttributeTypeDescriptionExamples

error.code

long

experimentalDisplay name: Error codeThe code of the error. Set for iOS (NSError and Swift Error) and custom errors for C-based languages.

-1; 3072

error.has_custom_name

boolean

experimentalDisplay name: Custom error name setIf set to true, the error.name was reported via the Dynatrace API.

true

error.id

uid

experimentalDisplay name: Error IDA unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string.

357bf70f3c617cb34584b31bd4616af8

error.name

string

experimentalDisplay name: Error nameA human-readable version of error.id.

500: foo.bar/path/file; path/file:1:5

error.reason

string

experimentalDisplay name: Error reasonThe error reason. RUM JavaScript reports a pre-defined set of values. OneAgent for iOS reports nserror.domain.

no_network

Dynatrace API reported exceptions

The semantics for exceptions reported via the Dynatrace API are defined in the exception model.

Basic user event fields

The basic attributes for all user events are defined in the user event base model.

Exception

Semantic conventions to describe exceptions in Dynatrace RUM.

Query

This query searches for all exceptions.

fetch user.events
| filter characteristics.has_exception == true

Exception characteristics fields

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value error.

error

characteristics.has_error

boolean

stableFixed value true.

true

characteristics.has_exception

boolean

stableFixed value true.

true

characteristics.is_api_reported

boolean

stableAdditional characteristic: If set to true, the user event was sent using the Dynatrace API.

true

Exception error fields

AttributeTypeDescriptionExamples

error.has_custom_name

boolean

experimentalDisplay name: Custom error name setIf set to true, the error.name was reported via the Dynatrace API.

true

error.id

uid

experimentalDisplay name: Error IDA unique identifier for error grouping. The error.id is a 16-byte ID and hex-encoded if shown as a string.

357bf70f3c617cb34584b31bd4616af8

error.is_fatal

boolean

experimentalDisplay name: Error is fatalIf set to true, the error resulted in a fatal exit (for example, an unhandled exception).

true

error.name

string

experimentalDisplay name: Error nameA human-readable version of error.id.

500: foo.bar/path/file; path/file:1:5

error.reason

string

experimentalDisplay name: Error reasonThe error reason. RUM JavaScript reports a pre-defined set of values. OneAgent for iOS reports nserror.domain.

no_network

error.source

string

experimentalDisplay name: Error sourceThe error source.

fetch; console

error.type

string

experimentalDisplay name: Error typeThe main error type. This information is determined by Dynatrace RUM error grouping.

exception

Exception fields

AttributeTypeDescriptionExamples

exception.column_number

long

experimentalDisplay name: Exception column numberThe column number where the exception happened. Only supported by RUM JavaScript, the value is reported as provided by the browser.

12304

exception.file.domain

string

experimentalDisplay name: Exception file domainThe URI domain component. This is extracted from exception.file.full.

www.foo.bar

exception.file.full

string

experimentalDisplay name: Exception fileThe full file location when the exception happened. Only supported by RUM JavaScript, the value is reported as provided by the browser.

https://www.foo.bar/path/main.js; main.js; <anonymous>

exception.file.path

string

experimentalDisplay name: Exception file pathThe URI path component. This is extracted from exception.file.full.

/path/main.js

exception.file.provider

string

experimentalThe provider type for the host name of exception.file.full. This information is determined by Dynatrace RUM resource detection.

third_party

exception.is_stack_trace_generated

boolean

experimentalDisplay name: Exception is stack trace generatedIf set to true, the captured stack trace was generated by Dynatrace RUM. This is only available if the user event contains a stack trace. Only supported by RUM JavaScript and OneAgent for Mobile with the Dynatrace Flutter extension.

false

exception.is_stack_trace_wrapped

boolean

experimentalIf set to true, Dynatrace RUM wrapped the method that caused the exception. This is only available if the user event contains a stack trace. Only supported by RUM JavaScript and OneAgent for Mobile with the Dynatrace Flutter extension.

false

exception.line_number

long

experimentalDisplay name: Exception line numberThe line number where the exception happened. Only supported by RUM JavaScript, the value is reported as provided by the browser.

1401

exception.line_offsets

string

experimentalDisplay name: Exception line offsetsThe line offset mapping for source lines shifted by instrumentation. Only supported by OneAgent for iOS used with SwiftUI instrumentor.

{"generationTime":"2025-12-08 13:20:55","instrumentorVersion":"8.329","mappings":[{"ContentView.swift":{"1":3,"18":8,"25":13,"26":18,"27":23}},{"InstrDemoApp.swift":{"1":3,"13":4}}],"project":"Testproject.xcproject"}

exception.message

string

experimentalDisplay name: Exception messageA message that describes the exception.

Division by zero

exception.stack_trace

string

experimentalDisplay name: Exception stack traceThe stack trace of the exception. The format depends on the technology and source. While OneAgent formats stack traces to unify them across technologies, stack traces from an OpenTelemetry source are in the format they were sent to Dynatrace.

@https://www.foo.bar/path/main.js:59:26 e@https://www.foo.bar/path/lib/1.1/lib.js:2:30315

exception.type

string

experimentalDisplay name: Exception typeThe type of the exception, for example, its fully-qualified class name.

java.net.ConnectException; OSError

Basic user event fields

The basic attributes for all user events are defined in the user event base model.