OneAgent for iOS debug logging

  • How-to guide
  • 1-min read

To enable debug logging for iOS, add the DTXLogLevel configuration key to your app's Info.plist file:

<key>DTXLogLevel</key>
<string>ALL</string>

The available log levels are listed below in order of increasing detail—each level includes the information of the preceding log levels.

Log levelInformation captured
OFFOneAgent version only
SEVEREEvents impacting OneAgent functionality that might disable monitoring
WARNINGEvents that might lead to problems
INFOAdditional informational messages
ALLAll debug information

While running your app, you should find logs in the console within the Xcode debug area. Note that the log level is designed for troubleshooting and has no impact on the data captured by OneAgent.

The default log level is OFF, as heavy logging can impact your app's performance.

Additionally, make sure that environment variable OS_ACTIVITY_MODE is not set to disabled, which would disable debug logging.

The logging output in the Xcode 15+ console no longer shows timestamps. When you copy the logs, for example, to submit them to a Dynatrace product expert, select all log lines in the console and select Copy Rows with All Metadata.

Related tags
Digital Experience