检查类型
四类检查共享超时、重试与标签逻辑,差异在于「什么算成功」。
HTTP 检查
发起一次 GET 请求,可校验状态码、响应体正则与证书剩余有效期。
| 字段 | 默认值 | 说明 |
|---|---|---|
url | 必填 | 目标地址,支持 http 与 https |
method | GET | 请求方法 |
expect_status | 200 | 期望状态码;也可写成范围,如 200-299 |
expect_body | 空 | 响应体必须匹配的正则表达式 |
headers | 空 | 附加请求头,map 形式 |
tls_expiry_warn | 空 | 证书剩余有效期低于该时长时置 tls_expiring=1 |
skip_verify | false | 跳过证书校验,仅用于自签环境 |
- name: web
type: http
url: https://example.com/healthz
expect_status: 200-299
expect_body: /"database":"ok"/
headers:
Host: example.com
tls_expiry_warn: 336hHTTP 检查默认不走系统代理,需要代理时显式设置 proxy 字段。
TCP 检查
仅建立 TCP 连接并立即关闭,用来判断端口是否可达。它不会发送任何应用层数据, 因此对 Redis、MySQL 这类会记录异常输入的协议是安全的。
- name: cache
type: tcp
address: 127.0.0.1:6379成功时记录握手耗时;失败时错误信息会带上 connection refused、
i/o timeout 等具体原因,便于判断是服务挂了还是网络不通。
命令检查
以子进程方式执行本地命令,通过退出码判定结果。命令不会经过 shell, 参数需以数组形式书写,避免注入问题。
| 字段 | 默认值 | 说明 |
|---|---|---|
command | 必填 | 字符串数组,第一个元素为可执行文件 |
expect_exit | 0 | 期望退出码 |
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 | 目标名 | 实际查询的域名,可与此字段不同 |
record | A | A / 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 重试。