Datadog Site
L’API Datadog est une API HTTP REST. Elle utilise des URL orientées ressources pour appeler l’API, applique des codes de statut afin d’indiquer la réussite ou l’échec des requêtes, renvoie un objet JSON à partir de toutes les requêtes et tire profit des codes de réponse HTTP standard. Utilisez l’API Datadog pour accéder à la plateforme Datadog par programmation.
Authentifiez-vous auprès de l’API avec une clé d’API en utilisant l’en-tête DD-API-KEY
. Pour certains endpoints, vous devez également utiliser une clé d’application, qui repose sur l’en-tête DD-APPLICATION-KEY
.
Pour essayer l’API
La section Utiliser l’API présente le fonctionnement des endpoints.
Remarque : les exemples de code cURL supposent que vous utilisiez les coreutils GNU et BASH. Sous macOS, vous pouvez installer coreutils via le gestionnaire de packages Homebrew : brew install coreutils
.
Par défaut, la documentation dédiée à l’API Datadog propose des exemples en cURL. Sélectionnez l’une de nos bibliothèques client officielles dans chaque endpoint pour voir des exemples de code pour cette bibliothèque. Pour installer chaque bibliothèque :
Installation
Maven - Ajoutez cette dépendance au fichier POM de votre projet :
<dependency>
<groupId>com.datadoghq</groupId>
<artifactId>datadog-api-client</artifactId>
<version>2.28.0</version>
<scope>compile</scope>
</dependency>
Gradle - Ajoutez cette dépendance au fichier de build de votre projet :
compile "com.datadoghq:datadog-api-client:2.28.0"
Utilisation
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.Configuration;
import com.datadog.api.<VERSION>.client.api.*;
import com.datadog.api.<VERSION>.client.model.*;
Remarque : remplacez <VERSION>
par v1 ou v2 en fonction des endpoints que vous souhaitez utiliser.
Exemples
pom.xml
Maven pour les exemples en cours d’exécution :
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>example</artifactId>
<version>1</version>
<dependencies>
<dependency>
<groupId>com.datadoghq</groupId>
<artifactId>datadog-api-client</artifactId>
<version>2.28.0</version>
<scope>compile</scope>
</dependency>
</dependencies>
</project>
Assurez-vous que la variable CLASSPATH
contienne toutes les dépendances.
export CLASSPATH=$(mvn -q exec:exec -Dexec.executable=echo -Dexec.args="%classpath")
build.gradle
Gradle pour les exemples en cours d’exécution :
plugins {
id 'java'
id 'application'
}
repositories {
jcenter()
}
dependencies {
implementation 'com.datadoghq:datadog-api-client:2.28.0'
}
application {
mainClassName = 'Example.java'
}
Lancez l’exemple en exécutant la commande gradle run
.
Installation
pip3 install datadog-api-client
Utilisation
import datadog_api_client
Installation
gem install datadog_api_client -v 2.26.1
Utilisation
require 'datadog_api_client'
Installation
go mod init main && go get github.com/DataDog/datadog-api-client-go/v2/api/datadog
Utilisation
import (
"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
"github.com/DataDog/datadog-api-client-go/v2/api/datadog<VERSION>"
)
Remarque : remplacez <VERSION>
par V1
ou V2
en fonction des endpoints que vous souhaitez utiliser.
Installation
Le package est sous @datadog/datadog-api-client et peut être installé via NPM ou Yarn :
# NPM
npm install @datadog/datadog-api-client
# Yarn
yarn add @datadog/datadog-api-client
Utilisation
import { <VERSION> } from 'datadog-api-client';
Remarque : remplacez <VERSION>
par v1 ou v2 en fonction des endpoints que vous souhaitez utiliser.
Vous pouvez également consulter directement les bibliothèques :
Vous cherchez à prendre en main l’application ? Consultez la documentation générale
Débuter avec Datadog.
Documentation, liens et articles supplémentaires utiles: