Références sur les API

Utilisez l’API HTTP Datadog pour accéder automatiquement à la plateforme Datadog. L’API Datadog utilise des URL axées sur les ressources ainsi que des codes de statut afin d’indiquer la réussite ou l’échec des requêtes. Elle renvoie également un objet JSON pour toutes les requêtes.

Pour prendre en main l’API HTTP Datadog, suivez le processus ci-dessous afin d’identifier les endpoints dont vous avez besoin. Consultez également la section Utiliser Postman avec les API Datadog.

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 paquets Homebrew : brew install coreutils.

Installer l'Agent Datadog

Avant de pouvoir utiliser l’API pour envoyer ou consulter des données, vous devez installer l’Agent Datadog. L’Agent Datadog est un logiciel qui s’exécute sur vos hosts. Il recueille les événements et les métriques de vos hosts et les envoie à la plateforme Datadog, à partir de laquelle vous pouvez analyser vos données de surveillance et de performance.

Envoyer des données à Datadog

Une fois l’Agent Datadog configuré, utilisez l’API pour commencer à envoyer les données des intégrations à Datadog. Les options de configuration supplémentaire de l’Agent vous offrent également la possibilité d’utiliser l’API pour envoyer des données Synthetics, des logs et des traces à Datadog.

Endpoints d’intégration

Endpoints d’intégration disponibles :

• Intégration AWS
• Intégration Logs AWS
• Intégration Azure
• Intégration GCP
• Intégration Slack
• Intégration PagerDuty
• Intégration Webhooks

Endpoints de plateforme

Utilisez ces endpoints pour envoyer et récupérer des données dans Datadog :

• Les endpoints de métriques vous permettent d’envoyer des données de métriques afin de les représenter graphiquement sur les dashboards de Datadog et de les interroger sur l’intervalle de votre choix.
• Les endpoints d’événements vous permettent d’envoyer des événements au flux d’événements Datadog et d’y récupérer des événements.
• Utilisez les endpoints Synthetics pour créer, lancer et interrompre des tests Synthetics, ou visualiser leurs résultats.
• Utilisez l’API de tracing de l’Agent pour envoyer des traces à l’Agent Datadog afin de les transmettre par la suite à Datadog.

Visualiser vos données

Lorsque vous envoyez des données à Datadog, vous pouvez utiliser l’API pour créer automatiquement des représentations visuelles de ces données :

• Créez des dashboards et consultez les listes de dashboards.
• Gérez les tags de host.
• Créez des graphiques intégrables.
• Prenez un snapshot de graphique.
• Dépendances de service : consultez la liste de vos services APM et de leurs dépendances.
• Créez des monitors.
• Checks de service : envoyez des statuts de check afin de les utiliser avec des monitors.
• Créez et gérez des logs, des index de logs et des pipelines de logs.
• Récupérez des informations sur des hosts pour votre organisation.
• Créez et gérez des Service Level Objectives.
• Générez des signaux Security Monitoring.

Gérer votre compte

Vous pouvez également utiliser l’API Datadog pour gérer automatiquement votre compte :

• Gérez des utilisateurs.
• Gérez des rôles.
• Gérez votre organisation.
• Vérifiez les clés d’API et d’application avec l’endpoint d’authentification.
• Autorisez l’accès à des logs spécifiques avec les requêtes de restriction de logs.
• Gérez des clés existantes avec la fonctionnalité de gestion de clés.
• Récupérez des informations sur l’utilisation horaire, journalière et mensuelle de nombreuses facettes de Datadog grâce aux endpoints dédiés à la mesure de l’utilisation.
• Consultez la liste des préfixes d’adresse IP appartenant à Datadog avec les plages d’IP.

Limites de débit

Certains endpoints d’API possèdent une limite de débit. Lorsque vous dépassez un certain nombre de requêtes dans un intervalle donné, une erreur est renvoyée.

Pour les endpoints d’API à débit limité, les en-têtes sont renvoyés afin que vous puissiez vérifier où vous vous situez par rapport à votre limite. Si vous dépassez votre limite, consultez ces en-têtes afin de déterminer à quel moment vous pourrez renvoyer ces données.

Pour revoir à la hausse les limites de débit par défaut, contactez l’assistance Datadog.

Quelques précisions concernant la politique de limitation de débit des API :

• Datadog n’applique pas de limite de débit lors de l’envoi de points de données/métriques (consultez la section relative aux métriques pour en savoir plus sur le traitement du débit d’envoi des métriques). Les limites appliquées dépendent de la quantité de métriques custom prévue dans votre contrat.
• La limite de débit pour la récupération de métriques est de 100 par heure et par organisation.
• La limite de débit pour l’envoi d’événements est fixée à 1000 par agrégat, par jour et par organisation. Un agrégat désigne un groupe d’événements similaires.
• La limite de débit pour les appels de l’API permettant d’interroger une série temporelle est de 600 par heure et par organisation. Cette limite peut être augmentée sur demande.
• La limite de débit pour les appels de l’API permettant d’interroger des logs est de 300 par heure et par organisation. Cette limite peut être augmentée sur demande.
• La limite de débit pour les appels de l’API permettant de représenté un snapshot est de 60 par heure et par organisation. Cette limite peut être augmentée sur demande.
• La limite de débit pour les appels de l’API permettant de configurer des logs est de 6000 par minute et par organisation. Cette limite peut être augmentée sur demande.