跳至主要内容

告警通知(Alerts)

功能說明​

Alerts 頁面允許使用者設定 Webhook 告警規則,當 Security Events 或 Admission Events 中出現符合條件的事件時,K8s Sentinel 會自動透過 HTTP POST 將告警訊息推送至指定的 Webhook URL。訊息內容為 Slack 格式,可直接用於 Slack Incoming Webhook,或任何接受 Slack 格式的服務。


查看告警規則​

進入「Settings → Alerts」頁面後,所有已設定的告警規則會以列表形式呈現。

Alerts 頁面

v0.64 起,Viewer 角色與系統 log 只會看到 Webhook URL 的主機名稱,完整 URL(含其中的 token)僅 Admin 可見。


建立新告警規則​

點擊頁面右上角的「+ New Rule」按鈕,進入告警規則建立頁面。

新增告警規則表單

表單欄位說明:

欄位必填說明
Name✅告警規則的顯示名稱,用於識別此規則的用途
Cooldown (minutes)✅同一規則的最小觸發間隔(分鐘),防止短時間內大量重複推送;預設為 5 分鐘
Webhook URL✅接收告警的 Webhook 端點,例如 Slack Incoming Webhook URL
Event Type-勾選觸發來源:Security Events(Tetragon kprobe 事件)、Admission Events(Admission Policy 違規)
Severity-勾選要觸發告警的嚴重性等級:warning、critical
Namespaces-以逗號分隔的 Namespace 名稱;留空表示監控所有 Namespace
Policies-以逗號分隔的 Policy 名稱;留空表示監控所有 Policy

填寫完成後點擊「Save」儲存告警規則。


告警推送原理​

當新的安全事件進入 K8s Sentinel 且符合告警規則條件時,後端會:

  1. 比對事件的 Namespace、Policy 名稱與嚴重性是否符合規則設定
  2. 檢查是否在 Cooldown 期間內(避免重複推送)
  3. 構建告警訊息 Payload 並以 HTTP POST 方式送出至 Webhook URL

推送節流與重試(v0.51+): 所有事件觸發的告警(Security 與 Admission)都會經過一個有界佇列,交由單一送信程序依序送出:

  • 每個 Webhook 約每秒一則,事件爆量不會變成大量並發 POST 而觸發對方的速率限制
  • 收到 HTTP 429 時依 Retry-After 退避並重試數次;5xx 也會重試(通常是暫時性錯誤);4xx(例如 Webhook 已被刪除)不重試
  • 佇列滿時丟棄並記錄 log,不會無限占用記憶體
  • 手動的「Test」按鈕不經佇列、同步送出,UI 能立即得到成功/失敗結果
Slack 的速率限制是以 App 為單位

兩條規則指向同一個 Slack App 的不同 Webhook URL,仍共用同一個限額。若先前已因爆量進入限流視窗,需等其自然消退。


支援的 Webhook 平台​

K8s Sentinel 送出的告警 Payload 為 Slack 格式,各平台的支援情況如下:

平台支援說明
Slack✅使用 Slack Incoming Webhook URL 即可接收告警訊息
Discord✅在 Discord Webhook URL 結尾加上 /slack,Discord 即會接受 Slack 格式的 Payload
Microsoft Teams❌不支援:Teams 需要自己的卡片格式,無法解讀 Slack 格式的 Payload
提示

建議為不同嚴重性設定不同的告警規則,例如將 critical 等級事件推送至高優先級頻道,warning 等級推送至一般監控頻道,以區分處理優先順序。