DataDog / datadog-api-client-java

datadog-api-client-java This repository contains a Java API client for the Datadog API. Requirements Building the API client library requires: • Java 1.8+ • Maven/Gradle Installation To install the API client library to your local Maven repository, simply execute: To deploy it to a remote Maven repository instead, configure the settings of the repository and execute: Refer to the OSSRH Guide for more information. Maven users Add this dependency to your project's POM: See the Releases page for the latest available version. Gradle users Add this dependency to your project's build file: See the Releases page for the latest available version. Others At first generate the JAR by executing: Then manually install the following JARs: • • Getting Started Please follow the installation instruction and execute the following Java code: Asynchronous support All API methods have asynchronous versions returning when adding the suffix to their names: Unstable Endpoints This client includes access to Datadog API endpoints while they are in an unstable state and may undergo breaking changes. An extra configuration step is required to enable these endpoints: where is the name of the method used to interact with that endpoint. For example: , or Changing Server When talking to a different server, like the instance, change the on your client: Disable compressed payloads If you want to disable GZIP compressed responses, set the flag on your client: Enable requests logging If you want to enable requests logging, set the flag on your client: Enable Retry To enable the client to retry when rate limited (status 429) or status 500 and above: The interval between 2 retry attempts will be the value of the response header when available. If not, it will be : . Configure proxy You can provide custom implementation to to use proxy. See example below using : Using alternative artifacts Outside of the regular JAR file we also release 2 artifacts that can be useful for development, namely: • , which contains all the dependencies of the client in a single JAR • , which includes and renames the core dependencies of the client, allowing you to use different versions of those libraries in your project. To use them in Maven, just add the keyword in the dependency definition. For example: Documentation for API Endpoints and Models Javadoc is available on javadoc.io. Documentation for Authorization To programmatically defined authorization headers, calls the method with a map containing the required secrets for the operations: Recommendation It's recommended to create an instance of per thread in a multithreaded environment to avoid any potential issues. Author support@datadoghq.com