miguelndecarvalho/speedtest-exporter

Speedtest Exporter

镜像概述

Speedtest Exporter是一个用Python编写的简单Prometheus导出器，基于Ookla官方CLI工具实现，用于收集网络速度测试数据（下载速度、上传速度、延迟等）并导出为Prometheus兼容的指标，便于集成到监控系统中。

核心功能和特性

• 官方工具支持：使用Ookla官方CLI进行速度测试，确保测试结果的准确性和权威性
• Prometheus集成：导出标准Prometheus指标格式，可直接被Prometheus抓取
• 轻量设计：基于Python实现，资源占用低，部署简单
• 自动化测试：可配置定期自动执行速度测试，持续收集网络性能数据

使用场景

• 网络性能监控：定期测试网络带宽，监控网络质量波动
• 带宽使用分析：收集历史速度数据，分析网络使用模式和峰值时段
• 监控告警集成：结合Prometheus和Alertmanager，设置网络性能阈值告警
• 多节点监控：在不同网络节点部署，对比各节点网络性能差异

使用方法

基本部署（Docker Run）

bash
docker run -d -p 9112:9112 --name speedtest-exporter miguelndecarvalho/speedtest-exporter

环境变量配置

支持通过环境变量自定义配置：

• PORT：服务监听端口，默认9112
• TEST_INTERVAL：测试间隔（秒），默认300秒（5分钟）
• LOG_LEVEL：日志级别，可选值：DEBUG、INFO、WARNING、ERROR，默认INFO

示例（自定义测试间隔为10分钟）：

bash
docker run -d -p 9112:9112 \
  -e TEST_INTERVAL=600 \
  -e LOG_LEVEL=DEBUG \
  --name speedtest-exporter miguelndecarvalho/speedtest-exporter

Docker Compose配置

yaml
version: '3'
services:
  speedtest-exporter:
    image: miguelndecarvalho/speedtest-exporter
    container_name: speedtest-exporter
    ports:
      - "9112:9112"
    environment:
      - TEST_INTERVAL=300  # 5分钟测试一次
      - LOG_LEVEL=INFO
    restart: unless-stopped

指标访问

服务启动后，可通过以下URL访问Prometheus指标：

http://<容器IP或主机IP>:9112/metrics

文档参考

完整文档请访问：[***]