svcwatch v0.4.2

命令行

除常驻的 run 之外,其余子命令都是「执行一次就退出」,适合在 CI 或本地排查时使用。

子命令

命令说明
svcwatch run启动常驻进程,按间隔执行检查并暴露指标端点
svcwatch check执行一轮检查后输出结果并退出,不启动 HTTP 监听
svcwatch validate只校验配置语法与字段合法性
svcwatch version打印版本、提交号与构建时间
svcwatch completion生成 bash / zsh / fish 补全脚本

全局标志

标志默认值说明
-c, --config/etc/svcwatch/config.yaml配置文件路径
--log-level继承配置覆盖日志级别
--log-formattexttext 或 json
--target全部仅运行指定名称的目标,可重复
--no-colorfalse禁用终端颜色输出

退出码

脚本里可以根据退出码判断结果,而不必解析输出:

退出码含义
0所有目标正常
1至少一个目标判定为 down
2配置无效或无法读取
3内部错误(例如端口被占用)

示例

排查阶段只看某一个目标,并把日志调到 debug:

svcwatch check -c ./config.yaml --target web --log-level debug

放进 cron,每五分钟检查一次,失败时通过邮件网关上报:

*/5 * * * * /usr/local/bin/svcwatch check -c /etc/svcwatch/config.yaml \
  && echo ok \
  || /usr/local/bin/svcwatch check -c /etc/svcwatch/config.yaml --log-format json \
     | /usr/bin/mail -s "svcwatch: target down" ops@example.com

配置改动后快速验证语法:

svcwatch validate -c /etc/svcwatch/config.yaml && sudo systemctl reload svcwatch

© 2026 2190911.xyz · MIT License

文档最后更新:2026 年 11 月