ookla-speedtest-exporter

A Prometheus exporter that runs Ookla's Speedtest CLI and exposes the results as Prometheus metrics on port 9142.

Each Prometheus scrape triggers a live speedtest (~20-40 seconds). Because of this, you must set scrape_timeout in your Prometheus config (see example below). The exporter ensures only one speedtest runs at a time — concurrent scrapes block and share the result.

Environment Variables

Quick Start

docker run -d \
  --name ookla-speedtest-exporter \
  -e TZ=America/New_York \
  -p 9142:9142 \
  ccmpbll/ookla-speedtest-exporter:latest

Docker Compose

services:
  speedtest-exporter:
    image: ccmpbll/ookla-speedtest-exporter:latest
    environment:
      - TZ=America/New_York
    ports:
      - "9142:9142"
    restart: unless-stopped

Prometheus Configuration

scrape_configs:
  - job_name: 'speedtest'
    static_configs:
      - targets: ['speedtest-exporter:9142']
    # Required — speedtest takes 20-40 seconds
    scrape_timeout: 60s
    # Controls how often tests run
    scrape_interval: 1h

Exposed Metrics