Puedes utilizar la API de Datadog en la línea de comandos utilizando una envoltura llamada Dogshell.

Instalar Dogshell

Dogshell viene con la biblioteca de Python datadogpy admitida oficialmente, que a menudo se utiliza para enviar datos a Datadog con DogStatsD. Para instalar la biblioteca con PIP, ejecuta el siguiente comando:

pip install Datadog

En función de tu entorno, puede que tengas que añadir la biblioteca a tu RUTA. Consulta el repositorio de GitHubdatadogpy para obtener instrucciones de instalación alternativas.

Configurar Dogshell

Dogshell utiliza un archivo de configuración llamado .dogrc para almacenar tu clave de la API, tu clave de la aplicación y tu sitio de Datadog.

Para configurar Dogshell:

  1. Crea un archivo .dogrc en tu directorio personal:

    toca ~/.dogrc

  2. Añade el siguiente contenido al archivo, sustituyendo MY_API_KEY y MY_APP_KEY con tu clave de la API y tu clave de la aplicación, respectivamente:

    [Connection]
    apikey = MY_API_KEY
    appkey = MY_APP_KEY
    api_host = 
    
    Puedes crear varios archivos de configuración si necesitas ejecutar comandos en diferentes entornos. Utiliza la marca --configuración para especificar la ruta a un archivo de configuración alternativo.
  3. Prueba el comando dogshell publicando una métrica de test:

    test_metric 1 de publicación de métricas de dog

Comandos de Dogshell

Utiliza la marca -h para obtener una lista completa de los comandos de Dogshell disponibles:

dog -h

Puedes añadir la opción -h a los siguientes comandos para obtener más información sobre el uso específico de Dogshell:

  • dog metric
  • dog event
  • dog service_check
  • dog monitor
  • dog downtime
  • dog timeboard
  • dog screenboard
  • dog dashboard
  • dog host
  • dog tag
  • dog search
  • dog comment

Para obtener más información, consulta el código de Dogshell.

Ejemplo de Dogshell

La siguiente sintaxis publica una métrica en tu cuenta de Datadog:

publicación de métrica de dog MY_METRIC_NAME METRIC_VALUE --etiquetas (tags) "TAG_KEY_1:TAG_VALUE_1,TAG_KEY_2:TAG_VALUE_2"

Por ejemplo, el siguiente comando envía una métrica llamada test_dogshell_metric a tu cuenta con un valor de 1.0 y las etiquetas (tags) test:one y example:one:

publicación de métrica de dog test_dogshell_metric 1.0 --etiquetas (tags) "test:one,example:one"

Después de ejecutar el comando, buscatest_dogshell_metric utilizando el Explorador de métricas.

Observar test_dogshell_metric desde el explorador de métricas