常见问题
汇总一些在实际部署中反复被问到的问题。
它和 systemd watchdog 有什么区别?
watchdog 关心的是「进程还活着并且按时上报心跳」,而 svcwatch 关心的是 「这个服务对外提供的功能是否正常」。一个进程仍在运行、但数据库连接池已经耗尽的 Web 服务, 在 watchdog 看来是健康的,在 svcwatch 看来则不是。
两者互补:watchdog 负责拉起崩溃的进程,svcwatch 负责发现功能退化并通知人。
为什么指标看起来有 2 倍 interval 的延迟?
因为 retries 需要一个确认窗口。以 interval: 30s 和
retries: 3 为例,服务真正挂掉后,指标不会立刻变成 0,而是先在内部累加失败次数,
连续三次失败后才翻转 svcwatch_target_up。这大约需要 90 秒。
如果需要更快感知,可以降低 interval 或 retries,
但代价是误报率上升。对于跨机房探测,建议保持 3 次以上的确认窗口。
exec 检查需要什么权限?
默认以运行 svcwatch 的用户身份执行。要检查只有 root 才能读取的内容
(例如 dmesg、其他用户的家目录),可以在目标上设置 user: root,
这要求 svcwatch 本身以 root 运行。
更稳妥的做法是给 svcwatch 配置有限的 sudo 规则,或者把检查逻辑封装成一个带 setuid 的小脚本, 而不是让整个守护进程拥有 root 权限。
修改配置一定要重启吗?
不需要。发送 SIGHUP 会重新读取并校验配置,成功后原子替换。
校验失败时保留旧配置,进程继续运行——这是为了避免因为一个手误让监控自己先挂掉。
但如果改的是 listen 地址或端口,由于需要重新绑定套接字,仍然需要重启。
支持 Windows 或 macOS 吗?
macOS 有构建产物,主要用于本地开发调试;Windows 暂不支持,
因为 exec 检查的语义(进程组、信号)与类 Unix 系统差异较大。
如果只需要 HTTP/TCP 检查,可以用 WSL 或容器运行。
目标很多时会有性能问题吗?
每轮检查是并发的,默认并发上限为 32,可通过 max_concurrency 调整。
一百个目标、间隔 30 秒的场景在单核 512MB 的机器上大约占用 20MB 常驻内存,
瓶颈通常在目标侧而不是 svcwatch 本身。
数据存在哪里?
不存。svcwatch 没有数据库,重启后所有计数归零。历史数据完全依赖 Prometheus 抓取, 因此指标端点必须保持可抓取状态,否则这段时间的数据就永久缺失了。