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

Installez Dogshell

Dogshell est livré avec la datadogpy bibliothèque Python officiellement supportée, qui est 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 datadogpy dépôt GitHub pour des instructions d’installation alternatives.

Configurez Dogshell

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

Pour configurer Dogshell :

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

   Copy

   touch ~/.dogrc

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

   [Connection]
   apikey = MY_API_KEY
   appkey = MY_APP_KEY
   api_host = 
   

   You can create multiple configuration files if you need to run commands against different environments. Use the --config flag to specify the path to an alternative configuration file.

3. Test the dogshell command by posting a test metric:

   Copy

   dog metric post test_metric 1

Dogshell commands

Use the -h flag for a full list of the available Dogshell commands:

dog -h

You can append the -h option to the following commands to get more information on specific Dogshell usage:

• 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

For additional information, see the Dogshell code.

Dogshell example

The following syntax posts a metric to your Datadog account:

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

For example, the following command sends a metric named test_dogshell_metric to your account with a value of 1.0 and the tags test:one and example:one:

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

After you run the command, search for test_dogshell_metric using the Metrics Explorer.