命令行
除常驻的 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-format | text | text 或 json |
--target | 全部 | 仅运行指定名称的目标,可重复 |
--no-color | false | 禁用终端颜色输出 |
退出码
脚本里可以根据退出码判断结果,而不必解析输出:
| 退出码 | 含义 |
|---|---|
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