Vous pouvez utiliser l’API Datadog en ligne de commande à l’aide d’un wrapper appelé Dogshell.

Installer Dogshell

Dogshell est fourni avec la bibliothèque Python datadogpy officiellement prise en charge, souvent utilisée pour envoyer des données à Datadog avec DogStatsD. Pour installer la bibliothèque avec PIP, exécutez la commande suivante :

pip install datadog

Selon votre environnement, vous devrez peut-être ajouter la bibliothèque à votre PATH. Consultez le référentiel GitHub datadogpy pour d’autres instructions d’installation.

Configurer Dogshell

Dogshell utilise un fichier de configuration appelé .dogrc pour stocker votre clé d’API, votre clé d’application et votre site Datadog.

Pour configurer Dogshell :

1. Créer un fichier .dogrc dans votre répertoire personnel :

   Copy

   touch ~/.dogrc

2. Ajouter le contenu suivant dans le fichier, en remplaçant MY_API_KEY et MY_APP_KEY par votre clé d’API et votre clé d’application respectivement :

   [Connection]
   apikey = MY_API_KEY
   appkey = MY_APP_KEY
   api_host = 
   

   Vous pouvez créer plusieurs fichiers de configuration si vous devez exécuter des commandes dans différents environnements. Utilisez le flag --config pour spécifier le chemin d'accès à un autre fichier de configuration.

3. Tester la commande dogshell en publiant une métrique de test :

   Copy

   dog metric post test_metric 1

Commandes Dogshell

Utiliser le flag -h pour obtenir la liste complète des commandes Dogshell disponibles :

dog -h

Vous pouvez ajouter l’option -h aux commandes suivantes pour obtenir plus d’informations sur l’utilisation spécifique 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

Pour en savoir plus, consultez le code Dogshell.

Exemple Dogshell

La syntaxe suivante publie une métrique sur votre compte Datadog :

dog metric post MY_METRIC_NAME METRIC_VALUE --tags "TAG_KEY_1:TAG_VALUE_1,TAG_KEY_2:TAG_VALUE_2"

Par exemple, la commande suivante envoie une métrique nommée test_dogshell_metric sur votre compte avec une valeur de 1.0 et les tags test:one et example:one :

dog metric post test_dogshell_metric 1.0 --tags "test:one,example:one"

Une fois la commande exécutée, recherchez test_dogshell_metric dans le Metrics Explorer.