Support and limitations

  • Latest Dynatrace
  • Reference

On this page, you can learn about the supported versions, limitations, troubleshooting resources, and support options for Android.

Supported versions

Requirement

Minimum version

Android API level

21

Gradle

7.0.2

Android Gradle Plugin

7.0

Java

11

Kotlin

2.0.21

Jetpack Compose

1.3 - 1.9

Limitations

Android-specific

  • WebSocket and non-HTTP protocols—webSocket requests (ws://, wss://) and other non-HTTP protocols require manual instrumentation.
  • Third-party framework requests—web requests from some third-party frameworks may not be automatically instrumented.

Instrumentation-specific

The Dynatrace Android Gradle plugin only instruments the AndroidManifest.xml and .class files. It doesn't instrument the following components:

  • Native code—code written with the NDK is not instrumented.
  • Web components—files such as .html and .js are not instrumented.
  • Resource files—layout .xml files and other resource files are not instrumented.
  • Android library projects—the Dynatrace Android Gradle plugin auto-instruments only Android application projects. It doesn't support the auto-instrumentation of stand-alone Android library projects. Internal libraries are auto-instrumented when added as a dependency to your Android application project.

Third-party obfuscation tools

OneAgent for Android and its transitive dependencies provide ProGuard rules designed for R8. If you use third-party obfuscation tools instead of R8, you are responsible for configuring them to honor the required keep rules. Failure to do so may result in runtime errors due to incorrectly obfuscated classes.

If you use Android Gradle Plugin features such as ignoreFrom to filter out keep rules from dependencies, be aware that this may affect OneAgent functionality.

Multiple monitoring tools

There might be compatibility issues with other performance monitoring plugins, especially when these plugins instrument OneAgent for Android. We recommend either using only one performance monitoring plugin or verifying via manual testing that the plugins you've chosen are compatible.

Event limitations

For information about event rate limits and other general restrictions, see General limitations for RUM mobile applications.

Troubleshooting

For troubleshooting mobile application monitoring issues, refer to the following resources:

Get support

You can get support by repoting a bug or asking a question in Dynatrace Community.

Report a bug

To report a bug or open a support case:

  1. Go to support.dynatrace.com.
  2. Open a support ticket with the following information:
    • Your Gradle configuration (with sensitive data redacted).
    • Debug logs from the OneAgent (see Enable debug logging).
    • OneAgent version.
    • Operating system version and device model.
    • Android Studio and Gradle versions.
    • Steps to reproduce the issue.
    • Any error messages or stack traces.

Community

Related tags
Digital Experience