sping 项目使用教程

sping 项目使用教程

sping Split ping, see what direction the loss or latency is on 项目地址: https://gitcode.com/gh_mirrors/sp/sping

1. 项目目录结构及介绍

sping/
├── icmp-timestap-pinger/
├── icmp/
├── vendor/
├── .gitignore
├── LICENSE
├── README.md
├── go.mod
├── go.sum
├── main.go
├── ntp/
├── pps/
├── pps_linux/
├── pps_other/
├── prom/
├── sessionhandle/
├── timecorrection/

目录结构介绍

• icmp-timestap-pinger/: 包含与ICMP时间戳ping相关的代码。
• icmp/: 包含与ICMP协议相关的代码。
• vendor/: 包含项目的依赖库。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• go.mod: Go模块文件，定义项目的依赖。
• go.sum: Go模块文件，记录依赖的校验和。
• main.go: 项目的启动文件。
• ntp/: 包含与NTP时间同步相关的代码。
• pps/: 包含与PPS（Pulse Per Second）输入相关的代码。
• pps_linux/: 包含与Linux平台PPS输入相关的代码。
• pps_other/: 包含与其他平台PPS输入相关的代码。
• prom/: 包含与Prometheus监控相关的代码。
• sessionhandle/: 包含与会话处理相关的代码。
• timecorrection/: 包含与时间校正相关的代码。

2. 项目启动文件介绍

main.go

main.go 是项目的启动文件，负责初始化和启动 sping 工具。以下是 main.go 的主要功能：

• 初始化配置: 读取命令行参数和配置文件，初始化工具的运行参数。
• 启动监听: 启动监听服务，接收来自其他主机的ping请求。
• 处理ping请求: 处理接收到的ping请求，计算延迟和丢包率。
• 输出结果: 将处理结果输出到命令行或Web界面。

3. 项目的配置文件介绍

sping 项目没有明确的配置文件，配置主要通过命令行参数进行。以下是常用的命令行参数：

• -clock-is-perfect: 启用用户空间校准，使用Apple的GPS NTP服务器（默认启用）。
• -debug-showslots: 显示接收到的数据包延迟槽。
• -debug-showstats: 显示每个ping请求的信息和时间戳。
• -listenAddr: 监听地址（默认是 [::]:6924）。
• -peers: 指定对等节点的IP地址列表。
• -pps-debug: 启用PPS输入的调试输出。
• -pps-path: 指定使用的PPS设备路径（默认是 /dev/pps0）。
• -udp-pps: 指定最大入站PPS的处理能力（默认是100）。
• -use-pps: 是否使用PPS设备代替系统时钟。
• -web-listen-address: 暴露指标和Web界面的地址（默认是 [::]:9523）。
• -web-telemetry-path: 暴露指标的路径（默认是 /metrics）。

通过这些命令行参数，用户可以灵活配置 sping 工具的运行方式。

sping Split ping, see what direction the loss or latency is on 项目地址: https://gitcode.com/gh_mirrors/sp/sping