快速开始
这一节会启动一个最小可用的实例,监控两个目标并暴露指标。全程不超过五分钟。
第一步:写配置
创建 /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_targetsvcwatch_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"} 0svcwatch_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 会重置计数器。