An exporter for monitoring file download speeds. When you request the /probe endpoint, the exporter downloads a file from the URL and returns download statistics.

• probe_success - download success (1 = success, 0 = error)
• probe_duration_seconds - download time
• probe_http_status_code - HTTP status code (200, 404, 500...)
• download_speed_bytes_per_second - download speed in bytes/sec
• download_content_length_bytes - file size (from Content-Length)

Create config file:

cp .env.example .env

Start the exporter:

docker compose up -d

The exporter will be available at http://localhost:9138

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python exporter.py

docker build -t download-speed-exporter .
docker run -p 9138:9138 download-speed-exporter

Manual test:

curl "http://localhost:9138/probe?target=http://speedtest.tele2.net/10MB.zip&timeout=30"

Example output:

probe_success 1.0
probe_duration_seconds 0.758
probe_http_status_code 200.0
download_speed_bytes_per_second 1.38e+06
download_content_length_bytes 1.048576e+06

The exporter supports configuration via environment variables (see .env.example):

scrape_configs:
  - job_name: 'download-speed'
    scrape_interval: 10m
    scrape_timeout: 50s
    metrics_path: /probe
    params:
      timeout: ['40']
    static_configs:
      - targets:
          - http://speedtest.tele2.net/10MB.zip
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: <exporter_host>:9138

• target (required) - URL of the file to download
• timeout (optional, default DEFAULT_TIMEOUT) - download timeout in seconds

Incoming traffic is often free, but constantly loading the network is not recommended. Here are traffic usage calculations:

# Average download speed over the last hour
avg_over_time(download_speed_bytes_per_second[1h])

# Convert to Mbps
download_speed_bytes_per_second * 8 / 1000000

# Percentage of successful checks
avg_over_time(probe_success[1h]) * 100

# All checks with errors (not 200 OK)
probe_http_status_code{job="download-speed"} != 200

# Number of 404 errors in the last hour
count_over_time((probe_http_status_code == 404)[1h:])

Ready-to-use dashboard is in grafana/download-speed.json.

1. Open Grafana → Dashboards → Import
2. Upload grafana/download-speed.json file or copy its content
3. Select Prometheus datasource in the "Select a Prometheus data source" field
4. Click Import
5. Set the correct job in Grafana Variables and save it as default value. Otherwise graphs may capture metrics from blackbox_exporter due to identical metric names (probe_success, probe_duration_seconds).

• Hetzner (Germany): https://fsn1-speed.hetzner.com/
• Tele2 (EU): http://speedtest.tele2.net/
• OVH (France): https://proof.ovh.net/files/