= Pong :sectnums: :toc: :toc-placement!:
使用Rust语言实现的监听目标运行状态的 Prometheus exporter 的插件。
toc::[]
== 概述
使用Rust语言实现的监听目标运行状态的 Prometheus exporter 的插件。目前实现的功能如下:
- 模仿ping使用ICMP协议发送数据包，轮询目标进程状态，并返回结果
- 启动Web服务，提供接口给 Prometheus Server 采集数据
== 功能特性
- Rust语言跨平台编译，支持Windows、Linux、MacOS
- Prometheus exporter 的插件
- ICMP协议发送ping数据包
- 异步架构，性能高，占内存和CPU资源低，稳定
== 环境要求
- Rust工具链 (https://www.rust-lang.org/tools/install[安装Rust])
- Cargo包管理器 (随Rust一同安装)
- 可选: 跨平台编译工具链 (https://github.com/cross-rs/cross)
== 安装说明
克隆代码仓库并进入项目目录：
[source,bash]
git clone cd pong
构建项目：
[source,bash]
cargo build
== 开发相关
以开发模式运行：
[source,bash]
cargo run
运行测试：
[source,bash]
cargo test
检查代码问题：
[source,bash]
cargo check
== 编译相关
编译为Linux x86_64下的可执行文件：
[source,bash]
cargo build --release --target x86_64-unknown-linux-musl
== 部署相关
=== Supervisor方式
- 初始化
./etc/supervisord.conf [source,ini]
....
[include] files = supervisord.d/*.ini
创建日志目录： + [source,shell]
mkdir -p /var/log/pong/
./etc/supervisord.d/pong.ini [source,ini]
[program:pong] directory = /root/opt/pong/ command = /root/opt/pong/pong autostart = true startsecs = 10 autorestart = true startretries = 100000 stdout_logfile = /var/log/pong/pong.log
- supervisord 服务管理
[,shell]
重启服务
systemctl restart supervisord
查看服务启动状态
systemctl status supervisord
配置 supervisord 开机自启
systemctl enable supervisord
- supervisor 进程管理（监听/启动/停止/重启）
[source,shell]
查看所有进程的状态
supervisorctl status
停止 pong
supervisorctl stop pong
启动 pong
supervisorctl start pong
重启 pong
supervisorctl restart pong
配置文件修改后可以使用该命令加载新的配置
supervisorctl update
重新启动配置中的所有程序
supervisorctl reload
- 查看日志输出
[source,shell]
supervisorctl tail -f pong stderr
=== 检查服务是否正常运行
[,shell]
curl 127.0.0.1:9780/health
=== 手动获取服务指标