Cet article explique comment configurer un environnement afin de tirer le meilleur parti de l’API Datadog. Il détaille également la marche à suivre pour récupérer des événements, des métriques et des monitors depuis l’API publique de Datadog et les enregistrer dans un fichier local.

Prérequis : Python et pip doivent être installés sur votre localhost. Si vous utilisez Windows, consultez la section Installer Python 2 sous Windows (en anglais).

1. Ouvrez un terminal.

2. Vérifiez le répertoire suivant : pwd sur macOS, ou dir sur Windows.

3. Créez un dossier : mkdir <NOM_DU_DOSSIER>.

4. Accédez au dossier : cd <NOM_DU_DOSSIER>.

5. Téléchargez le script api_query_data.py vers le dossier créé à l’étape 3 et modifiez-le :

   a. Remplacez <YOUR_DD_API_KEY> et <YOUR_DD_APP_KEY> par vos clés d’API et d’application Datadog.

   b. Remplacez system.cpu.idle par la métrique que vous souhaitez récupérer. Vous pouvez consulter la liste de vos métriques dans le Metric Summary de Datadog.

   c. Vous pouvez également remplacer * par un host de façon à filtrer les données. Vous pouvez consulter la liste de vos hosts dans la liste d’infrastructures de Datadog.

   d. Vous pouvez également modifier la période afin de recueillir les données correspondantes. La valeur par défaut est 3 600 secondes (une heure). Remarque : si vous choisissez une valeur trop extrême, vous risquez d’atteindre les limites de l’API Datadog.

   e. Enregistrez votre fichier et confirmez son emplacement.

Une fois ces étapes réalisées :

1. Il est recommandé de créer un environnement virtuel afin d’y installer les paquets Python. Pour ce faire, vous pouvez installer Virtualenv, un gestionnaire d’environnement virtuel.
2. Créez un environnement virtuel dans le répertoire que vous avez précédemment créé en exécutant virtualenv venv.
3. Activez l’environnement en exécutant source venv/bin/activate (Mac/Linux) ou > \path\to\env\Scripts\activate (Windows).
4. Exécutez pip install datadog pour installer le paquet de l’API Datadog. Cela permet au fichier Python d’interagir avec l’API Datadog.
5. Dans le terminal, exécutez le script python api_query_data.py.

Si tout fonctionne, vos données apparaissent dans le terminal et le fichier out.txt est créé dans votre dossier.

Pour voir d’autres exemples, consultez la documentation relative à l’API.