svcwatch v0.4.2

检查类型

四类检查共享超时、重试与标签逻辑,差异在于「什么算成功」。

HTTP 检查

发起一次 GET 请求,可校验状态码、响应体正则与证书剩余有效期。

字段默认值说明
url必填目标地址,支持 http 与 https
methodGET请求方法
expect_status200期望状态码;也可写成范围,如 200-299
expect_body空响应体必须匹配的正则表达式
headers空附加请求头,map 形式
tls_expiry_warn空证书剩余有效期低于该时长时置 tls_expiring=1
skip_verifyfalse跳过证书校验,仅用于自签环境
- name: web
  type: http
  url: https://example.com/healthz
  expect_status: 200-299
  expect_body: /"database":"ok"/
  headers:
    Host: example.com
  tls_expiry_warn: 336h

HTTP 检查默认不走系统代理,需要代理时显式设置 proxy 字段。

TCP 检查

仅建立 TCP 连接并立即关闭,用来判断端口是否可达。它不会发送任何应用层数据, 因此对 Redis、MySQL 这类会记录异常输入的协议是安全的。

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

成功时记录握手耗时;失败时错误信息会带上 connection refused、 i/o timeout 等具体原因,便于判断是服务挂了还是网络不通。

命令检查

以子进程方式执行本地命令,通过退出码判定结果。命令不会经过 shell, 参数需以数组形式书写,避免注入问题。

字段默认值说明
command必填字符串数组,第一个元素为可执行文件
expect_exit0期望退出码
env空附加环境变量
user当前用户以指定用户身份执行,需要 root 权限
- name: disk-usage
  type: exec
  command: ["sh", "-c", "test $(df -P / | awk 'NR==2 {print $5}' | tr -d %) -lt 90"]

超时会向进程发送 SIGKILL,不会执行清理逻辑。请不要用 exec 检查 会写磁盘或长时间运行的任务。

DNS 检查

向指定解析器查询记录,校验解析结果中是否包含期望的值。

字段默认值说明
name—同时作为目标标识与查询域名
query目标名实际查询的域名,可与此字段不同
recordAA / AAAA / CNAME / TXT / MX
resolver系统配置形如 1.1.1.1:53
expect_values空结果中必须包含的地址或字符串
- name: api-dns
  type: dns
  query: api.example.com
  record: A
  resolver: 1.1.1.1:53
  expect_values: ["203.0.113.10"]

DNS 检查默认使用 UDP 查询;响应被截断时会自动改用 TCP 重试。

© 2026 2190911.xyz · MIT License

文档最后更新:2026 年 11 月