引入模式
每個數據源(例如 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,舊的 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 小時。