API Datadog : ce qu'elle permet et comment l'utiliser avec des agents IA
L'API Datadog permet d'interroger les métriques et les logs, de créer et de mettre en sourdine des monitors, d'enregistrer des événements, de gérer les incidents et les dashboards. Elle sert aux équipes SRE, DevOps et plateforme qui exploitent des environnements cloud. L'accès combine une clé d'API et une clé d'application de l'organisation.
Ce que propose l’API Datadog
Métriques
Envoi de métriques personnalisées et lecture de séries temporelles.
Logs
Recherche et agrégation des logs collectés par la plateforme.
Monitors
Création, modification, mise en sourdine et consultation de l'état des alertes.
Événements
Enregistrement d'événements comme les déploiements et les changements de configuration.
Incidents
Ouverture et mise à jour des incidents, avec responsables et chronologie.
Dashboards et SLO
Gestion des tableaux de bord et suivi des objectifs de niveau de service.
Comment accéder à l’API Datadog
- Avec les identifiants de votre entrepriseL'API utilise une clé d'API, qui identifie l'organisation, associée à une clé d'application, qui définit les droits de l'appelant. Les clés d'application peuvent avoir des périmètres restreints.
- Les logs peuvent contenir des données personnelles ou des secrets : limitez ce que l'agent consulte et transmet.
- Des limites de requêtes s'appliquent par endpoint : évitez les requêtes larges et fréquentes.
- Utilisez l'URL de la région correcte du compte (par exemple US ou EU).
Documentation officielle: docs.datadoghq.com/api
Ce qu’un agent iTeam fait avec l’API Datadog
Tri de l'alerte de la nuit
Quand un monitor se déclenche, l'agent récupère les logs et les métriques de la période, les croise avec le dernier déploiement et remet un résumé à la personne d'astreinte.
Déploiement enregistré comme événement
L'agent enregistre chaque déploiement dans Datadog, ce qui permet de voir si un problème a commencé après un changement.
Mise en sourdine pendant une maintenance, avec validation
Avant une fenêtre de maintenance, l'agent propose de mettre en sourdine les monitors concernés et l'applique une fois la validation donnée.
Rapport hebdomadaire des SLO
L'agent rassemble la consommation du budget d'erreur de chaque service et signale ceux qui approchent de la limite.
De l’identifiant à l’agent au travail, avec validation
Créer une clé d'application avec périmètre
Générez une clé d'API et une clé d'application de compte de service, avec des périmètres en lecture seule au départ.
Stocker dans le coffre d'iTeam
Enregistrez les clés et la région Datadog dans le coffre, en définissant quels agents lisent et lesquels peuvent modifier des monitors.
Élargir avec validation
N'autorisez des actions comme mettre des monitors en sourdine ou ouvrir des incidents qu'avec la validation de l'équipe d'astreinte.
Équipes IA prêtes à l’emploi pour ce travail
Analyse de données
Posez une question métier dans Slack ou Teams : l'équipe écrit la requête, vérifie le résultat et vous répond avec le chiffre et sa source.
Support informatique interne
Mot de passe, accès, matériel : la demande est posée dans Slack ou Teams, l'agent répond ou ouvre un ticket Jira complet.
Questions sur l’API Datadog
L'API Datadog est-elle gratuite ?
L'API n'est pas facturée à part, mais l'envoi de métriques, de logs et d'autres données entre dans la consommation de votre offre Datadog.
Faut-il savoir programmer pour utiliser l'API Datadog avec iTeam ?
Pas nécessairement. iTeam lit la documentation et l'équipe de déploiement configure les requêtes et les actions ; Datadog propose aussi un serveur MCP sur certains comptes.
L'agent peut-il résoudre l'incident seul ?
Il accélère le diagnostic et prépare les actions. Les changements en production restent soumis à la validation de la personne d'astreinte.
