Prometheus Speedtest 镜像文档

镜像概述和主要用途

Prometheus Speedtest是一个网络性能监控工具，作为Prometheus导出器，它能够执行Speedtest.net的网络测试，并将测试结果（包括下载速度、上传速度、延迟等）以Prometheus指标格式暴露，便于Prometheus采集、存储和分析，适用于持续监控网络连接质量。

核心功能和特性

• 全面的网络指标：提供下载速度（bit/s）、上传速度（bit/s）、延迟（ms）、接收字节数、发送字节数等关键指标
• Prometheus兼容：指标符合Prometheus规范，可直接被Prometheus采集
• 可配置性：支持自定义监听地址和端口
• 轻量部署：提供Docker镜像，支持快速容器化部署
• 灵活集成：可与Prometheus、Grafana等监控工具链集成，实现数据可视化和告警

使用场景和适用范围

• 家庭网络监控：跟踪家庭网络的实时和历史性能
• 服务器网络性能跟踪：监控服务器的网络连接稳定性
• ISP服务质量评估：评估互联网服务提供商的实际服务质量
• 网络故障排查：通过历史数据定位网络性能波动或故障
• 适用于：DevOps工程师、系统管理员、网络管理员及需要监控网络性能的个人用户

使用方法和配置说明

Docker运行

通过Docker Hub获取镜像并运行：

shell
docker run --rm -d --name prometheus_speedtest -p 9516:9516/tcp jraviles/prometheus_speedtest:latest

配置参数

支持通过命令行参数自定义服务配置：

示例（自定义端口）：

shell
docker run --rm -d --name prometheus_speedtest -p 9000:9000/tcp jraviles/prometheus_speedtest:latest --port 9000

与Prometheus集成

Prometheus配置

在Prometheus配置文件（prometheus.yml）中添加如下配置，实现定期采集网络测试指标：

yaml
global:
  scrape_timeout: 2m  # 网络测试可能需要较长时间，建议设置为2分钟

scrape_configs:
- job_name: 'speedtest'
  metrics_path: /probe
  static_configs:
  - targets:
    - localhost:9516  # Prometheus Speedtest服务地址

Docker网络注意事项

若Prometheus也通过Docker运行，需确保两者在同一网络中：

1. 创建Docker网络：

   shell
   docker network create prometheus_network
   

2. 启动Prometheus Speedtest并加入网络：

   shell
   docker run --rm -d --net prometheus_network --name prometheus_speedtest -p 9516:9516/tcp jraviles/prometheus_speedtest:latest
   

3. 启动Prometheus并加入网络（挂载配置文件）：

   shell
   docker run --rm -d --net prometheus_network -p 9090:9090/tcp -v /path/to/prometheus.yml:/etc/prometheus/prometheus.yml --name prometheus prom/prometheus:latest
   

指标说明

暴露的Prometheus指标如下：

使用cURL测试

服务启动后，可通过cURL或浏览器访问指标端点：

shell
curl localhost:9516/probe

示例输出：

# HELP download_speed_bps Download speed (bit/s)
# TYPE download_speed_bps gauge
download_speed_bps 88016694.95692767
# HELP upload_speed_bps Upload speed (bit/s)
# TYPE upload_speed_bps gauge
upload_speed_bps 3415613.277989314
# HELP ping_ms Latency (ms)
# TYPE ping_ms gauge
ping_ms 20.928
# HELP bytes_received Bytes received during test
# TYPE bytes_received gauge
bytes_received ***.0
# HELP bytes_sent Bytes sent during test
# TYPE bytes_sent gauge
bytes_sent 5242880.0

默认端口说明

默认监听端口为9516，该端口是Prometheus***分配的默认端口（参考Prometheus默认端口分配指南）。