danopstech/speedtest_exporter

Speedtest Prometheus Exporter

镜像概述

Speedtest Prometheus Exporter是一款用于Prometheus的网络速度测试导出器，通过集成Speedtest.net的功能，定期执行网络速度测试，并将测试结果（如下载速度、上传速度、延迟等）暴露为Prometheus可抓取的指标，便于网络性能监控与分析。

核心功能与特性

• 网络指标采集：支持测量下载速度（Bps）、上传速度（Bps）、延迟（秒）及测试执行时长
• 灵活的服务器配置：可指定Speedtest服务器ID，或自动选择最近的服务器；支持服务器不可用时自动回退到可用服务器
• 多架构支持：提供amd64、arm64、armv7架构的Docker镜像
• Prometheus集成：标准Prometheus metrics接口，易于配置抓取
• Grafana可视化：提供官方Grafana仪表盘模板，支持直观展示网络性能数据

使用场景

• 家庭网络性能长期监控
• 企业网络连接质量监测
• ISP服务质量评估
• 网络故障排查与性能趋势分析

使用方法

命令行参数（Flags）

通过命令行参数配置导出器行为，支持以下选项：

bash
$ ./speedtest_exporter --help
Usage of speedtest_exporter
  -port string
        暴露指标的监听端口（默认 "9090"）
  -server_fallback
        当指定的serverID不可用时，是否回退到最近的可用服务器
  -server_id int
        要测试的Speedtest.net服务器ID，-1表示自动选择最近的服务器（默认 -1）

Docker部署

镜像拉取

可从GitHub Container Registry或Dockerhub拉取镜像：

bash
# 从GitHub Container Registry拉取
docker pull ghcr.io/danopstech/speedtest_exporter:latest

# 从Dockerhub拉取
docker pull danopstech/speedtest_exporter:latest

运行容器

基本运行示例（默认配置）：

bash
docker run \
  -p 9090:9090 \
  ghcr.io/danopstech/speedtest_exporter:latest

指定服务器ID并启用回退功能：

bash
docker run \
  -p 9090:9090 \
  ghcr.io/danopstech/speedtest_exporter:latest \
  --server_id 1234 --server_fallback

Prometheus配置

需配置Prometheus抓取该导出器的指标。由于速度测试执行需要时间，需合理设置抓取间隔和超时时间：

yaml
scrape_configs:
  - job_name: 'speedtest'
    scrape_interval: 60m  # 建议每小时执行一次测试
    scrape_timeout: 60s   # 测试超时时间（通常30-60秒）
    static_configs:
      - targets: ['localhost:9090']  # 导出器地址，根据实际部署调整

导出指标说明

Grafana仪表盘

官方提供Grafana仪表盘模板，可直接导入使用：
[***]

仪表盘示例截图：
!https://github.com/danopstech/speedtest_exporter/raw/main/.docs/assets/screenshot.jpg