
jheddings/pingdatping-exporter是一个轻量级Docker镜像,专门用于将网络ping检测结果转换为Prometheus兼容的监控指标。通过定期对指定目标执行ping检测,该镜像能够收集网络延迟、丢包率等关键指标,并通过HTTP端点暴露,供Prometheus采集和后续分析,适用于基础网络监控场景。
拉取镜像(需替换实际镜像仓库地址):
bashdocker pull [镜像仓库地址]/ping-exporter:latest
通过环境变量配置检测参数并启动容器
配置Prometheus采集该容器暴露的指标端点
在Grafana中配置仪表盘可视化指标
镜像通过环境变量接收配置,支持以下核心参数:
| 环境变量 | 描述 | 默认值 | 示例值 |
|---|---|---|---|
| TARGETS | 待检测目标列表(IP或域名,逗号分隔) | 无(必填) | google.com,192.168.1.1 |
| INTERVAL | 检测间隔时间(支持s/m/h单位) | 10s | 5s(5秒)、1m(1分钟) |
| PORT | 指标暴露HTTP端口 | 9110 | 8080 |
| COUNT | 每次检测发送的ICMP包数量 | 4 | 5 |
| TIMEOUT | 单个ping包超时时间(秒) | 2 | 3 |
bashdocker run -d \ --name ping-exporter \ -p 9110:9110 \ -e TARGETS="baidu.com,8.8.8.8,192.168.1.1" \ -e INTERVAL=5s \ -e COUNT=3 \ -e TIMEOUT=1 \ [镜像仓库地址]/ping-exporter:latest
yamlversion: '3' services: ping-exporter: image: [镜像仓库地址]/ping-exporter:latest container_name: ping-exporter ports: - "9110:9110" environment: - TARGETS=google.com,114.114.114.114 - INTERVAL=10s - PORT=9110 restart: unless-stopped
容器启动后,可通过 http://<容器IP>:<PORT>/metrics 访问指标端点,核心指标如下:
| 指标名称 | 类型 | 描述 | 标签 |
|---|---|---|---|
| ping_up | Gauge | 目标可达性(1=可达,0=不可达) | target |
| ping_avg_rtt_seconds | Gauge | 平均往返延迟(秒) | target |
| ping_loss_percent | Gauge | 丢包率(百分比) | target |
| ping_packets_sent_total | Counter | 累计发送的ping包数量 | target |
| ping_packets_received_total | Counter | 累计接收的ping包数量 | target |
ping_up{target="baidu.com"} 1 ping_avg_rtt_seconds{target="baidu.com"} 0.032 ping_loss_percent{target="baidu.com"} 0 ping_packets_sent_total{target="baidu.com"} 120 ping_packets_received_total{target="baidu.com"} 120




manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务