本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 Grafana 受管警示規則
<a name="v10-alerting-configure-grafanamanaged"></a>

****  
本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Grafana 受管規則是最靈活的提醒規則類型。它們可讓您建立提醒，以對來自我們任何支援資料來源的資料採取行動。除了支援多個資料來源之外，您還可以新增表達式來轉換資料並設定提醒條件。也支援在提醒通知中使用映像。這是允許在單一規則定義中從多個資料來源發出提醒的唯一規則類型。

一個提醒規則 （也稱為多維提醒） 可以建立多個提醒執行個體。

只有具有儲存規則之資料夾編輯許可的使用者，才能編輯或刪除 Grafana 受管警示規則。

如果您刪除在 UI 中建立的提醒資源，則無法再擷取它。若要備份您的組態並能夠還原已刪除的提醒資源，請使用 Terraform 或提醒 API 建立提醒資源。

在下列程序中，我們將完成建立 Grafana 受管提醒規則的程序。

若要建立 Grafana 受管警示規則，請使用工作區內警示建立流程，並依照下列步驟協助您。

**設定提醒規則名稱**

1. 選擇**提醒** -> **提醒規則** -> **\$1 新提醒規則**。

1. 輸入名稱以識別您的提醒規則。

   此名稱會顯示在提醒規則清單中。它也是從此規則建立的每個提醒執行個體的`alertname`標籤。

接著，定義查詢以取得您要測量的資料，以及在警示規則觸發之前需要滿足的條件。

**定義查詢和條件**

1. 選取資料來源。

1. 從**選項**下拉式清單中，指定[時間範圍](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range)。
**注意**  
Grafana 警示僅支援固定的相對時間範圍，例如 `now-24hr: now`。  
它不支援絕對時間範圍： `2021-12-02 00:00:00 to 2021-12-05 23:59:592`或半相對的時間範圍：`now/d to: now`。

