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.

1. 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>
   

   Copy

2. Configurez votre intégration comme une intégration de base.

Configuration

1. 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.

2. 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

É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.