svcwatch v0.4.2

快速开始

这一节会启动一个最小可用的实例,监控两个目标并暴露指标。全程不超过五分钟。

第一步:写配置

创建 /etc/svcwatch/config.yaml。下面的例子检查一个 HTTP 服务和一个 Redis 端口:

listen: 127.0.0.1:9090
interval: 30s
timeout: 5s
retries: 3

targets:
  - name: web
    type: http
    url: https://example.com/healthz
    expect_status: 200

  - name: cache
    type: tcp
    address: 127.0.0.1:6379

各字段含义见配置文件;retries 表示连续失败多少次才判定为 down,避免网络抖动造成的误报。

第二步:启动

svcwatch run -c /etc/svcwatch/config.yaml

前台运行时日志会输出到 stderr,第一轮检查在启动后立即执行。如果配置有误, svcwatch validate -c ... 会在真正启动前给出具体行号。

第三步:查看指标

curl -s http://127.0.0.1:9090/metrics | grep svcwatch_target
svcwatch_target_up{name="web",type="http"} 1
svcwatch_target_up{name="cache",type="tcp"} 1
svcwatch_target_latency_seconds{name="web",type="http"} 0.084
svcwatch_target_latency_seconds{name="cache",type="tcp"} 0.001
svcwatch_target_failures_total{name="web",type="http"} 0

svcwatch_target_up 为 1 表示当前判定为可用,为 0 表示已触发失败阈值。 注意它反映的是判定结果,不是单次探测的结果。

接入 Prometheus

scrape_configs:
  - job_name: svcwatch
    scrape_interval: 30s
    static_configs:
      - targets: ['127.0.0.1:9090']

建议把 Prometheus 的 scrape_interval 设为与 svcwatch 的 interval 相同或 其整数倍,否则抓取时可能取到上一轮的值,导致图上出现锯齿。

svcwatch 只在内存中保存最近一次判定结果,指标是「当前状态」而非历史。 时间序列由 Prometheus 负责存储,因此重启 svcwatch 会重置计数器。

下一步

按需补充检查类型(检查类型),或者配置通知渠道与 证书到期告警(配置文件)。

© 2026 2190911.xyz · MIT License

文档最后更新:2026 年 11 月