Datadog SDK for Android
A client-side Android library to interact with Datadog.
Getting Started
Log Collection
See the dedicated Datadog Android Log Collection documentation to learn how to forward logs from your Android application to Datadog.
Real User Monitoring
See the dedicated Datadog Android RUM Collection documentation to learn how to send RUM data from your Android application to Datadog.
Log Integrations
Timber
If your existing codebase is using Timber, you can forward all those logs to Datadog automatically by using the dedicated library.
RUM Integrations
Coil
If you use Coil to load images in your application, take a look at Datadog's dedicated library.
Fresco
If you use Fresco to load images in your application, take a look at Datadog's dedicated library.
Glide
If you use Glide to load images in your application, take a look at our dedicated library.
Picasso
If you use Picasso, let it use your OkHttpClient
, and you'll get RUM and APM information about network requests made by Picasso.
val picasso = Picasso.Builder(context)
.downloader(OkHttp3Downloader(okHttpClient))
// …
.build()
Picasso.setSingletonInstance(picasso)
Retrofit
If you use Retrofit, let it use your OkHttpClient
, and you'll get RUM and APM information about network requests made with Retrofit.
val retrofitClient = Retrofit.Builder()
.client(okHttpClient)
// …
.build()
Apollo (GraphQL)
If you use Apollo, let it use your OkHttpClient
, and you'll get RUM and APM information about all the queries performed through Apollo client.
val apolloClient = ApolloClient.builder()
.okHttpClient(okHttpClient)
.serverUrl(<APOLLO_SERVER_URL>)
.build()
Looking up your logs
When you open your console in Datadog, navigate to the Logs section. In the search bar, type source:android
. This filters your logs to only show the ones coming from Android applications.
Looking up your spans
When you open your console in Datadog, navigate to the APM section. In the list of services, you'll see all your android applications (by default the service name will match your application's package name, e.g.: com.example.android
). You'll then be able to see all the traces started from your application.
Looking up your RUM events
When you open your console in Datadog, navigate to the RUM Explorer section. In the side bar, you can then select your application and explore Sessions, Views, Actions, Errors and Resources.
Troubleshooting
If you encounter any issue when using the Datadog SDK for Android, please take a look at the troubleshooting checklist, or at the existing issues.
Warning
We have not tested the SDK on Roku devices running with Android OS and we cannot guarantee that it will perform well. If you encounter any problems while using our SDK for these particular devices please contact us at Datadog Support or you can directly open an issue in our GitHub project.
Contributing
Pull requests are welcome. First, open an issue to discuss what you would like to change. For more information, read the Contributing Guide.