clambin/pinger

pinger

!GitHub tag (latest by date) !https://github.com/clambin/pinger/workflows/Build/badge.svg !Codecov !https://goreportcard.com/badge/github.com/clambin/pinger !GitHub

镜像概述和主要用途

pinger 镜像诞生于一个雨天的周日下午，当时ISP再次表现出网络不可靠性。该镜像用于测量一个或多个主机的网络延迟和丢包率，并将采集的数据标准化后暴露给Prometheus，以便进行监控和分析。

核心功能和特性

• 网络质量监测：测量目标主机的延迟（ latency ）和丢包率（ packet loss ）
• 多主机支持：可同时监测一个或多个目标主机
• 灵活配置：支持通过命令行参数或环境变量配置目标主机
• 可定制采集间隔：允许设置测量间隔（默认5秒）
• Prometheus集成：暴露标准Prometheus指标，便于监控系统集成
• 多架构支持：提供arm32和amd64架构的镜像

使用场景和适用范围

• 家庭网络中监控关键设备（如路由器、NAS）的连接状态
• 企业网络中监测服务器、网络设备的可达性和网络质量
• 集成到Prometheus+Grafana监控系统，实现网络质量可视化和告警
• ISP网络质量评估和问题排查

使用方法和配置说明

命令行参数

可通过以下命令行参数配置pinger：

usage: pinger [<flags>] [<hosts>...]

pinger

Flags:
  -h, --help                 显示上下文相关帮助（也可尝试 --help-long 和 --help-man）
  -v, --version              显示应用版本
      --port=8080            指标监听端口
      --endpoint="/metrics"  指标监听端点
      --debug                输出调试日志
      --interval=5s          测量间隔

Args:
  [<hosts>]  要ping的主机

环境变量配置

目标主机也可通过环境变量HOSTS提供，例如：

bash
export HOSTS="127.0.0.1 192.168.0.1 192.168.0.200"

注意：如果同时通过命令行参数和环境变量提供主机，环境变量的配置将优先生效。

Docker部署

docker-compose配置

pinger可通过docker-compose部署：

yaml
version: '2'
services:
    pinger:
        image: clambin/pinger:latest
        container_name: pinger
        command: --interval 5s 192.168.0.1
        ports:
            - 8080:8080/tcp
        restart: unless-stopped

支持的架构

当前提供以下架构的镜像：

• arm32
• amd64

Prometheus指标

pinger向Prometheus暴露以下指标：

• pinger_packet_count：发送的数据包总数
• pinger_packet_loss_count：测量到的丢包总数
• pinger_latency_seconds：测量到的总延迟（秒）

作者

• Christophe Lambin

许可证

本项目采用MIT许可证 - 详见LICENSE.md文件。