A client-side Android and Android TV library to interact with Datadog.

See the dedicated Datadog Android Log Collection documentation to learn how to forward logs from your Android or Android TV application to Datadog.

See the dedicated Datadog Android RUM Collection documentation to learn how to send RUM data from your Android or Android TV application to Datadog.

If your existing codebase is using Timber, you can forward all those logs to Datadog automatically by using the dedicated library.

If you use Coil to load images in your application, see Datadog's dedicated library.

If you use Fresco to load images in your application, see Datadog's dedicated library.

If you use Glide to load images in your application, see Datadog's dedicated library.

If you use Jetpack Compose in your application, see Datadog's dedicated library.

If you use SQLDelight in your application, see Datadog's dedicated library.

If you use RxJava in your application, see Datadog's dedicated library.

If you use Picasso, use it with the OkHttpClient that's been instrumented with the Datadog SDK for RUM and APM information about network requests made by Picasso.

        val picasso = Picasso.Builder(context)
                .downloader(OkHttp3Downloader(okHttpClient))
                // …
                .build()
        Picasso.setSingletonInstance(picasso)

If you use Retrofit, use it with the OkHttpClient that's been instrumented with the Datadog SDK for RUM and APM information about network requests made with Retrofit.

        val retrofitClient = Retrofit.Builder()
                .client(okHttpClient)
                // …
                .build()

If you use Apollo, use it with the OkHttpClient that's been instrumented with the Datadog SDK for RUM and APM information about all the queries performed through Apollo client.

        val apolloClient =  ApolloClient.builder()
                 .okHttpClient(okHttpClient)
                 .serverUrl(<APOLLO_SERVER_URL>)
                 .build()

If you use Kotlin Coroutines, see Datadog's dedicated library with extensions for RUM and with extensions for Trace

When you open your console in Datadog, navigate to the Log Explorer. In the search bar, type source:android. This filters your logs to only show the ones coming from Android or Android TV applications.

When you open your console in Datadog, navigate to APM > Services. In the list of services, you can see all your Android and Android TV applications (by default, the service name matches your application's package name, for example: com.example.android). You can access all the traces started from your application.

When you open your console in Datadog, navigate to the RUM Explorer. In the side bar, you can select your application and explore Sessions, Views, Actions, Errors, Resources, and Long Tasks.

If you encounter any issue when using the Datadog SDK for Android and Android TV, please take a look at the troubleshooting checklist, common problems, or at the existing issues.

Pull requests are welcome. First, open an issue to discuss what you would like to change. For more information, read the Contributing Guide.

Apache License, v2.0