Pour envoyer un check de service à Datadog dans un check d’Agent custom, utilisez la fonction prédéfinie service_check() dans la classe AgentCheck.

self.service_check(name, status, tags=None, hostname=None, message=None)

Retrouvez ci-dessous les différents paramètres et types de données disponibles pour la fonction service_check() :

Exemple

Voici un exemple de check d’Agent test qui envoie régulièrement un seul check de service. Consultez la section Écrire un check custom d’Agent pour en savoir plus.

1. Créez un répertoire service_check_example.d/ dans le dossier conf.d/ de votre Agent.

2. Dans votre dossier service_check_example.d/, créez un fichier de configuration vide service_check_example.yaml avec le contenu suivant :

   instances: [{}]
   

3. Accédez au dossier checks.d/ dans le dossier parent de conf.d/.

4. Dans ce dossier, créez un fichier de check custom service_check_example.py avec le contenu ci-dessous :

   service_check_example.py

   Copy

   from datadog_checks.base import AgentCheck
   
   __version__ = "1.0.0"
   
   class MyClass(AgentCheck):
       def check(self, instance):
           self.service_check('example_service_check', 0, message='Example application is up and running.')
       

5. Redémarrez l’Agent.

6. Vérifiez que votre check custom s’exécute correctement avec la commande status de l’Agent. La sortie devrait ressembler à ceci :

   =========
   Collector
   =========
   
     Running Checks
     ==============
   
       (...)
   
       service_check_example (1.0.0)
       -----------------------------
         Instance ID: service_check_example:d884b5186b651429 [OK]
         Total Runs: 1
         Metric Samples: Last Run: 0, Total: 0
         Events: Last Run: 0, Total: 0
         Service Checks: Last Run: 1, Total: 1
         Average Execution Time : 2ms
   
       (...)
   

7. Enfin, accédez au sommaire des checks de service Datadog pour vérifier que votre check de service envoie bien des données :

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Écrire un check d'Agent customDOCUMENTATION