Support and limitations

  • Latest Dynatrace
  • Reference
  • 1-min read
  • Published Dec 24, 2025

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

Supported versions

Requirement

Minimum Version

Flutter

3.10.0

Dart

3.0.0

iOS SDK

12

Android API Level

21

Gradle

7.0.2

Android Gradle Plugin

7.0

Java

11

Limitations

Flutter-specific

  • Web platform not supported—the Dynatrace Flutter plugin only supports Android and iOS platforms.

Troubleshooting

No data appearing in Dynatrace

  1. Verify configuration—ensure dynatrace.config.yaml is in your project root and contains valid applicationId and beaconUrl values.
  2. Apply configuration—run dart run dynatrace_flutter_plugin after any configuration changes.
  3. Check initialization—verify that Dynatrace().start() is called in your main() function.
  4. Enable debug logging—see Configuration to enable agent logs.
  5. Check network—ensure the device can reach your Dynatrace environment.

Gradle sync failed

Error: Could not find com.dynatrace.tools.android:gradle-plugin:X.X.X.

Solution: add mavenCentral() to all repository blocks in your top-level build.gradle file:

buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}

OneAgent SDK version mismatch

Error: OneAgent SDK version X does not match Dynatrace Android Gradle plugin version X.

Solution: run dart run dynatrace_flutter_plugin to update the Gradle dependencies after upgrading the Flutter plugin.

Configuration not applied

Issue: changes to dynatrace.config.yaml don't take effect.

Solution: you must run dart run dynatrace_flutter_plugin after every configuration change. This command updates the native Android and iOS project files.

Get support

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 dynatrace.config.yaml file (with sensitive data redacted).
    • Debug logs from the OneAgent (see Configuration).
    • Used Flutter plugin version.
    • Used Flutter and Dart versions (flutter --version).
    • Steps to reproduce the issue.
    • Any error messages or stack traces.

Documentation

Community

Related tags
Digital Experience