Overview

This check monitors Speedtest through the Datadog Agent.

Setup

The Speedtest check is not included in the Datadog Agent package, so you need to install it.

Installation

For Agent v7.21+ / v6.21+, follow the instructions below to install the Speedtest check on your host. See Use Community Integrations to install with the Docker Agent or earlier versions of the Agent.

1. Run the following command to install the Agent integration:

   datadog-agent integration install -t datadog-speedtest==<INTEGRATION_VERSION>
   

   Copy

2. Configure your integration similar to core integrations.

Note: For all hosts, you need to install the Speedtest CLI and accept the agreement as the Datadog Agent user prior to use, for example: sudo -u dd-agent speedtest.

Configuration

1. Edit the speedtest.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your Speedtest performance data. See the sample speedtest.d/conf.yaml for all available configuration options.

2. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for speedtest under the Checks section.

Data Collected

Metrics

Events

The Speedtest check does not include any events.

Service Checks

speedtest.run
Returns CRITICAL if the check can’t run the test, or OK results available.
Statuses: ok, critical

Troubleshooting

Need help? Contact Datadog support.