连接观测

连接观测组件用于探测出站代理的连通性（HTTP 或 TCP 连接）。观测结果可供负载均衡器等组件使用。

ObservatoryObject

{
  "subjectSelector": ["outbound"],
  "testUrl": "https://connectivitycheck.gstatic.com/generate_204",
  "interval": "10s",
  "failed": 2,
  "failedInterval": "2s",
  "tcping": false
}

subjectSelector: [ string ]

一个字符串数组，其中每一个字符串将用于和出站代理标识的前缀匹配。在以下几个出站代理标识中：[ "a", "ab", "c", "ba" ]，"subjectSelector": ["a"] 将匹配到 [ "a", "ab" ]。

testUrl: string

用于探测的 URL。HTTP 模式下只要有返回即视为联通，忽略 HTTP 状态码。
TCP 模式下会从该 URL 提取 host:port 进行 TCP 连接测试（http -> 80，https -> 443），也可以直接填写 host:port。

interval: string

每个出站的探测周期。时间格式为数字 + 单位，比如 "10s", "2h45m"，支持的时间单位有 ns, us, ms, s, m, h，分别对应纳秒、微秒、毫秒、秒、分、时。

failed: number

连续失败次数达到该值后标记为 down。

failedInterval: string

第一次失败后，后续重试的间隔时间。连续失败达到 failed 后标记为 down，等待下一次 interval 重新观测；只要有一次成功立即标记为 up。

tcping: true | false

是否启用 TCP ping 模式。为 true 时使用 TCP 连接测试；为 false 时使用 HTTP GET。

TIP

兼容字段：probeURL 可作为 testUrl 的别名，probeInterval 可作为 interval 的别名；failedInterval 也可写作 failed-interval。