superque/smokeping-prober

smokeping_prober

概述

smokeping_prober 是一款 Prometheus 风格的网络延迟探测工具，通过向目标主机发送 ICMP（或 UDP）ping 包，将响应时间记录为 Prometheus 直方图指标，便于监控网络延迟和可用性。支持命令行参数或 YAML 配置文件定义目标，支持动态配置重载，适用于网络性能监控场景。

核心功能与特性

• 多协议支持：支持 ICMP 和 UDP 协议的 ping 探测
• Prometheus 集成：将响应时间、丢包率等指标以 Prometheus 格式暴露
• 灵活配置：支持命令行参数或 YAML 配置文件定义目标和探测参数
• 动态重载：支持通过 SIGHUP 信号或 HTTP POST 请求重载配置
• 自定义参数：可配置探测间隔、数据包大小、网络协议（IPv4/IPv6）等
• 健康检查：提供健康检查接口，便于监控工具集成

使用场景

• 网络设备（路由器、交换机）的延迟监控
• 服务器节点的网络可达性和响应时间监控
• 跨区域/跨数据中心网络性能对比
• 服务依赖的网络链路质量监控

使用方法与配置说明

命令行参数

基本用法：

bash
smokeping_prober [<flags>] [<hosts>...]

主要参数说明：

• --config.file：YAML 配置文件路径（可选）
• --web.listen-address： metrics 暴露地址，默认 :9374（可重复指定多地址）
• --privileged：特权模式运行（ICMP 协议需要）
• -i, --ping.interval：探测间隔，默认 1s（Go 时间格式，如 2s、500ms）
• -s, --ping.size：ping 包大小（字节），默认 56（范围 24-65535）
• --buckets：直方图分桶列表，默认包含从 50µs 到 26s 的 20 个分桶
• --log.level：日志级别，可选 debug/info/warn/error，默认 info

配置文件

支持通过 YAML 配置文件定义目标组及参数，格式示例：

yaml
---
targets:
- hosts:
  - host1.example.com
  - host2.example.com
  interval: 1s          # 探测间隔（默认 1s）
  network: ip           # 网络协议，可选 ip/ip4/ip6（默认自动）
  protocol: icmp        # 探测协议，可选 icmp/udp（默认 icmp，需特权模式）
  size: 56              # 数据包大小（默认 56 字节）
  source: 192.168.1.100 # 源 IP 地址（默认自动选择）

配置重载：配置文件可通过以下方式重载：

• 发送 SIGHUP 信号到进程
• 发送 HTTP POST 请求到 /-/reload 路径

Docker 部署

基本运行

bash
docker run \
  -p 9374:9374 \
  --privileged \
  quay.io/superq/smokeping-prober:latest \
  host1.example.com host2.example.com

使用配置文件

bash
docker run \
  -p 9374:9374 \
  --privileged \
  -v /path/to/config.yaml:/etc/smokeping-prober/config.yaml \
  quay.io/superq/smokeping-prober:latest \
  --config.file=/etc/smokeping-prober/config.yaml

暴露指标

smokeping_prober 暴露以下 Prometheus 指标：

TLS 与基本认证

通过 --web.config.file 参数指定配置文件，可启用 TLS 加密和基本认证。配置文件格式参考 https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md%E3%80%82

健康检查

可通过访问 /-/healthy URI 路径进行健康检查，返回 200 OK 表示服务正常。