1. 新增查詢。

   若要新增多個[查詢](v10-panels-query-xform.md#v10-panels-query-xform-add)，請選擇**新增查詢**。

   根據預設，所有提醒規則都會由 Grafana 管理。如果您想要切換到資料來源受管提醒規則，請按一下**切換到資料來源受管提醒規則**。

1. 新增一或多個[表達式](v10-panels-query-xform-expressions.md)。

   1. 針對每個表達式，選取 **Classic 條件**以建立單一提醒規則，或從**數學**、**減少**和**重新取樣**選項中選擇，為每個序列產生個別提醒。
**注意**  
使用 Prometheus 時，您可以使用即時向量和內建函數，因此您不需要新增其他表達式。

   1. 選擇**預覽**以驗證表達式是否成功。

1. 【選用】 若要新增復原閾值，請開啟**自訂復原閾值**開關，並填入提醒規則何時應停止觸發的值。

   您只能在查詢中新增一個復原閾值，而且必須是提醒條件。

1. 在要**設定為提醒條件**的查詢或表達式上，選擇設定為提醒條件。

使用警示規則評估來判斷應評估警示規則的頻率，以及應變更其狀態的速度。

若要這樣做，您需要確保您的提醒規則位於正確的評估群組中，並設定最適合您的使用案例的等待期間。

**設定提醒評估行為**

1. 選取資料夾，或選擇 **\$1 新增資料夾**。

1. 選取評估群組或按一下 **\$1 新增評估群組**。

   如果您要建立新的評估群組，請指定群組的間隔。

   相同群組中的所有規則都會在相同的時間間隔內同時評估。

1. 輸入擱置期間。

   擱置期間是警示規則在觸發之前可能違反條件的期間。

   滿足條件後，提醒會進入**待**定狀態。如果條件在指定的持續時間內保持作用中，警示會轉換為**射擊**狀態，否則會恢復為**正常**狀態。

1. 如有需要，請開啟暫停提醒通知。
**注意**  
暫停警示規則評估，以防止調校警示時發出嘈雜警示。暫停會停止警示規則評估，而不會建立任何警示執行個體。這與靜音時序不同，這會停止傳送通知，但仍允許提醒規則評估和建立提醒執行個體。  
您可以暫停警示規則評估，以防止調校警示時發出嘈雜警示。暫停會停止警示規則評估，而不會建立任何警示執行個體。這與靜音時序不同，這會停止傳送通知，但仍允許提醒規則評估和建立提醒執行個體。

1. 在**設定無資料和錯誤處理**中，設定缺少資料的提醒行為。

   使用本節稍後的指導方針。

將標籤新增至提醒規則，以設定應處理發射提醒執行個體的通知政策。

所有提醒規則和執行個體，無論其標籤為何，都符合預設通知政策。如果沒有巢狀政策，或沒有巢狀政策符合警示規則或警示執行個體中的標籤，則預設通知政策是相符政策。

**若要設定通知**

1. 如果您想要變更通知的路由方式，請新增標籤。

   從下拉式清單中選取現有的鍵/值對來新增自訂標籤，或輸入新的鍵或值來新增標籤。

1. 預覽您的提醒執行個體路由設定。

   根據新增的標籤，提醒執行個體會路由到顯示的通知政策。

   展開每個通知政策以檢視更多詳細資訊。

1. 選擇**查看詳細資訊**以檢視提醒路由詳細資訊和預覽。

新增[註釋](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations)，以在提醒通知訊息中提供警示的更多內容。

註釋會新增中繼資料，以在提醒通知訊息中提供提醒的詳細資訊。例如，新增**摘要**註釋，告訴您哪個值導致警示觸發，或其發生於哪個伺服器。

**新增註釋**

1. 【選用】 新增摘要。

   發生的情況及其原因的簡短摘要。

1. 【選用】 新增描述。

   提醒規則執行的操作說明。

1. 【選用】 新增 Runbook URL。

   您保留提醒執行手冊的網頁

1. 【選用】 新增自訂註釋

1. 【選用】 新增儀表板和面板連結。

   將警示連結到儀表板中的面板。

1. 選擇**儲存規則**。

**單一和多維度規則**

對於 Grafana 受管警示，您可以建立具有傳統條件的規則，也可以建立多維度規則。
+ **具有傳統條件的規則**

  使用傳統條件表達式建立規則，在滿足其條件時觸發單一提醒。對於傳回多個序列的查詢，Grafana 不會追蹤每個序列的提醒狀態。因此，即使多個序列符合提醒條件，Grafana 也會僅傳送單一提醒。
+ **多維度規則**

  若要為每個系列產生個別的提醒，請建立多維度規則。使用 `Math`、 `Reduce`或 `Resample`表達式來建立多維度規則。例如：
  + 為每個查詢新增`Reduce`運算式，將所選時間範圍中的值彙總為單一值 ([使用數值資料的規則](v10-alerting-overview-numeric.md)不需要）。
  + 新增具有規則條件的`Math`表達式。如果規則不應觸發，`0`則查詢或減少表達式已傳回，或者如果應該觸發，則傳回正數，則不需要。一些範例：`$B > 70`如果應該在 B 查詢/表達式的值大於 70 時觸發。如果 B `$B < $C * 100` 的值小於 C 的值乘以 100，則應該觸發。如果比較的查詢在其結果中有多個序列，則不同查詢的序列如果具有相同的標籤，或其中一個是另一個序列的子集，則會相符。

**注意**  
Grafana 不支援具有範本變數的提醒查詢。如需詳細資訊，請參閱 https：//[https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514)。

**設定沒有資料和錯誤處理**

當您的警示規則評估未傳回資料或發生錯誤時，設定警示行為。

**注意**  
設定為在評估未傳回資料或錯誤時觸發的警示規則，只會在評估期間的整個持續時間結束時觸發。這表示警示規則不會在違反警示規則條件時立即觸發，而是會等到設定為 **For** 欄位的時間完成，然後觸發、減少警示雜訊，並允許暫時資料可用性問題。

如果您的提醒規則評估未傳回任何資料，您可以將提醒規則上的狀態設定為如下所示：


| 無資料 | Description | 
| --- | --- | 
| 無資料 | 使用提醒規則DatasourceNoData的名稱和 UID，以及未以標籤形式傳回資料之資料來源的 UID，建立新的提醒。 | 
| 提醒 | 將警示規則狀態設定為 Alerting。警示規則會等到 For 欄位中設定的時間完成再觸發。 | 
| 確定 | 將警示規則狀態設定為 Normal。 | 

如果您的評估傳回錯誤，您可以將警示規則的狀態設定為 ，如下所示：


| 錯誤 | Description | 
| --- | --- | 
| 錯誤 | 建立警示執行個體，DatasourceError其中包含警示規則的名稱和 UID，以及未以標籤形式傳回資料之資料來源的 UID。 | 
| 提醒 | 將警示規則狀態設定為 Alerting。警示規則會等到 For 欄位中設定的時間完成再觸發。 | 
| 確定 | 將警示規則狀態設定為 Normal。 | 

**解決過時提醒執行個體**

如果警示執行個體的維度或序列完全從查詢結果中消失兩個評估間隔，則視為過時。

處於 `Alerting`/`NoData`/`Error` 狀態的過時提醒執行個體會自動標記為 ，`Resolved`並將`grafana_state_reason`註釋新增至具有原因 的提醒執行個體`MissingSeries`。

**從面板建立提醒**

從任何面板類型建立提醒。這表示您可以重複使用面板中的查詢，並根據這些查詢建立提醒。

1. 導覽至儀表板區段中的**儀表板**。

1. 在面板的右上角，選擇三個點 （省略號）。

1. 從下拉式功能表中選取**更多...**，然後選擇**新增提醒規則**。

這會開啟提醒規則表單，讓您可以根據目前面板的查詢來設定和建立提醒。