jheddings/pingdat

镜像概述

ping-exporter是一个轻量级Docker镜像，专门用于将网络ping检测结果转换为Prometheus兼容的监控指标。通过定期对指定目标执行ping检测，该镜像能够收集网络延迟、丢包率等关键指标，并通过HTTP端点暴露，供Prometheus采集和后续分析，适用于基础网络监控场景。

核心功能与特性

• ping检测自动化：支持对多个目标主机/IP执行定期ping检测
• Prometheus指标暴露：将ping结果转换为标准Prometheus指标格式（如延迟、丢包率、可达性）
• 灵活配置：支持自定义检测目标、间隔时间、发包数量等参数
• 轻量级设计：镜像体积小，资源占用低，适合边缘环境或资源受限场景
• 即插即用：无需复杂依赖，通过环境变量即可完成基础配置

使用场景

• 网络设备监控：监控路由器、交换机等网络设备的连通性
• 服务可用性检测：对核心业务服务的IP/域名执行基础网络层健康检查
• 跨区域网络质量监测：部署在不同区域，监控跨区域网络延迟
• Prometheus监控体系集成：作为网络监控指标的数据源，与Grafana等工具联动构建可视化仪表盘

使用方法

基本部署流程

1. 拉取镜像（需替换实际镜像仓库地址）：

   bash
   docker pull [镜像仓库地址]/ping-exporter:latest
   

2. 通过环境变量配置检测参数并启动容器

3. 配置Prometheus采集该容器暴露的指标端点

4. 在Grafana中配置仪表盘可视化指标

配置参数

镜像通过环境变量接收配置，支持以下核心参数：

部署示例

Docker Run 示例

bash
docker 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

Docker Compose 示例

yaml
version: '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{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