Este artículo explica cómo configurar un entorno para sacar el máximo partido de la API de Datadog e incluye cómo extraer o enviar eventos, métricas y monitores desde API pública de Datadog a un archivo local.

Requisito: Python y pip instalados en tu host local. Los usuarios de Windows pueden consultar Instalación de Python 2 en Windows.

1. Abre un terminal.

2. Verifica el directorio: pwd en macOS, dir en Windows.

3. Crea una nueva carpeta: mkdir <NAME_OF_THE_FOLDER>.

4. Introduce la carpeta: cd <NAME_OF_THE_FOLDER>.

5. Descarga el script api_query_data.py en la carpeta creada en el paso 3 y edítalo:

   a. Sustituye <YOUR_DD_API_KEY> y <YOUR_DD_APP_KEY> por tus claves de API de Datadog y claves de aplicación.

   b. Sustituye system.cpu.idle por una métrica que desees recuperar. Una lista de tus métricas aparece en el resumen de métrica de Datadog.

   c. Opcionalmente, sustituye * por un host para filtrar los datos. Una lista de tus hosts aparece en la lista de infraestructura de Datadog.

   d. Opcionalmente, cambia el periodo para recopilar los datos. El ajuste actual es 3600 segundos (una hora). Nota: Si ejecutas esto de forma demasiado agresiva, puedes alcanzar los límites de la API de Datadog.

   e. Guarda tu archivo y confirma tu localización.

Una vez completado lo anterior:

1. Es una práctica recomendada para crear un entorno virtual en el que instalar los paquetes de Python. Un gestor virtual de entorno es virtualenv.
2. Crea un nuevo entorno virtual en el directorio que creaste anteriormente ejecutando virtualenv venv.
3. Activa el entorno al ejecutar source venv/bin/activate (Mac/Linux) o > \path\to\env\Scripts\activate (Windows).
4. Ejecuta pip install datadog para instalar el paquete de API de Datadog. Esto permite que el archivo de Python interactúe con la API de Datadog.
5. En el terminal, ejecuta el script: python api_query_data.py.

Si tienes éxito, tus datos se muestran en el terminal y se crea un archivo en tu carpeta llamado out.txt.

Consulta ejemplos adicionales en la documentación de la API de Datadog.