跳至主要内容
版本:0.4 · 現行版

變更閾值及關閉檢查

操作指南審閱日期:2026年10月11日
適用於:Excubius 0.4角色: 編輯者, 實體管理員
方案Free · Core · Pro · Enterprise部署自行託管

每項檢查都從其目錄項目的基線開始。你在合適的位置變更它:在實體上變更,使其下的每個資源都跟隨;或在屬於例外的單一資源上變更。本指南說明這兩種做法、如何還原為繼承的值,以及如何關閉檢查或其中一個等級。

開始之前​

  • 若要變更某個資源上的檢查,你需要在該資源所屬實體上擁有 Editor(編輯者)或更高的角色。
  • 若要設定實體預設值,你需要在該實體上擁有 Entity admin(實體管理員)角色。
  • 了解值的來源:基線,然後是從根實體往下的每個實體,最後是資源。最具體的值優先。請參閱閾值與基線。
提示

請盡量在實體樹的較高層設定值,只覆蓋例外情況。在 桃花島物流 › Production 上設定一次的預設值,會涵蓋之後新增到該處的每部伺服器。

等級的寫法​

每項檢查都有一個 Warning 等級和一個 Critical 等級。每個等級包含:

部分值
Operator>、>=、<、<=、==、!=、in、not_in、matches
Value以檢查的單位表示的數字(單位顯示在欄位旁邊),或 in 和 not_in 使用的清單
For選用。條件必須持續多久,警報才會開啟,例如 30s、15m、1h 或 1d。它可以吸收短暫的尖峰;恢復則是即時的

有些檢查比較的是狀態,而不是把值與限制比較,例如可用性群組複本的健康狀態。它們的規則來自目錄,編輯器會說明這一點,而不會顯示等級。

變更單一資源的閾值​

  1. 開啟資源並選取 Checks 索引標籤。使用 Search checks 或 Only problems 找到該檢查。
  2. 選取檢查所在行的鉛筆圖示,即 Edit。對話方塊會顯示檢查的識別碼、它的基線和目前的等級。
  3. 對於每個要變更的等級,保持選取 This level raises alerts,並輸入 Operator、Value,必要時輸入 For。例如,對於 sql-ventas-01 上的 Page life expectancy(sqlserver.ple_seconds),把 Warning level 設為 < 900,持續 10m。
  4. 選取 Save。

該行現在會顯示新的等級,並標示 (this resource)。你沒有變更的等級會保留其繼承的值。

若要還原為繼承的值,請再次開啟對話方塊並選取 Back to inherited thresholds。只有當資源有自己的值時,才會出現這個按鈕。

設定實體的預設值​

  1. 開啟 Settings › Entities。
  2. 開啟實體的動作選單,例如 Production,然後選取 Threshold defaults。面板會列出這個實體自己設定的檢查;其他所有檢查則由它繼承。
  3. 在 Set a default for a check 下,選擇檢查,例如 CPU utilization (SQL process)(sqlserver.cpu_percent),然後選取 Add。
  4. 對於每個等級,選擇:
    • Inherit:保留來自上層的設定。
    • Set here:輸入 Operator、Value 和 For,例如 > 75,持續 15m。
    • Turn off here:此等級在這個實體及其下不會產生警報。
  5. 選取 Save。

實體之下的每個資源現在都使用該預設值,除非較低層的實體或資源變更了它。在每個資源的 Checks 索引標籤上,等級會顯示它來自哪個實體。

若要移除預設值,請選取它旁邊的垃圾桶圖示,即該檢查的 Remove the default of。其下的資源隨後會再次從更上層繼承。

關閉檢查​

在單一資源上,開啟 Checks 索引標籤,並在 On 欄中關閉該檢查,或在檢查的對話方塊中清除 Check runs。檢查會停止在該資源上執行,並列為 Off,因此不會有人忘記它的存在。要重新開啟,請用同樣的方法。

若要讓檢查在整個實體上都不發出警報,請開啟其 Threshold defaults,新增該檢查,並把 Warning level 和 Critical level 都設為 Turn off here。檢查會繼續在其下的每個資源上執行並記錄值,但不會在那裏產生警報。對於在某個分支中沒有意義的檢查,請使用這個方法,例如在沒有報表伺服器的地方,報表伺服器的檢查。

變更檢查的執行頻率​

在檢查的對話方塊中,輸入 Interval,範圍為 10s 至 7d,例如 30s、5m 或 1h。留空則使用目錄的間隔,欄位中會顯示該間隔。已變更的間隔會在該行標示為 changed。

使用 API 完成​

透過 API 進行的每項變更都遵循相同的角色,並寫入稽核記錄。$BASE 是 https://<your server>/api/v1,H 保存你的權杖;請參閱快速入門:使用 API 新增 SQL Server 實例。

工作請求
查看有效等級,以及每個等級的來源GET /resources/{id}/checks
設定單一資源的等級PATCH /resources/{id}/checks/{check_id},附帶 thresholds
還原為繼承的等級相同的 PATCH,附帶 "thresholds": null
關閉或開啟檢查相同的 PATCH,附帶 "enabled": false 或 true
變更間隔相同的 PATCH,附帶 "interval_seconds",範圍為 10 至 604800
查看實體自己的預設值GET /entities/{id}/thresholds
設定實體預設值PUT /entities/{id}/thresholds/{check_id}
移除實體預設值DELETE /entities/{id}/thresholds/{check_id}

等級覆蓋值可以包含的鍵有 warn、crit、expect、window 和 sigma。設為 null 的鍵會在該等級關閉該部分。

# one resource: warn when page life expectancy stays under 900 s for 10 minutes
curl -s "${H[@]}" -X PATCH "$BASE/resources/$SQL01/checks/sqlserver.ple_seconds" \
-d '{"thresholds": {"warn": {"op": "<", "value": 900, "for": "10m"}}}' | jq .thresholds

# the Production entity: CPU warning above 75% for 15 minutes, no critical level
curl -s "${H[@]}" -X PUT "$BASE/entities/$PROD/thresholds/sqlserver.cpu_percent" \
-d '{"warn": {"op": ">", "value": 75, "for": "15m"}, "crit": null}'