Présentation
Ce check utilise la commande ping système pour tester l’accessibilité d’un host.
Il peut également mesurer la durée des aller-retour des messages envoyés par le check au host de destination.
La commande ping envoie des paquets de demande d’écho du protocole Internet Control Message Protocol (ICMP)
au host cible. Elle attend ensuite une réponse d’écho ICMP.
Ce check utilise la commande ping système au lieu de générer la demande d’écho du protocole ICMP. En effet, la création d’un paquet ICMP nécessite un socket brut, ce qui requiert des privilèges root que l’Agent ne détient pas. La commande ping utilise le flag d’accès setuid pour s’exécuter avec une élévation des privilèges afin d’éviter ce problème.
Configuration
Le check Ping n’est pas inclus avec le package de l’Agent Datadog : vous devez donc l’installer.
Installation
Pour l’Agent v7.21+/6.21+, suivez les instructions ci-dessous afin d’installer le check Ping sur votre host. Consultez la section Utiliser les intégrations de la communauté pour effectuer une installation avec l’Agent Docker ou avec des versions antérieures de l’Agent.
Exécutez l’une des commandes suivantes pour installer l’intégration de l’Agent :
# Linux
datadog-agent integration install -t datadog-ping==<INTEGRATION_VERSION>
# Windows
agent.exe integration install -t datadog-ping==<INTEGRATION_VERSION>
Configurez votre intégration comme une intégration de base.
Configuration
Modifiez le fichier ping.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance Ping. Consultez le fichier d’exemple ping.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Redémarrez l’Agent.
Validation
Lancez la sous-commande status de l’Agent et cherchez ping dans la section Checks.
Données collectées
Métriques
network.ping.response_time
(gauge) | The response time of a given host and ping port, tagged with url, e.g. 'host:192.168.1.100'.
Shown as millisecond |
network.ping.can_connect
(gauge) | Value of 1 if the agent can successfully communicate with the target host, 0 otherwise |
Événements
Le check Ping n’inclut aucun événement.
Checks de service
network.ping.can_connect
Returns CRITICAL if the Agent cannot communicate with the target host. Returns OK if the ping is successful.
Statuses: ok, critical
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
