Statut d'un check de l'Agent
En cas de problème avec l’un des checks de l’Agent, utilisez ces commandes pour votre système d’exploitation pour obtenir plus d’informations de dépannage :
Remarque : remplacez <NOM_CHECK>
dans les exemples ci-dessous par n’importe quel check de l’Agent. Par exemple : activemq
, ceph
ou elastic
. Consultez la documentation de l’intégration pour vérifier le nom du check de l’Agent.
Remarque : pour désactiver temporairement un check de service lors du dépannage, renommez /conf.d/<NOM_CHECK>.d/conf.yaml
de façon à utiliser une extension de fichier autre .yaml
ou .yml
, par exemple conf.yaml.disable
.
Linux
Pour tester un check de l’Agent, exécutez :
sudo -u dd-agent datadog-agent check <NOM_CHECK>
Si vous souhaitez inclure des métriques rate, ajoutez --check-rate
à votre commande. Par exemple, pour l’Agent v6.x, exécutez :
sudo -u dd-agent datadog-agent check <NOM_CHECK> --check-rate
sudo -u dd-agent dd-agent check <NOM_CHECK>
Remplacez <NOM_CHECK>
par n’importe quel check de l’Agent. Par exemple : activemq
, ceph
ou elastic
. Consultez la [documentation de l’intégration][4] pour vérifier le nom du check de l’Agent.
Si vous souhaitez inclure des métriques rate, ajoutez --check-rate
à votre commande. Par exemple, pour l’Agent v6.x, exécutez :
sudo -u dd-agent dd-agent check <NOM_CHECK> --check-rate
Si le problème persiste, contactez l’équipe d’assistance Datadog en envoyant un flare.
Windows
Exécutez le script suivant depuis une ligne de commande PowerShell avec élévation des privilèges (en tant qu’administrateur), en utilisant le <NOM_CHECK>
approprié :
Pour les versions >= 6.12 de l’Agent :
& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" check <NOM_CHECK>
Pour les versions <= 6.11 de l’Agent :
& "$env:ProgramFiles\Datadog\Datadog Agent\embedded\agent.exe" check <NOM_CHECK>
L’installation de l’Agent inclut un fichier appelé shell.exe
dans votre répertoire Program Files
pour l’Agent Datadog. Ce fichier peut être utilisé pour exécuter Python dans l’environnement de l’Agent. Une fois que votre check (appelé <NOM_CHECK>
) est écrit et que les fichiers .py
et .yaml
sont aux emplacements appropriés, exécutez la commande shell.exe suivante :
from checks import run_check
run_check('<NOM_CHECK>')
Cela permet d’afficher toutes les métriques ou tous les événements que le check renvoie.
Exécutez le script suivant depuis une ligne de commande PowerShell avec élévation des privilèges (en tant qu’administrateur), en utilisant le <NOM_CHECK>
approprié :
<RÉPERTOIRE_INSTALLATION>/embedded/python.exe <RÉPERTOIRE_INSTALLATION>agent/agent.py check <NOM_CHECK>
Par exemple, pour exécuter le check Disk :
& "$env:ProgramFiles\Datadog\Datadog Agent\embedded\python.exe" "$env:ProgramFiles\Datadog\Datadog Agent\agent\agent.py" check disk
Systemd
Pour les systèmes qui utilisent systemd, utilisez journalctl
pour faciliter le debugging.
La commande suivante affiche le statut de l’Agent Datadog.
sudo systemctl status datadog-agent
Si l’Agent ne parvient pas à démarrer et qu’aucune information supplémentaire n’est fournie, utilisez la commande suivante pour afficher l’ensemble des logs associés au service de l’Agent Datadog. Utilisez -r
pour afficher les logs dans l’ordre inverse si vous le souhaitez.
sudo journalctl -u datadog-agent.service
La commande suivante affiche le statut de l’Agent Datadog.
sudo systemctl status dd-agent
Si l’Agent ne parvient pas à démarrer et qu’aucune information supplémentaire n’est fournie, utilisez la commande suivante pour afficher l’ensemble des logs associés au service de l’Agent Datadog. Utilisez -r
pour afficher les logs dans l’ordre inverse si vous le souhaitez.
sudo journalctl -u dd-agent.service
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles: