热门搜索:
czerwonk/ping_exporter
自动构建
czerwonk
用于ICMP回显请求的Prometheus导出器，基于digineo/go-ping库，通过HTTP暴露ICMP请求的往返时间、丢包率等指标供Prometheus采集。
4 次收藏下载次数: 0状态：自动构建维护者：czerwonk仓库类型：镜像最近更新：13 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
ping_exporter
概述和主要用途
Prometheus导出器，用于ICMP回显请求（ping）监控，基于digineo/go-ping库开发。该服务通过采集ICMP请求的统计数据（如往返时间、丢包率等），并通过HTTP接口暴露指标供Prometheus采集，适用于网络连通性和性能监控场景。
核心功能和特性
- 支持IPv4和IPv6目标的ICMP回显请求
- 通过YAML配置文件定义监控目标，支持域名（自动解析为A和AAAA记录）
- 可配置DNS刷新间隔和自定义DNS服务器，覆盖系统默认 resolver
- 灵活的ping参数配置：间隔、超时时间、历史记录大小、ICMP负载大小
- 导出丰富指标：最佳/最差/平均往返时间（RTT）、RTT标准差、丢包率等
- 支持不同时间单位（毫秒/秒）及双单位并存，便于迁移和兼容性处理
- 包含健康状态指标（ping_up），指示导出器运行状态和版本
使用场景和适用范围
适用于需要通过Prometheus监控网络性能的场景，可监控目标主机、IP或域名的网络连通性、往返时间和丢包情况，广泛应用于网络设备监控、服务器可达性检测等运维监控场景。
详细使用方法和配置说明
配置文件
监控目标和参数可通过YAML配置文件指定，示例如下：
yamltargets: - 8.8.8.8 # IPv4目标 - 8.8.4.4 - 2001:4860:4860::8888 # IPv6目标 - 2001:4860:4860::8844 - google.com # 域名（自动解析为IPv4/IPv6） dns: refresh: 2m15s # DNS记录刷新间隔 nameserver: 1.1.1.1 # 自定义DNS服务器（可选，默认使用系统resolver） ping: interval: 2s # ping间隔时间 timeout: 3s # 超时时间 history-size: 42 # 历史记录大小（用于计算统计值） payload-size: 120 # ICMP包负载大小（字节）
说明：域名会定期解析为对应的A（IPv4）和AAAA（IPv6）记录。默认使用系统resolver解析域名，可通过--dns.nameserver参数指定自定义DNS服务器，例如：
console# 使用Cloudflare公共DNS服务器 ./ping_exporter --dns.nameserver=1.1.1.1:53 [其他选项]
导出的指标
| 指标名称 | 描述 | 标签 |
|---|---|---|
ping_rtt_best_ms | 最佳往返时间（毫秒） | ip（目标IP）、ip_version（4/6）、target（目标名称） |
ping_rtt_worst_ms | 最差往返时间（毫秒） | 同上 |
ping_rtt_mean_ms | 平均往返时间（毫秒） | 同上 |
ping_rtt_std_deviation_ms | RTT标准差（毫秒） | 同上 |
ping_loss_percent | 丢包率（百分比） | 同上 |
ping_up | 导出器运行状态（版本信息） | - |
时间单位配置
默认情况下，RTT指标以毫秒（ms）为单位，不符合Prometheus建议的秒为单位的规范。可通过--metrics.rttunit参数调整：
console# 保持毫秒单位（默认） ./ping_exporter --metrics.rttunit=ms [其他选项] # 使用秒为单位 ./ping_exporter --metrics.rttunit=s [其他选项] # 同时导出毫秒和秒单位指标（便于迁移） ./ping_exporter --metrics.rttunit=both [其他选项]
兼容旧指标
旧版本导出的ping_rtt_ms指标（含type标签，值为best/worst/mean/std_dev）默认仍会导出，但未来可能移除。可通过--metrics.deprecated参数控制：
console# 启用旧指标 ./ping_exporter --metrics.deprecated=enable [其他选项] # 禁用旧指标 ./ping_exporter --metrics.deprecated=disable [其他选项]
命令行运行
直接运行二进制
console# 指定目标列表 ./ping_exporter [选项] 目标1 目标2 ... # 使用配置文件 ./ping_exporter --config.path 配置文件路径 [选项] # 查看帮助 ./ping_exporter --help
测试指标采集
通过curl获取指标：
consolecurl http://localhost:9427/metrics
Docker部署
Docker镜像地址：https://hub.docker.com/r/czerwonk/ping_exporter
基本运行命令
consoledocker run -p 9427:9427 -v /本地配置目录:/config:ro --name ping_exporter czerwonk/ping_exporter
说明：
-p 9427:9427：映射容器的9427端口（默认暴露端口）到主机-v /本地配置目录:/config:ro：挂载本地配置目录到容器的/config目录（只读），配置文件需放在该目录下并命名为config.yml（或通过--config.path指定路径）
贡献
通过fork仓库并提交pull request参与贡献，项目维护者会尽快响应。
许可证
MIT许可证，版权所有 (c) 2018 Philip Berndroth pberndro 和 Daniel Czerwonk dan_nrw
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 ping_exporter 镜像标签
docker pull docker.xuanyuan.run/czerwonk/ping_exporter:<标签>
DockerHub 原生拉取命令
docker pull czerwonk/ping_exporter:<标签>
更多 ping_exporter 镜像推荐
czerwonk/bird_exporter
czerwonk
为bird路由守护进程提供指标导出功能，用于Prometheus监控系统收集路由协议状态、前缀计数、协议运行时间等关键指标。
100万+ 次下载
4 年前更新
czerwonk/junos_exporter
czerwonk
用于运行JunOS系统设备的Prometheus指标导出器，通过SSH高效收集网络设备性能数据（如接口流量、BGP状态、告警等），替代通用SNMP导出器以提升监控性能和简洁性。
1 次收藏50万+ 次下载
13 天前更新
czerwonk/ovirt_exporter
czerwonk
用于将oVirt引擎指标导出到Prometheus的Exporter
5万+ 次下载
13 天前更新
czerwonk/atlas_exporter
czerwonk
用于RIPE Atlas测量结果的指标导出器，支持DNS、Ping、Traceroute等多种测量类型，可将结果转换为Prometheus指标，提供流式API实时更新和直方图功能，便于网络性能监控与服务级别目标评估。
1万+ 次下载
13 天前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"