跳到主要内容
版本:0.4 · 当前版

引入模式

概念审阅日期:2026年10月11日
适用于:Excubius 0.4角色: 实体管理员
计划Free · Core · Pro · Enterprise部署自托管

每个数据源(例如 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 时也会对照当前模式进行检查。

每种模式的行为​

PollingWebhook onlyHybrid
是否需要凭据是否是
清单和指标轮询获取无轮询获取
警报按警报间隔轮询通过 Webhook通过 Webhook,并按协调间隔进行协调
Webhook 调用被拒绝并记入审核被接受被接受
数据源保持最新的条件轮询成功最近一天内收到过 Webhook轮询成功
Test在采集器上运行根据已收到的内容立即应答在采集器上运行
Sync now支持不支持支持

轮询的数据源在最近三个最短轮询间隔内成功过,且至少 15 分钟内成功过,就会保持最新。仅 Webhook 的数据源只能显示它上次收到内容的时间,因此一天没有动静就会变为过时。

协调​

协调是对数据源中所有未解决警报的完整列举。数据源不再列出的警报会在 Excubius 中被解决,但有两种例外:

  • 早于数据源自身列举窗口的警报(New Relic 问题和 Azure Monitor 警报为 30 天),只有在数据源明确说明时才会解决。
  • 有人在 Excubius 中手动解决的警报,只要数据源继续报告同一次发生,就不会重新打开。新的发生会触发新的警报。

不会因为一次失败的轮询而解决任何警报,数据源无法访问时也不会凭空生成警报:数据源会变为过时状态并显示错误。

Webhook 如何受到保护​

无论来自哪个数据源,每个 Webhook 终结点都应用同样的规则:

  1. HTTPS 和无法猜测的令牌。 URL 带有一个随机的 256 位令牌,系统只存储它的哈希。完整的 URL 只在生成时显示一次。Rotate URL 会替换它,旧的 URL 立即失效。
  2. 可选的共享机密。 设置 Webhook secret 后,每次调用都必须携带它:可以放在 Authorization: Bearer <secret> 中,作为 Authorization: Basic 的密码,或放在 X-Webhook-Secret 或 X-Custom-Webhook-Secret 中。Azure Monitor 操作组无法添加标头,因此对它们来说,令牌就是凭据。
  3. 限制。 服务器每个 IP 地址每分钟接受 30 次 Webhook 调用,突发上限为 20 次,并拒绝超过 512 KiB 的正文。使用未知令牌得到的应答,与不存在的数据源得到的应答相同。
  4. 先存储,后处理。 有效负载先被存储,再在后台处理。处理失败的有效负载会连同错误一起保留,并重试三次,因此不会因为某个缺陷而丢失任何内容。同一事件的重试(通过数据源的事件 ID 识别)会被接受并丢弃。
  5. 有审核记录。 因为数据源处于轮询模式或已关闭而被拒绝的调用,会在数据源上计数并记入审核。每次更改模式、轮换、测试和同步,都会连同用户和时间写入审核日志。

已接收和已忽略的事件保留 30 天;Settings › Sources 会显示每个数据源的最新事件。

轮询间隔​

每个数据源在 Polling intervals 下都有自己的间隔,单位为秒。将字段留空即使用其默认值:

数据源清单指标警报(轮询)警报协调(混合)
New Relic900300300900
NinjaOne900900300900
Azure Monitor900300300900

最小值为 60 秒,协调间隔最小为 300 秒。每项检查也有自己的间隔,因此指标阶段只运行到期的检查;例如 Key Vault 到期检查每小时读取一次。间隔越低,占用的 API 配额越多:如果数据源上出现 rate limited 错误,说明间隔设得太低。

采集器自己的检查不依赖于模式:它们按目录的间隔运行,范围从 30 秒到 24 小时。