Instrument your application via Dynatrace Android Gradle plugin

If your project has library modules, feature modules, multiple application modules, or just one build file, first check the corresponding section in Change Dynatrace Android Gradle plugin configuration based on the project structure. The steps required to set up the Dynatrace Android Gradle plugin might be slightly different for applications with such architectures.

Follow the steps below to instrument your Android app with the Dynatrace Android Gradle plugin.

Ensure that the Maven Central repository is declared.

Add our plugin to the build script classpath.

Apply our plugin and add its configuration snippet.

Customize the plugin configuration.

Enhance mobile user experience data by using the OneAgent SDK for Android.

Ensure that the Maven Central repository is declared.

Dynatrace is hosted on Maven Central. In the Gradle settings file, verify that mavenCentral() is added to the repositories blocks under pluginManagement and dependencyResolutionManagement. Check the official Android documentation to see what the Gradle settings file should look like.

You might need to add mavenCentral() to all repositories blocks in the top-level build file.

Add our plugin to the build script classpath.

In the top-level build file, add the buildscript block with the dependencies block inside and add the classpath of the Dynatrace Android Gradle plugin (com.dynatrace.tools.android:gradle-plugin).

// add this entire block
buildscript {
    dependencies {
        classpath 'com.dynatrace.tools.android:gradle-plugin:8.+'
    }
}

// this block already exists
plugins {
    id 'com.android.application' version '8.1.0' apply false
    id 'com.android.library' version '8.1.0' apply false
}

// add this entire block
buildscript {
    dependencies {
        classpath("com.dynatrace.tools.android:gradle-plugin:8.+")
    }
}

// this block already exists
plugins {
    id("com.android.application") version "8.1.0" apply false
    id("com.android.library") version "8.1.0" apply false
}

In the top-level build file, find the dependencies block inside the buildscript block, and add the classpath of the Dynatrace Android Gradle plugin (com.dynatrace.tools.android:gradle-plugin) after the build script classpath of the Android Gradle plugin (com.android.tools.build:gradle).

buildscript {
    repositories {
        google()
        mavenCentral() // hosts Dynatrace Android Gradle plugin
    }
    dependencies {
        // build script classpath of Android Gradle plugin
        classpath 'com.android.tools.build:gradle:<version>'
        // build script classpath of Dynatrace Android Gradle plugin; add this line to build.gradle file
        classpath 'com.dynatrace.tools.android:gradle-plugin:8.+'
    }
}

buildscript {
    repositories {
        google()
        mavenCentral() // hosts Dynatrace Android Gradle plugin
    }
    dependencies {
        // build script classpath of Android Gradle plugin
        classpath("com.android.tools.build:gradle:<version>")
        // build script classpath of Dynatrace Android Gradle plugin; add this line to build.gradle.kts file
        classpath("com.dynatrace.tools.android:gradle-plugin:8.+")
    }
}

In the top-level build file, find the plugins block, and add the id com.dynatrace.instrumentation of the Dynatrace Plugin Marker Artifacts. After plugins block add plugin configuration of the Android instrumentation wizard to have the correct applicationId and beaconUrl values.

plugins {
   id 'com.android.application' version '8.5.0' apply false
   id 'com.dynatrace.instrumentation' version '8.+' apply true
}

dynatrace {
    configurations {
        sampleConfig {
            autoStart {
                applicationId = '<YourApplicationID>'
                beaconUrl = '<ProvidedBeaconURL>'
            }
        }
    }
}

plugins {
   id("com.android.application") version "8.5.0" apply false
   id("com.dynatrace.instrumentation") version "8.+" apply true
}

dynatrace {
    configurations {
        create("sampleConfig") {
            autoStart {
                applicationId("<YourApplicationID>")
                beaconUrl("<ProvidedBeaconURL>")
            }
        }
    }
}

Skip step 3. The apply statement is not needed, when you are using the Gradle Plugin DSL.

Use version 8.+ so that Gradle can automatically update our plugin when a new minor version is available. When Dynatrace releases a new major version, manually upgrade to the new version—the new major version might contain breaking changes, so manual adjustments are usually required.

Apply our plugin and add its configuration snippet.

Apply the Dynatrace Android Gradle plugin with the com.dynatrace.instrumentation plugin ID in the top-level build file.

Then, add the code snippet from step 3 (Apply the Dynatrace plugin and add the plugin configuration) of the Android instrumentation wizard to have the correct applicationId and beaconUrl values.

apply plugin: 'com.dynatrace.instrumentation'
dynatrace {
    configurations {
        sampleConfig {
            autoStart {
                applicationId '<YourApplicationID>'
                beaconUrl '<ProvidedBeaconURL>'
            }
        }
    }
}

apply(plugin = "com.dynatrace.instrumentation")
configure<com.dynatrace.tools.android.dsl.DynatraceExtension> {
    configurations {
        create("sampleConfig") {
            autoStart {
                applicationId("<YourApplicationID>")
                beaconUrl("<ProvidedBeaconURL>")
            }
        }
    }
}

You can change the sampleConfig configuration name to something more meaningful. You can also define different configurations for different Android build variants. For example, you can report your debug and release variants to different mobile applications in Dynatrace by using variant-specific configurations.

Customize the plugin configuration.

The Gradle snippet that you've copied from the Android instrumentation wizard contains the default plugin configuration. The same configuration is used for all Android build variants, and our plugin uses the default sensors and default OneAgent configuration values. For this reason, you might want to adjust the configuration of the Dynatrace Android Gradle plugin.

optional Enhance mobile user experience data by using the OneAgent SDK for Android.

With OneAgent SDK for Android, you can enrich the mobile user experience data. For example, user tagging or custom value reporting is only available via the OneAgent SDK.