Nomploy Nomad Packs

← All packs

speedtest-exporter v0.1.0

Observability

Speedtest Exporter — runs periodic internet speed tests and exposes the results as Prometheus metrics for graphing in Grafana. Deployed as a single stateless host-networked Nomad service.

nomad-pack run speedtest-exporter --registry nomploy
…or one line (add registry + run)
curl -fsSL https://packs.nomploy.com/install.sh | sh -s -- speedtest-exporter

Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.

Source ↗ Project ↗ ★ 238 ⚑ Report an issue

1 task http 9798 image ghcr.io/miguelndecarvalho/speedtest-exporter:latest tracks :latest image bumped today
Replaces Speedtest.net
Pairs with grafanamonitoringopenspeedtest
Variables 7
values.hcl

Save as values.hcl, edit, then run:

nomad-pack run speedtest-exporter -f values.hcl --registry nomploy
# The name of the Nomad job.
job_name = "speedtest-exporter"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The Speedtest Exporter container image. Pin a tag in production.
image = "ghcr.io/miguelndecarvalho/speedtest-exporter:latest"

# Host port for the Speedtest Exporter web UI.
port = 9798

# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# The task resources.
resources = {
    cpu    = 300
    memory = 256
  }
NameTypeDefaultDescription
job_name string 
"speedtest-exporter"
 The name of the Nomad job.
namespace string 
"default"
 The Nomad namespace to deploy into.
datacenters list 
["*"]
 The datacenters to deploy to.
image string 
"ghcr.io/miguelndecarvalho/speedtest-exporter:latest"
 The Speedtest Exporter container image. Pin a tag in production.
port number 
9798
 Host port for the Speedtest Exporter web UI.
constraints list 
[]
 Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources object 
{
    cpu    = 300
    memory = 256
  }
 The task resources.
Readme

speedtest-exporter

Speedtest Exporter — runs internet speed tests (via the official Ookla CLI) and exposes the results — download, upload, ping, jitter — as Prometheus metrics. Scrape it on a schedule to graph your connection over time in Grafana.

Single stateless host-networked Nomad service (no volume).

Deploy

nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run speedtest-exporter --registry=nomploy

Configure

Variable Default Description
port 9798 Metrics port (SPEEDTEST_PORT); metrics at /metrics.
image ghcr.io/miguelndecarvalho/speedtest-exporter:latest Container image. Pin a tag in production.
resources { cpu = 300, memory = 256 } Task resources.

A speed test takes ~30s, so scrape it infrequently (e.g. every 15–60 min) — add a Prometheus job with a long scrape_interval and scrape_timeout: 60s pointing at <host>:9798/metrics. Pairs with monitoring and grafana.