Présentation
Ce check permet de surveiller Speedtest avec l’Agent Datadog.
Configuration
Le check Speedtest 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 Speedtest 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 la commande suivante pour installer l’intégration de l’Agent :
datadog-agent integration install -t datadog-speedtest==<INTEGRATION_VERSION>
Configurez votre intégration comme une intégration de base.
Remarque : vous devez installer la CLI Speedtest sur chaque host et accepter l’accord en tant qu’utilisateur de l’Agent Datadog (par exemple, sudo -u dd-agent speedtest) pour utiliser l’intégration.
Configuration
Modifiez le fichier speedtest.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 Speedtest. Consultez le fichier d’exemple speedtest.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 speedtest dans la section Checks.
Données collectées
Métriques
speedtest.ping.jitter
(gauge) | Jitter in milliseconds
Shown as millisecond |
speedtest.ping.latency
(gauge) | Latency in milliseconds
Shown as millisecond |
speedtest.download.bandwidth
(gauge) | Download bandwidth in mebibytes per second
Shown as mebibyte |
speedtest.download.bandwidth.bit_per_sec
(gauge) | Download bandwidth in bits per second
Shown as bit |
speedtest.download.bandwidth.byte_per_sec
(gauge) | Download bandwidth in bytes per second
Shown as byte |
speedtest.download.bytes
(gauge) | Download test payload size in bytes
Shown as byte |
speedtest.download.elapsed
(gauge) | Download test elapsed time in milliseconds
Shown as millisecond |
speedtest.upload.bandwidth
(gauge) | Upload bandwidth in mebibytes per second
Shown as mebibyte |
speedtest.upload.bandwidth.bit_per_sec
(gauge) | Upload bandwidth in bits per second
Shown as bit |
speedtest.upload.bandwidth.byte_per_sec
(gauge) | Upload bandwidth in bytes per second
Shown as byte |
speedtest.upload.bytes
(gauge) | Upload test payload size in bytes
Shown as byte |
speedtest.upload.elapsed
(gauge) | Upload test elapsed time in milliseconds
Shown as millisecond |
speedtest.packet_loss
(gauge) | Percentage of packet loss for this test
Shown as percent |
Événements
Le check Speedtest n’inclut aucun événement.
Checks de service
speedtest.run
Returns CRITICAL if the check can’t run the test, or OK results available.
Statuses: ok, critical
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
