引入模式
每个数据源(例如 New Relic、NinjaOne 或 Azure Monitor)都以三种模式之一向 Excubius 提供数据:Polling(轮询)、Webhook only(仅 Webhook)或 Hybrid(混合)。模式决定警报到达的速度、Excubius 是否需要该数据源的凭据,以及除了警报之外它是否还能获得清单和指标。本文介绍每种模式及其适用场景。
三种模式
| 模式 | 工作方式 | 优势 | 劣势 | 适用场景 |
|---|---|---|---|---|
| Polling | 采集器使用只读凭据,按计划向数据源的 API 请求清单、指标和警报 | 不会有任何内容从外部进入。停机后可以补上遗漏的数据。可获得清单和指标 | 警报会在轮询间隔内出现。会占用 API 配额 | 数据源无法访问此服务器:没有公共地址,或不允许入站流量 |
| Webhook only | 数据源把警报推送到 Webhook URL。不进行轮询,也不存储凭据 | 警报立即到达。完全不需要 API 凭据 | 没有清单,也没有指标。此服务器停机期间发送的警报会丢失 | 你可以向数据源提供 URL,但不能提供 API 凭据 |
| Hybrid | 用 Webhook 接收警报,另外轮询清单和指标,并定期对警报进行协调 | 即时且可自我修复:如果某条警报在 Webhook 丢失期间已在数据源中关闭,下一次协调会将其解决 | API 用量略多 | 数据源可以调用此服务器,并且你可以向它提供只读凭据。推荐的默认设置 |
添加数据源时,你在 Settings › Sources 中选择模式,并且可以随时更改,无需重启:采集器会在 30 秒内应用更改,每次调用 Webhook 时也会对照当前模式进行检查。
每种模式的行为
| Polling | Webhook only | Hybrid | |
|---|---|---|---|
| 是否需要凭据 | 是 | 否 | 是 |
| 清单和指标 | 轮询获取 | 无 | 轮询获取 |
| 警报 | 按警报间隔轮询 | 通过 Webhook | 通过 Webhook,并按协调间隔进行协调 |
| Webhook 调用 | 被拒绝并记入审核 | 被接受 | 被接受 |
| 数据源保持最新的条件 | 轮询成功 | 最近一天内收到过 Webhook | 轮询成功 |
| Test | 在采集器上运行 | 根据已收到的内容立即应答 | 在采集器上运行 |
| Sync now | 支持 | 不支持 | 支持 |
轮询的数据源在最近三个最短轮询间隔内成功过,且至少 15 分钟内成功过,就会保持最新。仅 Webhook 的数据源只能显示它上次收到内容的时间,因此一天没有动静就会变为过时。
协调
协调是对数据源中所有未解决警报的完整列举。数据源不再列出的警报会在 Excubius 中被解决,但有两种例外:
- 早于数据源自身列举窗口的警报(New Relic 问题和 Azure Monitor 警报为 30 天),只有在数据源明确说明时才会解决。
- 有人在 Excubius 中手动解决的警报,只要数据源继续报告同一次发生,就不会重新打开。新的发生会触发新的警报。
不会因为一次失败的轮询而解决任何警报,数据源无法访问时也不会凭空生成警报:数据源会变为过时状态并显示错误。
Webhook 如何受到保护
无论来自哪个数据源,每个 Webhook 终结点都应用同样的规则:
- HTTPS 和无法猜测的令牌。 URL 带有一个随机的 256 位令牌,系统只存储它的哈希。完整的 URL 只在生成时显示一次。Rotate URL 会替换它,旧的 URL 立即失效。
- 可选的共享机密。 设置 Webhook secret 后,每次调用都必须携带它:可以放在
Authorization: Bearer <secret>中,作为Authorization: Basic的密码,或放在X-Webhook-Secret或X-Custom-Webhook-Secret中。Azure Monitor 操作组无法添加标头,因此对它们来说,令牌就是凭据。 - 限制。 服务器每个 IP 地址每分钟接受 30 次 Webhook 调用,突发上限为 20 次,并拒绝超过 512 KiB 的正文。使用未知令牌得到的应答,与不存在的数据源得到的应答相同。
- 先存储,后处理。 有效负载先被存储,再在后台处理。处理失败的有效负载会连同错误一起保留,并重试三次,因此不会因为某个缺陷而丢失任何内容。同一事件的重试(通过数据源的事件 ID 识别)会被接受并丢弃。
- 有审核记录。 因为数据源处于轮询模式或已关闭而被拒绝的调用,会在数据源上计数并记入审核。每次更改模式、轮换、测试和同步,都会连同用户和时间写入审核日志。
已接收和已忽略的事件保留 30 天;Settings › Sources 会显示每个数据源的最新事件。
轮询间隔
每个数据源在 Polling intervals 下都有自己的间隔,单位为秒。将字段留空即使用其默认值:
| 数据源 | 清单 | 指标 | 警报(轮询) | 警报协调(混合) |
|---|---|---|---|---|
| New Relic | 900 | 300 | 300 | 900 |
| NinjaOne | 900 | 900 | 300 | 900 |
| Azure Monitor | 900 | 300 | 300 | 900 |
最小值为 60 秒,协调间隔最小为 300 秒。每项检查也有自己的间隔,因此指标阶段只运行到期的检查;例如 Key Vault 到期检查每小时读取一次。间隔越低,占用的 API 配额越多:如果数据源上出现 rate limited 错误,说明间隔设得太低。
采集器自己的检查不依赖于模式:它们按目录的间隔运行,范围从 30 秒到 24 小时。