告警規則
告警規則會在超過你設定的門檻時通知你:伺服器或服務持續忙碌,或者日誌反覆出現同一個錯誤。它是內建通知之外的補充,內建通知所有方案都保留。Pro 及以上方案包含告警規則:Pro 最多 20 條,Team 最多 100 條。
新增規則
團隊擁有者和管理員開啟 帳號設定 → 告警規則(作用於側邊欄中選取的團隊),點選 新增規則,然後選擇監控對象:
| 監控對象 | 門檻 | 觸發條件 |
|---|---|---|
| 伺服器 CPU | 所有核心合計的百分比 | 最近 N 分鐘的每個取樣都不低於門檻 |
| 伺服器記憶體 | 使用百分比 | 同上 |
| 伺服器磁碟 | 使用百分比 | 同上 |
| 服務 CPU | vCPU,所有執行個體合計(1 vCPU = 一個核心) | 同上 |
| 服務記憶體 | MiB,所有執行個體合計 | 同上 |
| 日誌行 | 行數 | 最近 N 分鐘內至少有這麼多行日誌包含這段文字 |
N 為 1 到 60 分鐘。監控大約每分鐘取樣一次,所以取樣要涵蓋整個時間範圍,規則才會觸發:沉寂一段時間後突然出現的一個高值不算。伺服器停止回報時(例如離線),規則保持原狀態;這種情況由內建的 伺服器離線 通知負責。
日誌行 規則監控專案中的一個服務,或者所有服務。比對在變數值遮蔽之後進行,文字出現在行內任何位置都算,不分大小寫。日誌在寫出時即時計數;規則不會保存日誌,告警裡也不會包含日誌內容。
規則每分鐘檢查一次。清單會顯示每條規則最近的值,條件成立期間顯示 告警中。修改規則後,它會重新開始判斷。新增、修改和刪除規則都會記入稽核日誌。
告警
規則觸發時,會向團隊發出 告警規則觸發:寄信給開啟了這項通知的成員(和其他通知一樣,擁有者和管理員預設開啟),並發到訂閱了這項通知的團隊頻道。條件不再成立時,會再發一則 已恢復。
每條規則每小時最多告警一次。一小時內再次觸發時,主控台會顯示 告警中,但不會發送通知,也不會發送恢復訊息。
告警會寫明規則名稱、監控對象、條件和觀測值,例如 期間最低 86% 或 符合 14 行。告警裡絕不包含日誌內容、變數值或密鑰。
方案
在不含告警規則的方案上,頁面會說明哪個方案包含它。團隊換到這樣的方案後,規則會保留:不再檢查,仍然可以修改、關閉或刪除,但不能開啟或新增。團隊回到 Pro 或 Team 後,規則會自動恢復檢查。
API
| 方法 | 路徑 | |
|---|---|---|
GET POST | /api/teams/{tid}/alert-rules | 列出規則,或新增一條:{kind, name, threshold, window_minutes};server_cpu、server_memory、server_disk 需要 server_id;service_cpu(毫核)和 service_memory(MiB)需要 project_id 和 service;log_match 需要 project_id、pattern,service 可選 |
PATCH DELETE | /api/teams/{tid}/alert-rules/{rid} | 修改除 kind 以外的任何欄位或 enabled;刪除 |
方案不包含告警規則時,新增或開啟規則會返回 402 和 plan_required。