本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # Grafana 提醒 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 Grafana 提醒可為您提供強大且可行的提醒，協助您了解系統發生後瞬間的問題，將服務中斷降至最低。 Amazon Managed Grafana 包含對更新的提醒系統 *Grafana 提醒*的存取權，該系統會在單一可搜尋檢視中集中提醒資訊。它包含下列功能： + 在集中式檢視中建立和管理 Grafana 提醒。 + 透過單一界面建立和管理 Cortex 和 Loki 受管提醒。如需詳細資訊，請參閱[管理您的提醒規則](v9-alerting-managerules.md)。 + 檢視來自 Prometheus、Amazon Managed Service for Prometheus 和其他 Alertmanager 相容資料來源的提醒資訊。 + 從單一提醒規則建立多個提醒執行個體。如需詳細資訊，請參閱[單一和多維度規則](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule)。 + 使用 terraform 或佈建 APIs管理您的提醒資源。如需詳細資訊，請參閱[佈建 Grafana 警示資源](v9-alerting-setup-provision.md)。 對於現有的 Amazon Managed Grafana 工作區，預設值為 [傳統儀表板提醒](old-alerts-overview.md)。若要遷移至 Grafana 提醒，您必須[遷移至 Grafana 提醒](alert-opt-in.md)。 若要進一步了解 Grafana 提醒，請參閱 [Grafana 提醒的新功能](alerts-whats-new.md)。 Grafana 提醒有四個關鍵元件： + [警示規則](alert-rules.md) - 判斷是否啟動警示的評估條件。它包含一或多個查詢和表達式、條件、評估頻率，以及選擇滿足條件的持續時間。 + [聯絡點](alert-contact-points.md) - 在符合提醒規則條件時傳送通知的管道。 + [通知政策](alert-notifications.md) - 用於判斷通知頻率的一組比對和分組條件。 + [靜音](alert-silences.md) - 用於靜音通知的日期和相符條件。 啟用 Grafana 警示時，您可以： + [建立 Grafana 受管提醒規則](alert-rules.md#create-grafana-alert-rule) + [建立 Cortex 或 Loki 受管提醒規則](alert-rules.md#create-alert-rule) + [檢視現有的提醒規則並管理其目前狀態](alert-rules.md#manage-alert-rules) + [檢視提醒規則的狀態和運作狀態](alert-fundamentals.md#alerts-state) + [新增或編輯提醒聯絡點](alert-contact-points.md#alert-working-contact-points) + [新增或編輯通知政策](alert-notifications.md#alert-notifications-working) + [新增或編輯靜音](alert-silences.md) ## 限制 + Grafana 提醒系統可以從所有可用的 Amazon Managed Service for Prometheus、Prometheus、Loki 和 Alertmanager 資料來源擷取規則。它可能無法從其他支援的資料來源擷取規則。 + 在 Grafana 中定義的提醒規則，而不是在 Prometheus 中，將多個通知傳送到您的聯絡點。如果您使用的是原生 Grafana 提醒，建議您保持傳統儀表板提醒，不要啟用新的 Grafana 提醒功能。如果您想要檢視 Prometheus 資料來源中定義的提醒，建議您啟用 Grafana 提醒，這只會針對在 Prometheus Alertmanager 中建立的提醒傳送單一通知。 **注意** 此限制不再是支援 Grafana v10.4 和更新版本的 Amazon Managed Grafana 工作區的限制。 **Topics** + [限制](#alert-limitations) + [Grafana 提醒的新功能](alerts-whats-new.md) + [將傳統儀表板提醒遷移至 Grafana 提醒](alert-opt-in.md) + [警示基本概念](alert-fundamentals.md) + [建立和管理 Grafana 提醒規則](alert-rules.md) + [警示群組](alert-groups.md) + [Prometheus 資料來源的靜音提醒通知](alert-silences.md) + [使用聯絡點](alert-contact-points.md) + [使用訊息範本](alert-message-templates.md) + [使用通知政策](alert-notifications.md) # Grafana 提醒的新功能 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 相較於傳統儀表板提醒，Grafana 提醒具有數個增強功能。 ## 建立多維提醒 您現在可以建立單一提醒規則，為您提供整個系統的可見性，從單一提醒規則產生多個提醒執行個體。例如，您可以建立規則來監控單一主機上多個掛載點的磁碟使用情況。評估引擎會從單一查詢傳回多個時間序列，並以其標籤集識別每個時間序列。 **注意** 每個提醒執行個體都會計入提醒配額。不會評估建立超過警示配額內可容納之執行個體的多維度規則，並傳回配額錯誤。如需詳細資訊，請參閱[配額達到錯誤](alert-rules.md#rule-quota-reached)。 ## 在儀表板外部建立提醒 與傳統儀表板提醒不同，透過 Grafana 提醒，您可以建立查詢和表達式，以獨特的方式結合來自多個來源的資料。您仍然可以使用儀表板和面板的 ID 將儀表板和面板連結至提醒規則，並快速對受觀察的系統進行故障診斷。 由於統一警示不再直接繫結至面板查詢，因此不會在通知電子郵件中包含影像或查詢值。您可以使用自訂通知範本來檢視查詢值。 ## 建立 Loki 和 Cortex 警示規則 在 Grafana 提醒中，您可以使用與 Grafana 受管提醒相同的 UI 和 API 來管理 Loki 和 Cortex 提醒規則。 ## 從 Amazon Managed Service for Prometheus 和其他 Prometheus 相容資料來源檢視和搜尋提醒 Amazon Managed Service for Prometheus 和 Prometheus 相容資料來源的提醒現在會列在提醒界面中。您可以跨多個資料來源搜尋標籤，以快速尋找相關提醒。 ## 警示狀態 NoData 和 Error 的特殊提醒 當警示規則評估產生狀態`NoData`或 時，Grafana 警示會產生具有下列標籤的特殊警示`Error`： + `alertname` 值為 `DatasourceNoData`或 `DatasourceError`，視狀態而定。 + `rulename` 具有特殊提醒所屬的提醒規則名稱。 + `datasource_uid` 具有造成 狀態之資料來源的 UID。 + 原始規則的所有標籤和註釋。 您可以像一般提醒一樣處理這些提醒，例如新增靜音或轉接到聯絡點。 **注意** 如果規則使用多個資料來源，且一或多個 未傳回任何資料，則會為每個造成警示狀態的資料來源建立特殊提醒。 # 將傳統儀表板提醒遷移至 Grafana 提醒 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 現有的工作區，或選擇不使用 Grafana 提醒的工作區，請使用傳統儀表板提醒。若要遷移至新的 Grafana 提醒，您必須選擇加入 功能。 您可以將 Amazon Managed Grafana 執行個體設定為使用 AWS 管理主控台、 AWS CLI或 Amazon Managed Grafana API 來使用 Grafana 提醒。如需如何設定 Amazon Managed Grafana 的詳細資訊，包括開啟或關閉 Grafana 提醒，請參閱 [設定 Amazon Managed Grafana 工作區](AMG-configure-workspace.md)。 **注意** 使用 Grafana 提醒時，提醒規則是在 Grafana 中定義的，而不是在 Prometheus 中，傳送多個通知到您的聯絡點。如果您使用的是原生 Grafana 提醒，建議您保持傳統儀表板提醒，不要啟用新的 Grafana 提醒功能。如果您想要檢視 Prometheus 資料來源中定義的提醒，建議您啟用 Grafana 提醒，這只會針對在 Prometheus Alertmanager 中建立的提醒傳送單一通知。 此限制會在支援 Grafana v10.4 和更新版本的 Amazon Managed Grafana 工作區中移除。 ## 遷移至 Grafana 提醒系統 開啟 Grafana 提醒時，現有的傳統儀表板提醒會以與 Grafana 提醒相容的格式遷移。在 Grafana 執行個體的提醒頁面中，您可以檢視遷移的提醒以及新的提醒。透過 Grafana 提醒，您的 Grafana 受管提醒規則會在符合時傳送多個通知，而不是單一提醒。 傳統儀表板提醒和 Grafana 提醒的讀取和寫入存取權受存放它們的資料夾許可所管理。在遷移期間，傳統儀表板提醒許可會與新規則許可相符，如下所示： + 如果原始提醒的儀表板具有許可，遷移會建立名為 且具有此格式的資料夾`Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}`，以符合原始儀表板的許可 （包括來自資料夾的繼承許可）。 + 如果沒有儀表板許可，且儀表板位於資料夾下，則規則會連結至此資料夾並繼承其許可。 + 如果沒有儀表板許可，且儀表板位於一般資料夾下，則規則會連結至一般提醒資料夾，且規則會繼承預設許可。 **注意** 由於 Grafana 提醒`NoData`中沒有 `Keep Last State`的選項，此選項會在傳統規則遷移`NoData`期間變成 。`Keep Last State` `Error` 處理選項會遷移至新的選項 `Error`。為了符合 的行為`Keep Last State`，在這兩種情況下，在遷移期間，Amazon Managed Grafana 會自動為每個警示規則建立靜音，持續時間為一年。 通知通道會使用適當的路由和接收者遷移至 Alertmanager 組態。預設通知通道會新增為預設路由的聯絡點。與任何儀表板提醒無關的通知管道會前往`autogen-unlinked-channel-recv`路由。 ### 限制 + Grafana 提醒系統可以從所有可用的 Prometheus、Loki 和 Alertmanager 資料來源擷取規則。它可能無法從其他支援的資料來源擷取提醒規則。 + 在 Grafana 提醒和傳統儀表板提醒之間來回遷移可能會導致一個系統支援的功能資料遺失，但另一個系統則不會遺失資料。 **注意** 如果您遷移回傳統儀表板提醒，則會遺失在啟用 Grafana 提醒時對提醒組態所做的所有變更，包括建立的任何新提醒規則。 # 警示基本概念 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 本節提供有關 Grafana 提醒的基本概念的資訊。 ## 警示概念 下表說明 Grafana 警示中的重要概念。 | 關鍵概念或功能 | 定義 | | --- | --- | | 警示的資料來源 | 選取您要從中查詢和視覺化指標、日誌和追蹤的資料來源。 | | 排程器 | 評估您的提醒規則；定期對資料來源執行查詢的元件。它僅適用於 Grafana 受管規則。 | | 警示管理員 | 管理警示執行個體的路由和分組。 | | 警示規則 | 警示規則應何時觸發的一組評估條件。提醒規則包含一或多個查詢和表達式、條件、評估頻率，以及滿足條件的持續時間。提醒規則可以產生多個提醒執行個體。 | | 警示執行個體 | 警示執行個體是警示規則的執行個體。單維提醒規則有一個提醒執行個體。多維提醒規則具有一或多個提醒執行個體。符合多個結果的單一警示規則，例如針對 10 個 VMs CPU，會計入多個 （在此案例中為 10) 警示執行個體。此數字可能會隨著時間而變化。例如，在新增 VMs 時，監控系統中所有 VM CPU VMs提醒執行個體。如需警示執行個體配額的詳細資訊，請參閱 [配額達到錯誤](alert-rules.md#rule-quota-reached)。 | | 警示群組 | Alertmanager 預設會使用根通知政策的標籤來將警示執行個體分組。這可控制傳送至聯絡點的重複資料刪除和警示執行個體群組。 | | 聯絡點 | 定義警示規則觸發時如何通知您的聯絡人。 | | 訊息範本 | 建立可重複使用的自訂範本，並將其用於聯絡點。 | | 通知政策 | 警示分組和路由至聯絡點的位置、時間和方式的一組規則。 | | 標籤和標籤比對器 | 標籤可唯一識別提醒規則。它們將提醒規則連結至通知政策和靜音，決定哪些政策應該處理它們，以及哪些提醒規則應該靜音。 | | 靜音 | 停止來自一或多個提醒執行個體的通知。靜音和靜音計時之間的差異在於靜音會持續一段指定的時段，其中靜音計時發生在週期性排程上。使用標籤比對器來靜音提醒執行個體。 | | 靜音計時 | 指定您不希望產生或傳送新通知的時間間隔。您可以凍結重複期間的提醒通知，例如在維護期間。必須連結到現有的通知政策。 | ## 警示資料來源 Grafana 受管提醒會查詢下列已啟用提醒的後端資料來源。 + 由 Grafana 內建或開發和維護的資料來源：`Alertmanager``Graphite`、、 `Prometheus`（包括 Amazon Managed Service for Prometheus)`Loki`、、、`InfluxDB``Amazon OpenSearch Service`、`Google Cloud Monitoring`、`Amazon CloudWatch`、、`Azure Monitor``MySQL`、`PostgreSQL`、 `MSSQL` `OpenTSDB``Oracle`和 `Azure Monitor`。 ## 數值資料的提醒 非時間序列格式的數值資料可以直接發出提醒或傳遞至伺服器端表達式。這可讓您在資料來源內獲得更多的處理和產生的效率，也可以簡化提醒規則。提醒數值資料而非時間序列資料時，不需要將每個標記的時間序列減少為單一數字。反之，標記的數字會傳回給 Grafana。 ### 表格式資料 查詢表格式資料的後端資料來源支援此功能，包括 SQL 資料來源，例如 MySQL、Postgres、MSSQL 和 Oracle。 具有 Grafana 受管警示或伺服器端表達式的查詢會被視為具有下列資料來源的數值： + 如果 `Format AS`選項在資料來源查詢`Table`中設定為 。 + 如果從查詢傳回給 Grafana 的資料表回應只包含一個數值 （例如 int、Double 或 float) 資料欄，以及選擇性的額外字串資料欄。 如果有字串欄，則這些欄會變成標籤。資料欄的名稱會變成標籤名稱，而每一列的值會變成對應標籤的值。如果傳回多個資料列，則每個資料列都應由其標籤唯一識別。 ### 範例 如果您有名為 Diskspace 的 MySQL 資料表，如下所示。 | 時間 | 主機 | Disk | PercentFree | | --- | --- | --- | --- | | 2021-June-7 | Web1 | /等 | 3 | | 2021-June-7 | Web2 | /var | 4 | | 2021-June-7 | Web3 | /var | 8 | | … | … | … | … | 您可以按時查詢資料篩選，但不將時間序列傳回給 Grafana。例如，當可用空間少於 5% 時，每個主機磁碟會啟動的提醒可能如下所示。 ``` SELECT Host, Disk, CASE WHEN PercentFree < 5.0 THEN PercentFree ELSE 0 END FROM ( SELECT Host, Disk, Avg(PercentFree) FROM DiskSpace Group By Host, Disk Where __timeFilter(Time) ``` 此查詢會將下列資料表回應傳回給 Grafana。 | 主機 | Disk | PercentFree | | --- | --- | --- | | Web1 | /等 | 3 | | Web2 | /var | 4 | | Web3 | /var | 0 | 當此查詢用作警示規則中的**條件**時，則值為非零警示的情況。因此，會產生三個警示執行個體，如下表所示。 | 標籤 | 狀態 | | --- | --- | | \$1Host=web1，disk=/etc\$1 | 提醒 | | \$1Host=web2，disk=/var\$1 | 提醒 | | \$1Host=web3，disk=/var\$1 | 正常 | ## 警示管理員 Grafana 包含對 Prometheus Alertmanager 的內建支援。Alertmanager 可協助群組和管理警示規則，在警示引擎上新增一層協同運作。根據預設，Grafana 受管警示的通知由屬於核心 Grafana 的內嵌 Alertmanager 處理。您可以從 Alertmanager 下拉式清單中選取 Grafana 選項，從 Grafana 警示 UI 設定 Alertmanager 的聯絡點、通知政策和範本。 Grafana 提醒支援外部 Alertmanager 組態 （如需 Alertmanager 作為外部資料來源的詳細資訊，請參閱 [連線至 Alertmanager 資料來源](data-source-alertmanager.md))。當您新增外部 Alertmanager 時，Alertmanager 下拉式清單會顯示可用的外部 Alertmanager 資料來源清單。選取資料來源，以建立和管理獨立 Cortex 或 Loki 資料來源的提醒。 ## 提醒規則的狀態和運作狀態 警示規則的狀態和運作狀態可協助您了解警示的數個關鍵狀態指標。有三個關鍵元件：提醒狀態、提醒規則狀態和提醒規則運作狀態。雖然相關，但每個元件都會傳遞稍微不同的資訊。 **警示規則狀態** + **正常** – 評估引擎傳回的任何時間序列都不會處於 `Pending`或 `Firing` 狀態。 + **待處理** – 評估引擎傳回的至少一個時間序列為 `Pending`。 + **發射** – 評估引擎傳回的至少一個時間序列為 `Firing`。 **警示狀態** + **正常** – 對於評估引擎傳回的每個時間序列，提醒規則的條件為 **false**。 + **警示** – 對於評估引擎傳回的至少一個時間序列，警示規則的條件為 **true**。在警示啟動之前，條件必須為 true 的持續時間，如果已設定、符合或已超過。 + **待處理** – 對於評估引擎傳回的至少一個時間序列，警示規則的條件為 **true**。條件在警示啟動之前必須為 true 的持續時間，如果已設定，則尚未滿足。 + **NoData** – 提醒規則尚未傳回時間序列、時間序列的所有值皆為 null，或時間序列的所有值皆為零。 + **錯誤** – 嘗試評估提醒規則時發生錯誤。 **警示規則運作狀態** + **確定** – 評估警示規則時沒有錯誤。 + **錯誤** – 評估警示規則時發生錯誤。 + **NoData** – 在規則評估期間至少傳回一個時間序列中缺少資料。 # 建立和管理 Grafana 提醒規則 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 提醒規則是一組評估條件，可判斷是否啟動提醒。規則包含一或多個查詢和表達式、條件、評估頻率，以及選擇性滿足條件的持續時間。 當查詢和表達式選取要評估的資料集時，條件會設定警示必須符合或超過的閾值，以建立警示。間隔會指定警示規則的評估頻率。設定時，持續時間表示條件必須滿足的時間長度。這些規則也可以定義缺少資料的提醒行為。 下列各節說明建立和管理不同類型的 Grafana 提醒規則。 **Topics** + [建立 Cortex 或 Loki 受管提醒規則](#create-alert-rule) + [建立 Cortex 或 Loki 受管錄製規則](#create-alert-recording-rule) + [建立 Grafana 受管警示規則](#create-grafana-alert-rule) + [提醒規則的註釋和標籤](#alert-rule-labels) + [管理提醒規則](#manage-alert-rules) + [Cortex 或 Loki 規則群組和命名空間](#alert-rule-groups) ## 建立 Cortex 或 Loki 受管提醒規則 使用 Grafana，您可以為外部 Cortex 或 Loki 執行個體建立提醒規則。 **注意** Cortex 是 Amazon Managed Service for Prometheus 和 Prometheus 資料來源所使用的時間序列資料庫。 **先決條件** + 確認您具有 Prometheus 資料來源的寫入許可。否則，您無法建立或更新 Cortex 受管提醒規則。 + 對於 Cortex 和 Loki 資料來源，請設定各自的服務來啟用尺規 API。 + **Loki** – `local`規則儲存類型，預設為 Loki 資料來源，僅支援檢視規則。若要編輯規則，請設定其他儲存類型之一。 + **Cortex** – 使用舊版`/api/prom`字首，而不是 `/prometheus`。Prometheus 資料來源同時支援 Cortex 和 Prometheus，Grafana 預期查詢 API 和尺規 API 都位於相同的 URL 下。您無法為尺規 API 提供單獨的 URL。 **注意** 如果您不想管理特定 Loki 或 Prometheus 資料來源的提醒規則，請前往其設定，並清除**透過提醒 UI 管理提醒**核取方塊。 **新增 Cortex 或 Loki 受管提醒規則** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示，以開啟列出現有警示**的警示**頁面。 1. 選擇**新提醒規則**。 1. 在**步驟 1** 中，新增規則名稱、類型和儲存位置，如下所示： + 在**規則名稱**中，新增描述性名稱。此名稱會顯示在提醒規則清單中。它也是從此規則建立的每個提醒執行個體的`alertname`標籤。 + 從**規則類型**下拉式清單中，選取 **Cortex/Loki 受管提醒**。 + 從**選取資料來源**下拉式清單中，選取 Prometheus 或 Loki 資料來源。 + 從**命名空間**下拉式清單中，選取現有的規則命名空間。否則，請選擇**新增**並輸入名稱以建立名稱。命名空間可以包含一或多個規則群組，而且只有組織用途。如需詳細資訊，請參閱[Cortex 或 Loki 規則群組和命名空間](#alert-rule-groups)。 + 從**群組**下拉式清單中，選取所選命名空間內的現有群組。否則，請選擇**新增**並輸入名稱以建立名稱。新建立的規則會附加到 群組的結尾。群組內的規則會以固定間隔循序執行，評估時間相同。 1. 在**步驟 2** 中，新增要評估的查詢。 此值可以是 PromQL 或 LogQL 表達式。如果評估結果具有至少一個值大於 0 的序列，則規則會啟動提醒。會為每個系列建立提醒。 1. 在**步驟 3** 中，新增條件。 在條件的文字方塊中，指定條件在警示啟動之前必須為 true 的持續時間。如果您指定 `5m`，則在警示啟動之前，條件必須為 true 五分鐘。 **注意** 滿足條件後，提醒會進入 `Pending` 狀態。如果條件在指定的持續時間內保持作用中，警示會轉換為 `Firing` 狀態。如果不再符合，則會還原為 `Normal` 狀態。 1. 在**步驟 4** 中，新增與規則相關聯的其他中繼資料。 + 新增描述和摘要以自訂提醒訊息。使用 中的準則[提醒規則的註釋和標籤](#alert-rule-labels)。 + 新增 Runbook URL、面板、儀表板和提醒 IDs。 + 新增自訂標籤。 1. 選擇**預覽提醒**來評估規則，並查看它會產生哪些提醒。它會顯示警示清單，其中包含每個警示的狀態和值。 1. 選擇**儲存**以儲存規則，或選擇**儲存並退出**以儲存規則，然後返回**提醒**頁面。 ## 建立 Cortex 或 Loki 受管錄製規則 您可以建立和管理外部 Cortex 或 Loki 執行個體的錄製規則。錄製規則會預先計算經常需要的表達式或運算昂貴的表達式，並將結果儲存為新的一組時間序列。查詢這個新的時間序列速度更快，尤其是儀表板，因為每次儀表板重新整理時都會查詢相同的表達式。 **先決條件** 對於 Cortex 和 Loki 資料來源，請設定各自的服務來啟用尺規 API。 + **Loki** – `local`規則儲存類型預設為 Loki 資料來源，僅支援檢視規則。若要編輯規則，請設定其他儲存類型之一。 + **Cortex** – 設定 Grafana Prometheus 資料來源以指向 Cortex 時，請使用舊版`/api/prom`字首，而不是 `/prometheus`。Prometheus 資料來源同時支援 Cortex 和 Prometheus，Grafana 預期查詢 API 和尺規 API 都位於相同的 URL 下。您無法為尺規 API 提供單獨的 URL。 **注意** 如果您不想管理特定 Loki 或 Prometheus 資料來源的提醒規則，請前往其設定，並清除**透過提醒 UI 管理提醒**核取方塊。 **新增 Cortex 或 Loki 受管錄製規則** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**提醒 **（鈴鐺） 圖示，開啟列出現有提醒**的提醒**頁面。 1. 選擇**新增提醒規則**。 1. 在**步驟 1** 中，新增規則名稱、類型和儲存位置，如下所示。 + 在**規則名稱**中，新增描述性名稱。此名稱會顯示在提醒規則清單中。它也是從此規則建立的每個提醒執行個體的`alertname`標籤。 + 從**規則類型**下拉式清單中，選取 **Cortex/Loki 受管提醒**。 + 從**選取資料來源**下拉式清單中，選取 Prometheus 或 Loki 資料來源。 + 從**命名空間**下拉式清單中，選取現有的規則命名空間。否則，請選擇**新增**並輸入名稱以建立名稱。命名空間可以包含一或多個規則群組，而且只有組織用途。如需詳細資訊，請參閱[Cortex 或 Loki 規則群組和命名空間](#alert-rule-groups)。 + 從**群組**下拉式清單中，選取所選命名空間內的現有群組。否則，請選擇**新增**並輸入名稱以建立名稱。新建立的規則會附加到 群組的結尾。群組內的規則會以固定間隔循序執行，評估時間相同。 1. 在**步驟 2** 中，新增要評估的查詢。 此值可以是 PromQL 或 LogQL 表達式。如果評估結果具有至少一個值大於 0 的序列，則規則會啟動提醒。會為每個系列建立提醒。 1. 在**步驟 3** 中，新增與規則相關聯的其他中繼資料。 + 新增描述和摘要以自訂提醒訊息。使用 中的準則[提醒規則的註釋和標籤](#alert-rule-labels)。 + 新增 Runbook URL、面板、儀表板和提醒 IDs。 + 新增自訂標籤。 1. 選擇**儲存**以儲存規則，或選擇**儲存並結束**以儲存規則，然後返回**提醒**頁面。 ## 建立 Grafana 受管警示規則 Grafana 可讓您建立警示規則，查詢一或多個資料來源、減少或轉換結果，並將其彼此比較，或修正閾值。處理這些資料時，Grafana 會傳送通知給聯絡點。 **注意** 在使用 Grafana 提醒時建立 Grafana 受管提醒規則會導致在規則相符時傳送多個通知。某些聯絡點供應商可能有可設定的選項來取消重複通知。 **新增 Grafana 受管規則** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示，以開啟列出現有警示**的警示**頁面。 1. 選擇**新提醒規則**。 1. 在**步驟 1** 中，新增規則名稱、類型和儲存位置，如下所示： + 在**規則名稱**中，新增描述性名稱。此名稱會顯示在提醒規則清單中。它也是從此規則建立的每個提醒執行個體的`alertname`標籤。 + 從**規則類型**下拉式清單中，選取 **Grafana 受管提醒**。 + 從**資料夾**下拉式清單中，選取要存放規則的資料夾。如果您未選取資料夾，則規則會存放在`General`資料夾中。若要建立資料夾，請選取下拉式清單，然後輸入新的資料夾名稱。 1. 在**步驟 2** 中，新增要評估的查詢和表達式。 + 保留預設名稱或將游標暫留在上方，然後選擇編輯圖示以變更名稱。 + 對於查詢，請從下拉式清單中選取資料來源。 + 新增一或多個[查詢](panel-queries.md)或表達式 （如需表達式的詳細資訊，請參閱 *Grafana 文件*中的[表達式](https://grafana.com/docs/grafana/next/panels/query-a-data-source/))。 + 針對每個表達式，選取 **Classic 條件**以建立單一提醒規則，或從**數學**、**減少**、**重新取樣**選項中選擇，為每個序列產生個別提醒。如需這些選項的詳細資訊，請參閱 [單一和多維度規則](#single-multi-rule)。 + 選擇**執行查詢**以驗證查詢是否成功。 1. 在**步驟 3** 中，新增條件。 + 從**條件**下拉式清單中，選取查詢或表達式以啟動提醒規則。 + 對於**評估每個**，請指定評估的頻率。必須是 10 秒的倍數。例如 `1m` 和 `30s`。 + 針對**評估 **，指定條件在啟動提醒之前必須為 true 的持續時間。 **注意** 違反條件後，提醒會進入 `Pending` 狀態。如果條件在指定的持續時間內仍然違反，警示會轉換為 `Firing` 狀態。如果不再符合，則會還原為 `Normal` 狀態。 + 在**設定無資料和錯誤處理**中，設定缺少資料的提醒行為。 使用 中的準則[不處理任何資料或錯誤案例](#rule-no-data-error)。 + 選擇**預覽提醒**，檢查目前執行查詢的結果。預覽不包含任何資料和錯誤處理條件。 1. 在**步驟 4** 中，新增與規則相關聯的其他中繼資料。 + 新增描述和摘要以自訂提醒訊息。使用 中的準則[提醒規則的註釋和標籤](#alert-rule-labels)。 + 新增 Runbook URL、面板、儀表板和提醒 IDs。 + 新增自訂標籤。 1. 選擇**儲存**以儲存規則，或選擇**儲存並退出**以儲存規則，然後返回**提醒**頁面。 ### 單一和多維度規則 對於 Grafana 受管警示規則，您可以建立具有傳統條件的規則，也可以建立多維度規則。 **單一維度規則 （傳統條件）** 使用傳統條件表達式來建立規則，在滿足其條件時啟動單一提醒。對於傳回多個序列的查詢，Grafana 不會追蹤每個序列的提醒狀態。因此，即使多個序列符合警示條件，Grafana 也會僅傳送單一警示。 如需如何格式化表達式的詳細資訊，請參閱 *Grafana 文件*中的[表達式](https://grafana.com/docs/grafana/next/panels/query-a-data-source/)。 **多維度規則** 若要為查詢中傳回的每個序列產生個別的提醒執行個體，請建立多維度規則。 **注意** 多維度規則產生的每個提醒執行個體都會計入您的提醒總配額。當您達到警示配額時，不會評估規則。如需多維規則配額的詳細資訊，請參閱 [配額達到錯誤](#rule-quota-reached)。 若要從單一規則建立多個執行個體，請使用 `Math`、 `Reduce`或 `Resample`表達式來建立多維度規則。例如，您可以： + 為每個查詢新增`Reduce`運算式，將所選時間範圍中的值彙總為單一值。([使用數值資料的規則](alert-fundamentals.md#alert-numeric)不需要）。 + 新增具有規則條件的`Math`表達式。如果規則不應啟動提醒，則查詢或減少表達式已傳回 0，或者如果規則應啟動提醒，則傳回正數，則不需要此選項。 一些範例： + `$B > 70` 如果它應該在 B 查詢/表達式的值超過 70 時啟動提醒。 + `$B < $C * 100` 如果 B 值小於 C 值乘以 100，則應該啟動提醒。如果比較的查詢在其結果中有多個序列，則不同查詢的序列如果具有相同的標籤，或其中一個是另一個查詢的子集，則會相符。 **注意** Grafana 不支援具有範本變數的提醒查詢。如需詳細資訊，請參閱社群頁面 [設定警示時，警示查詢不支援範本變數](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514)。 **多維度規則的效能考量** 每個提醒執行個體都會計入提醒配額。不會評估建立超過警示配額內可容納之執行個體的多維度規則，並傳回配額錯誤。如需詳細資訊，請參閱[配額達到錯誤](#rule-quota-reached)。 多維提醒可能會對 Grafana 工作區的效能以及資料來源的效能產生高度影響，因為 Grafana 會查詢它們來評估您的提醒規則。當您嘗試最佳化監控系統的效能時，下列考量會很有幫助。 + **規則評估頻率** – 警示規則的每個屬性**評估**控制規則評估的頻率。我們建議您使用可接受的最低評估頻率。 + **結果集基數** – 您使用規則建立的提醒執行個體數量會影響其效能。假設您正在監控機群中每個 VM 上每個 API 路徑的 API 回應錯誤。此集的基數是路徑數乘以 VMs 數。您可以減少結果集的基數，例如，透過監控每個 VM 的總錯誤數，而不是每個 VM 的每個路徑。 + **查詢的複雜性** – 資料來源可以處理和回應以快速耗用較少資源的查詢。雖然此考量比上述其他考量更不重要，但如果您已盡可能減少這些考量，查看個別查詢效能可能會產生影響。您也應該了解評估這些規則對資料來源造成的效能影響。警示查詢通常是監控資料庫處理的絕大多數查詢，因此影響 Grafana 執行個體的相同負載因素也會影響它們。 ### 配額達到錯誤 您可以在單一工作區中擁有的提醒執行個體數量有配額。當您達到該號碼時，您無法再在該工作區中建立新的提醒規則。使用多維提醒時，提醒執行個體的數量會隨著時間而不同。 使用提醒執行個體時，請務必記住下列事項。 + 如果您只建立單一維度規則，則每個規則都是單一提醒執行個體。您可以在單一工作區中建立與提醒執行個體配額相同的規則數量，而不再建立。 + 多維度規則會建立多個提醒執行個體，但是在評估數字之前，不會知道數字。例如，如果您建立警示規則來追蹤 Amazon EC2 執行個體的 CPU 用量，則當您建立 EC2 執行個體時，可能會有 50 個 EC2 執行個體 （因此還有 50 個警示執行個體），但如果您一週後再新增 10 個 EC2 執行個體，則下一個評估會有 60 個警示執行個體。 當您建立多維提醒時，會評估提醒執行個體的數量，而且您無法建立讓您立即超過提醒執行個體配額的提醒執行個體數量。由於提醒執行個體的數量可以變更，每次評估您的規則時都會檢查您的配額。 + 在規則評估時間，如果規則導致您超出提醒執行個體的配額，則在更新提醒規則，使提醒執行個體總數低於服務配額之前，不會評估該規則。發生這種情況時，您會收到提醒通知，通知您已達到配額 （通知使用通知政策來評估規則）。通知包含值為 的`Error`註釋`QuotaReachedError`。 + 導致`QuotaReachedError`停止評估的規則。只有在進行更新且更新之後的評估本身不會導致 時，才會繼續評估`QuotaReachedError`。未評估的規則會顯示 Grafana 主控台中**配額達到**的錯誤。 + 您可以透過移除提醒規則或編輯多維提醒來減少提醒執行個體的數量 （例如，對每個 VM 的錯誤有一個提醒，而不是對 VM 中的每個 API 的錯誤有一個提醒）。 + 若要繼續評估，請更新提醒並儲存。您可以更新它以降低提醒執行個體的數量，或者如果您已進行其他變更以降低提醒執行個體的數量，則可以儲存它而不進行任何變更。如果可以繼續，則為 。如果它造成另一個 `QuotaReachedError`，您就無法儲存它。 + 儲存提醒並繼續評估而不超過提醒配額時，**配額達到**的錯誤可以繼續在 Grafana 主控台中顯示一段時間 （直到其評估間隔），不過，如果符合規則閾值，則提醒規則評估會開始並傳送提醒。 + 如需提醒配額和其他配額的詳細資訊，請參閱 [Amazon Managed Grafana 服務配額](AMG_quotas.md)。 ### 不處理任何資料或錯誤案例 選擇在資料不存在或發生錯誤時如何處理提醒行為的選項。 處理任何資料的選項會列在下表中。 | 無資料選項 | Behavior (行為) | | --- | --- | | 無資料 | 建立具有提醒規則`DatasourceNoData`名稱和 UID 的提醒，以及未以標籤形式傳回資料之資料來源的 UID。 | | 提醒 | 將警示規則狀態設定為 `Alerting`。 | | OK | 將警示規則狀態設定為 `Normal`。 | 下表列出處理錯誤案例的選項。 | 錯誤或逾時選項 | Behavior (行為) | | --- | --- | | 提醒 | 將警示規則狀態設定為 `Alerting` | | OK | 將警示規則狀態設定為 `Normal` | | 錯誤 | 建立具有提醒規則`DatasourceError`名稱和 UID 的提醒，以及未以標籤形式傳回資料之資料來源的 UID。 | ## 提醒規則的註釋和標籤 註釋和標籤是與源自警示規則、資料來源回應和警示規則評估的警示相關聯的鍵/值對。它們可以直接用於提醒通知，也可以用於[範本](alert-message-templates.md)和[範本函數](alert-message-templates.md#alert-template-functions)，以動態方式建立通知聯絡人。 **註釋** 註釋是提供提醒額外資訊的鍵/值對。您可以使用下列註釋：`description`、`summary`、`runbook_url`、`dashboardUid`、 `alertId`和 `panelId`。這些會顯示在 UI 中的規則和提醒詳細資訊中，可用於聯絡點訊息範本。 **標籤** 標籤是包含提醒相關資訊的鍵/值對。警示的標籤集會在警示評估和通知過程中產生並新增至 。其使用方式如下。 + 提醒的完整標籤集可唯一識別 Grafana 提醒中的提醒。 + Alertmanager 使用標籤來比對[通知政策](alert-notifications.md)中[靜音](alert-silences.md)和[警示群組](alert-groups.md)的警示。 + 警示 UI 會顯示評估該規則所產生的每個警示執行個體的標籤。 + 聯絡點可以存取標籤，以動態產生通知，其中包含導致通知的提醒特定資訊。 + 標籤可以新增至[提醒規則](#alert-rules)。這些手動設定的標籤可以使用範本函數並參考其他標籤。新增至此處提醒規則的標籤會優先於標籤之間發生衝突的情況。 展開註釋和標籤時，可使用下列範本變數。 | 名稱 | 描述 | | --- | --- | | `$labels` | 查詢或條件中的標籤。例如，`{{ $labels.instance }}` 和 `{{ $labels.job }}`。當規則使用傳統條件時，無法使用此功能。 | | `$values` | 針對此提醒規則評估的所有減少和數學表達式的值。例如， `{{ $values.A }}``{{ $values.A.Labels }}`和 `{{ $values.A.Value }}`，其中 `A`是表達式`refID`的 。當規則使用傳統條件時，無法使用此功能 | | `$value` | 警示執行個體的值字串。例如 `[ var='A' labels={instance=foo} value=10 ]`。 | ## 管理提醒規則 **提醒**頁面列出提醒規則。根據預設，規則會依資料來源類型分組。**Grafana** 區段列出 Grafana 管理的規則，**Cortex/Loki** 區段則列出 Prometheus 相容資料來源的規則。您可以檢視 Prometheus 相容資料來源的提醒規則，但無法編輯它們。 ### 檢視提醒規則 使用 Grafana 提醒，您可以在一個頁面中檢視所有提醒。 **檢視提醒詳細資訊** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示以開啟**警示**頁面。根據預設，規則會依資料來源類型顯示在群組中。您也可以依每個提醒的目前狀態來檢視 （以下文字將詳細說明這些警示）。 1. 在**檢視為**中，您可以選擇您偏好的選項，在群組和狀態檢視之間切換。 1. 選擇資料列旁的箭頭，以檢視該資料列的更多詳細資訊。規則的詳細資訊包括規則標籤、註釋、資料來源和查詢，以及規則產生的提醒執行個體清單。 **群組檢視** 群組檢視顯示依資料夾分組的 Grafana 提醒規則，以及依 `namespace` \$1 分組的 Loki 或 Prometheus 提醒規則`group`。這是預設規則清單檢視，用於管理規則。您可以展開每個群組，以檢視此群組中的規則清單。進一步展開規則以檢視其詳細資訊。您也可以展開規則所產生的動作按鈕和提醒，以檢視其詳細資訊。 **狀態檢視** 狀態檢視會顯示依狀態分組的提醒規則。使用此檢視來取得哪些規則處於何種狀態的概觀。每個規則都可以展開以檢視其詳細資訊。動作按鈕和此規則產生的任何提醒，每個提醒都可以進一步展開以檢視其詳細資訊。 **篩選提醒規則** 您可以透過多種方式篩選出現在提醒頁面上**的提醒**規則。 + 您可以選擇**選取資料來源，然後選擇要篩選的資料來源**，以顯示查詢特定資料來源的規則。 + 您可以在依標籤搜尋中選擇搜尋條件，依**標籤篩選**。某些範例條件包括 `environment=production`、`region=~US|EU`、`severity!=warning`。 + 您可以選擇**依狀態篩選提醒**，然後選擇您要檢視的狀態，以篩選在特定狀態顯示規則。 ### 編輯或刪除提醒規則 只有具有儲存規則之資料夾編輯許可的使用者，才能編輯或刪除 Grafana 受管提醒規則。具有編輯器或管理員角色的使用者可以編輯或刪除外部 Cortex 或 Loki 執行個體的提醒規則。 **編輯或刪除規則** 1. 展開規則，直到您可以查看**檢視**、**編輯**和**刪除**的規則控制項為止。 1. 選擇**編輯**以開啟建立規則頁面。以建立規則的相同方式進行更新。如需詳細資訊，請參閱 [建立 Grafana 受管警示規則](#create-grafana-alert-rule)或 中的說明[建立 Cortex 或 Loki 受管提醒規則](#create-alert-rule)。 1. 或者，選擇**刪除**以刪除規則。 ## Cortex 或 Loki 規則群組和命名空間 您可以組織您的規則。規則是在規則群組內建立的，規則群組會組織成命名空間。規則群組內的規則會以定期間隔循序執行。預設間隔為一分鐘。您可以重新命名 Cortex 或 Loki 命名空間和規則群組，並編輯規則群組評估間隔。 **編輯規則群組或命名空間** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示以開啟**警示**頁面。 1. 導覽至您要編輯的規則群組或命名空間內的規則。 1. 選擇**編輯** （筆） 圖示。 1. 變更規則群組或命名空間。 **注意** 對於命名空間，您只能編輯名稱。對於規則群組，您可以變更群組中規則的名稱或評估間隔。例如，您可以選擇每分鐘`1m`評估規則一次，或每 30 秒`30s`評估一次。 1. 選擇**儲存變更**。 # 警示群組 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 警示群組會顯示來自 Alertmanager 執行個體的分組警示。根據預設，警示會依 中根政策的標籤索引鍵分組[使用通知政策](alert-notifications.md)。將常見警示分組為單一警示群組可防止啟動重複的警示。 **檢視警示群組** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示，然後選擇**警示分組**項目以開啟列出現有群組的頁面。 1. 從 **Alertmanager** 下拉式清單中，選取外部 Alertmanager 做為資料來源。預設會選取 `Grafana` Alertmanager。 1. 從**自訂群組依據**下拉式清單中，選取標籤的組合，以檢視預設以外的群組。您可以使用此檢視來偵錯或驗證通知政策的分組。 群組根政策或自訂群組中未指定標籤的提醒，會新增至標頭為 的群組`No grouping`。 **篩選提醒** 您可以使用下列篩選條件來檢視符合特定條件的提醒： + **依標籤搜尋** – 在**搜尋**中，輸入現有標籤以檢視符合標籤的提醒。例如，`environment=production`、`region=~US|EU`、`severity!=warning`。 + **依狀態篩選警示** – 在**狀態**中，選取 `Active`、 `Suppressed`或 `Unprocessed` 狀態以檢視該狀態的警示。 # Prometheus 資料來源的靜音提醒通知 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 對於外部 Alertmanager 資料來源 （包括 Amazon Managed Service for Prometheus)，您可以使用*靜音*來隱藏提醒通知。靜音只會停止建立通知：靜音不會阻止評估提醒規則，也不會停止在使用者介面中顯示提醒執行個體。當您將警示設為靜音時，您可以指定封鎖警示的時段。 您可以為外部 Alertmanager 資料來源設定靜音。 **注意** 若要隱藏定期時間間隔的提醒通知 （例如，在定期維護期間），請使用 [靜音計時](alert-notifications.md#alert-notification-muting)而非靜音。 **新增靜音** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示以開啟**警示**頁面。 1. 選擇**靜音**以開啟列出現有[聯絡點](alert-contact-points.md)的頁面。 1. 從 Alertmanager 下拉式清單中選擇外部 **Alertmanager**。 1. 選取**新靜音**。 1. 在**靜音開始和結束日期中選取開始和**結束日期，以指出靜音何時生效以及何時結束。 做為設定結束時間的替代方案，請在**持續時間**中指定靜音強制執行的時間長度。這會自動更新**靜音開始和結束**欄位中的結束時間。 1. 在**名稱**和**值**欄位中，輸入一或多個*相符標籤*。配對者決定靜音適用的規則。在此程序之後，會更詳細地討論標籤比對。 1. 或者，新增**註解**或修改**建立者**以設定靜音的擁有者。 **警示抑制的標籤比對** 建立靜音時，您會建立一組*相符的標籤*，做為靜音的一部分。這是一組關於標籤的規則，必須符合才能隱藏提醒。相符的標籤包含三個部分： + **Label** – 要比對的標籤名稱。它必須完全符合提醒的標籤名稱。 + **Operator** – 用來比較標籤值與相符標籤值的運算子。可用的運算子包括： + `=` 選取其值完全符合所提供字串的標籤。 + `!=` 選取其值不符合所提供字串的標籤。 + `=~` 選取其值符合所提供字串之 regex 解譯值的標籤 （提供的字串會解譯為規則表達式）。 + `!=` 選取不符合所提供規則表達式的標籤。 + **值** – 符合標籤值的值。它可以比對為字串或規則表達式，取決於所選的運算子。 靜音會在指定的結束日期結束，但您可以隨時手動結束禁止。 **手動結束靜音** 1. 在**提醒**頁面中，選擇**靜音**以檢視現有靜音的清單。 1. 選取您要結束的靜音，然後選擇**取消靜音**。這會結束提醒抑制。 **注意** 取消靜音會結束提醒抑制，就好像已將結束時間設定為目前時間一樣。已結束的靜音 （自動或手動） 會保留並列出五天。您無法手動從清單中移除靜音。 **建立靜音建立表單的連結** 您可以使用已填入的詳細資訊來建立靜音建立表單的 URL。操作員可以使用此功能在操作事件期間快速抑制警示。 建立靜音表單的連結時，請使用`matchers`查詢參數來指定相符的標籤，並使用`comment`查詢參數來指定註解。`matchers` 參數需要格式為 的一或多個值`[label][operator][value]`，並以逗號分隔。 **範例 URL** 若要連結至靜音表單，並搭配相符的標籤 `severity=critical`和 `cluster!~europe-.*`，並加上註解指出 `Silencing critical EU alerts`，請使用如下所示的 URL。使用 *Grafana 執行個體的主機名稱取代 mygrafana*。 ``` https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert ``` 若要連結至外部 Alertmanager 的新靜音頁面，請使用 Alertmanage 資料來源名稱新增`alertmanager`查詢參數，例如 `alertmanager=myAlertmanagerdatasource`。 # 使用聯絡點 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 使用聯絡點來定義啟動提醒時通知聯絡人的方式。聯絡點可以有一或多個聯絡點類型，例如 Amazon Simple Notification Service 或 Slack。警示啟動時，系統會傳送通知給為聯絡點列出的所有聯絡點類型。或者，使用 [使用訊息範本](alert-message-templates.md)自訂聯絡點類型的通知訊息。 **注意** 您可以建立和編輯 Grafana 受管提醒的聯絡點。Alertmanager 警示的聯絡點為唯讀。 ## 使用聯絡點 下列程序詳細說明如何新增、編輯、測試和刪除聯絡點。 **新增聯絡點** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示以開啟**警示**頁面。 1. 選擇**聯絡點**，然後選擇**新增聯絡點**。 1. 從 **Alertmanager** 下拉式清單中，選取 Alertmanager。預設會選取 Grafana Alertmanager。 1. 輸入聯絡點**的名稱**。 1. 從**聯絡點類型**中，根據該類型選擇類型和必要欄位。例如，如果您選擇 Slack，請輸入 Slack 頻道和應聯絡的使用者。 1. 如果適用於您選取的聯絡點，您可以選擇**選用設定**來指定其他設定。 1. 在**通知設定**下，如果您不想在警示解析時收到通知，可選擇**停用已解析訊息**。 1. 如果您的聯絡點需要更多聯絡點類型，您可以選擇**新的聯絡點類型**，並針對所需的每個聯絡點類型重複這些步驟。 1. 選擇**儲存聯絡點**以儲存變更。 **編輯聯絡點** 1. 選擇**聯絡點**以查看現有聯絡點的清單。 1. 選取要編輯的聯絡點，然後選擇**編輯**圖示 （筆）。 1. 進行任何必要的變更，然後選擇**儲存聯絡點**以儲存變更。 建立聯絡點之後，您可以傳送測試通知，以確認已正確設定。 **傳送測試通知** 1. 選擇**聯絡點**以開啟現有聯絡點的清單。 1. 選取要測試的聯絡點，然後選擇**編輯**圖示 （筆）。 1. 選取**測試**圖示 （紙質飛機）。 1. 選擇是否要傳送預先定義的測試通知，或選擇**自訂**以在測試通知中新增您自己的自訂註釋和標籤。 1. 選擇**傳送測試通知**，以使用指定的聯絡點測試提醒。 您可以刪除通知政策未使用的聯絡點。 **刪除聯絡點** 1. 選擇**聯絡點**以開啟現有聯絡點的清單。 1. 選取要刪除的聯絡點，然後選擇**刪除**圖示 （垃圾桶）。 1. 在確認對話方塊中，選擇**是，刪除**。 **注意** 如果通知政策正在使用聯絡點，您必須在刪除聯絡點之前刪除或編輯通知政策，以使用不同的聯絡點。 ## 支援的標記符清單 | 名稱 | 類型 | | --- | --- | | Amazon SNS | sns | | OpsGenie | opsgenie | | Pager 職責 | pagerduty | | Slack | slack | | VictorOps | victorops | # 使用訊息範本 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 透過 傳送的通知[使用聯絡點](alert-contact-points.md)是使用*簡訊範本*建置。Grafana 的預設範本是以 [Go 範本系統](https://golang.org/pkg/text/template)為基礎，其中某些欄位會評估為文字，而其他則評估為 HTML （這可能會影響逸出）。 由於大多數的聯絡點欄位都可以建立範本，因此您可以建立可重複使用的自訂範本，並在多個聯絡點中使用它們。[範本資料](#alert-template-data) 主題會列出可用於範本化的變數。 **使用 範本** 範本用於建立訊息。例如，使用 Slack 提醒訊息，您可以在聯絡點中設定標題和內文。下列範例示範如何使用預設範本來建立標題，其中包含觸發和解決的提醒計數，以及列出提醒及其狀態的內文。 + **標題**： ``` {{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved ``` + **文字內文**： ``` {{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }} {{end }} ``` 您可以建立自己的自訂範本，如下列範例所示。 + **標題**： ``` {{ template "slack.default.title" .}} ``` + **文字內文**： ``` {{ template "mymessage" .}} ``` 以下是範例範本。 ``` {{ define "myalert" }} [{{.Status}}] {{ .Labels.alertname }} Labels: {{ range .Labels.SortedPairs }} {{ .Name }}: {{ .Value }} {{ end }} {{ if gt (len .Annotations) 0 }} Annotations: {{ range .Annotations.SortedPairs }} {{ .Name }}: {{ .Value }} {{ end }} {{ end }} {{ if gt (len .SilenceURL ) 0 }} Silence alert: {{ .SilenceURL }} {{ end }} {{ if gt (len .DashboardURL ) 0 }} Go to dashboard: {{ .DashboardURL }} {{ end }} {{ end }} ``` 下列程序說明如何建立、編輯和刪除自訂訊息範本。 **建立訊息範本** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示以開啟**警示**頁面。 1. 選擇**聯絡點**。 1. 從 **Alertmanager** 下拉式清單中，選取您要為其建立訊息範本的 Alertmanager 執行個體。預設為 Grafana Alertmanager。 1. 選擇**新增範本**。 1. 新增描述性**名稱**。 1. 新增範本**的內容**，例如： ``` {{ define "mymessage" }} {{ range .Alerts }} [{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}} {{ end }} {{ end }} ``` 內容區段中的`define`標籤會指派範本名稱。此標籤為選用，省略時，範本名稱衍生自**名稱**欄位。指定兩者時，最佳實務是保持兩者相同。 1. 選擇**儲存範本**。 **注意** 提醒訊息範本中的 HTML 會轉譯為文字，並逸出控制字元。Grafana 不支援在產生的通知中轉譯 HTML。 **編輯訊息範本** 1. 在**提醒**頁面中，選擇**聯絡點**以開啟聯絡點清單。 1. 在**範本表格中**，尋找您要編輯的範本，然後選擇**編輯**圖示 （筆）。 1. 進行變更，然後選擇**儲存範本**。 **刪除訊息範本** 1. 在**提醒**頁面中，選擇**聯絡點**以開啟聯絡點清單。 1. 在**範本表格中**，尋找您要移除的範本，然後選擇**刪除**圖示 （垃圾桶）。 1. 選擇**是，刪除**以刪除範本。 **巢狀範本** 您可以在其他範本中內嵌範本。 例如，您可以使用`define`關鍵字定義範本片段： ``` {{ define "mytemplate" }} {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved. {{ end }} ``` 然後，您可以使用 `template`關鍵字在此片段中嵌入自訂範本。例如： ``` Alert summary: {{ template "mytemplate" . }} ``` 您可以使用下列內建範本選項來內嵌自訂範本。 | 名稱 | 備註 | | --- | --- | | `default.title` | 顯示高階狀態資訊。 | | `default.message` | 提供射擊和已解決警示的格式化摘要。 | **自訂範本範例** 以下是如何使用自訂範本的範例。 轉譯單一提醒的範本： ``` {{ define "myalert" }} [{{.Status}}] {{ .Labels.alertname }} Labels: {{ range .Labels.SortedPairs }} {{ .Name }}: {{ .Value }} {{ end }} {{ if gt (len .Annotations) 0 }} Annotations: {{ range .Annotations.SortedPairs }} {{ .Name }}: {{ .Value }} {{ end }} {{ end }} {{ if gt (len .SilenceURL ) 0 }} Silence alert: {{ .SilenceURL }} {{ end }} {{ if gt (len .DashboardURL ) 0 }} Go to dashboard: {{ .DashboardURL }} {{ end }} {{ end }} ``` 轉譯整個通知訊息的範本： ``` {{ define "mymessage" }} {{ if gt (len .Alerts.Firing) 0 }} {{ len .Alerts.Firing }} firing: {{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }} {{ end }} {{ if gt (len .Alerts.Resolved) 0 }} {{ len .Alerts.Resolved }} resolved: {{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }} {{ end }} {{ end }} ``` ## 範本資料 下列資料會傳遞至訊息範本。 | 名稱 | 類型 | 備註 | | --- | --- | --- | | `Receiver` | string | 正在傳送通知的聯絡點名稱。 | | `Status` | string | 如果至少一個提醒正在觸發，則觸發，否則會解決。 | | `Alerts` | 警示 | 此通知中包含的提醒物件清單 （請參閱下方）。 | | `GroupLabels` | KeyValue | 這些提醒分組依據的標籤。 | | `CommonLabels` | KeyValue | 此通知中包含的所有提醒通用的標籤。 | | `CommonAnnotations` | KeyValue | 此通知中所有提醒的常見註釋。 | | `ExternalURL` | string | 傳送通知的 Grafana 的返回連結。如果使用外部 Alertmanager，請返回此 Alertmanager 的連結。 | `Alerts` 類型會公開兩個用於篩選傳回提醒的函數。 + `Alerts.Firing` – 傳回射擊提醒的清單。 + `Alerts.Resolved` – 傳回已解析警示的清單。 **提醒 （類型）** 提醒類型包含下列資料。 | 名稱 | 類型 | 備註 | | --- | --- | --- | | 狀態 | string | `firing` 或 `resolved` | | 標籤 | KeyValue | 連接到提醒的一組標籤。 | | 註釋 | KeyValue | 附加到提醒的一組註釋。 | | StartsAt | time.Time | 警示開始觸發的時間。 | | EndsAt | time.Time | 只有在已知警示的結束時間時才設定。否則，請設定為自上次收到提醒以來的可設定逾時期間。 | | GeneratorURL | string | Grafana 或外部 Alertmanager 的後退連結。 | | SilenceURL | string | 連結至 的 grafana 靜音，並預先填入此提醒的標籤。僅適用於 Grafana 受管提醒。 | | DashboardURL | string | 如果警示規則屬於一個，則連結至 grafana 儀表板。僅適用於 Grafana 受管提醒。 | | PanelURL | string | 如果警示規則屬於一個，則連結至 grafana 儀表板面板。僅適用於 Grafana 受管提醒。 | | 指紋 | string | 可用來識別提醒的指紋。 | | ValueString | string | 字串，其中包含提醒中每個減少表達式的標籤和值。 | **KeyValue 類型** `KeyValue` 類型是一組代表標籤和註釋的鍵/值字串對。 除了直接存取存放為 的資料之外`KeyValue`，還有排序、移除和轉換資料的方法。 | 名稱 | 引數 | 傳回值 | 備註 | | --- | --- | --- | --- | | SortedPairs | | 已排序的索引鍵和值字串對清單 | | | 移除 | 【】字串 | KeyValue | 傳回不含指定金鑰的金鑰/值映射複本。 | | 名稱 | | 【】字串 | 標籤名稱清單 | | 值 | | 【】字串 | 標籤值清單 | ## 範本函數 使用範本函數，您可以處理標籤和註釋來產生動態通知。下列 函數可供使用。 | 名稱 | 引數類型 | 傳回類型 | Description | | --- | --- | --- | --- | | `humanize` | 數字或字串 | string | 使用指標字首，將數字轉換為更易讀的格式。 | | `humanize1024` | 數字或字串 | string | 就像人文化一樣，但使用 1024 作為基礎，而不是 1000。 | | `humanizeDuration` | 數字或字串 | string | 以秒為單位將持續時間轉換為更易於讀取的格式。 | | `humanizePercentage` | 數字或字串 | string | 將比率值轉換為 100 的分數。 | | `humanizeTimestamp` | 數字或字串 | string | 以秒為單位將 Unix 時間戳記轉換為更易於讀取的格式。 | | `title` | string | string | strings.Title，將每個單字的第一個字元大寫。 | | `toUpper` | string | string | strings.ToUpper，將所有字元轉換為大寫。 | | `toLower` | string | string | strings.ToLower， 會將所有字元轉換為小寫。 | | `match` | 模式、文字 | boolean | 未錨定 regexp 比對的 regexp.MatchString 測試。 | | `reReplaceAll` | 模式、替換、文字 | string | Regexp.ReplaceAllString Regexp 替換，未錨定。 | | `graphLink` | string - 具有 `expr`和 `datasource` 欄位的 JSON 物件 | string | 在探索中傳回指定表達式和資料來源的圖形檢視路徑。 | | `tableLink` | string - 具有 `expr`和 `datasource` 欄位的 JSON 物件 | string | 在探索中傳回指定表達式和資料來源的表格式檢視路徑。 | | `args` | 【】 介面\$1\$1 | map【string】interface\$1\$1 | 將物件清單轉換為具有索引鍵的映射，例如 arg0、arg1。使用此函數將多個引數傳遞至 範本。 | | `externalURL` | 無 | string | 傳回代表外部 URL 的字串。 | | `pathPrefix` | 無 | string | 傳回外部 URL 的路徑。 | 下表顯示使用每個 函數的範例。 | 函式 | TemplateString | Input | 預期 | | --- | --- | --- | --- | | 人文化 | \$1 人文化 \$1value \$1 | 1234567.0 | 12.35 公尺 | | humanize1024 | \$1 humanize1024 \$1value \$1 | 1048576.0 | 1Mi | | humanizeDuration | \$1 humanizeDuration \$1value \$1 | 899.99 | 14 公尺 59 秒 | | humanizePercentage | \$1 humanizePercentage \$1value \$1 | 0.1234567 | 12.35% | | humanizeTimestamp | \$1 humanizeTimestamp \$1value \$1 | 1435065584.128 | 2015-06-23 13：19：44.128 \$10000 UTC | | 標題 | \$1 \$1value \$1 標題 \$1 | aa bB CC | Aa Bb Cc | | toUpper | \$1 \$1value \$1 toUpper \$1 | aa bB CC | AA BB CC | | toLower | \$1 \$1value \$1 toLower \$1 | aa bB CC | aa bb cc | | match | \$1 match "a\$1" \$1labels.instance \$1 | aa | true | | reReplaceAll | \$1\$1 reReplaceAll "localhost：(.\$1)" "my.domain：\$11" \$1labels.instance \$1\$1 | localhost：3000 | my.domain：3000 | | graphLink | \$1\$1 graphLink "\$1\$1"expr\$1"： \$1"up\$1"， \$1"datasource\$1"： \$1"gdev-prometheus\$1"\$1" \$1\$1 | | /explore？left=【"now-1h"，"now"，"gdev-prometheus"，\$1"datasource"："gdev-prometheus"，"expr"："up"，"instant"：false，"range"：true\$1】 | | tableLink | \$1\$1 tableLink "\$1\$1"expr\$1"：\$1"up\$1"、\$1"datasource\$1"：\$1"gdev-prometheus\$1"\$1" \$1\$1 | | /explore？left=【"now-1h"，"now"，"gdev-prometheus"，\$1"datasource"："gdev-prometheus"，"expr"："up"，"instant"：true，"range"：false\$1】 | | args | \$1\$1define "x"\$1\$1\$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1\$1\$1end\$1\$1\$1\$1template "x" (args 1 "2")\$1\$1 | | 1 2 | | externalURL | \$1 externalURL \$1 | | http：//localhost/path/prefix | | pathPrefix | \$1 pathPrefix \$1 | | /path/prefix | # 使用通知政策 **** 本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 通知政策會決定警示如何路由到聯絡點。政策具有樹狀結構，其中每個政策可以有一或多個子政策。除了根政策之外，每個政策也可以符合特定的提醒標籤。每個提醒都會由根政策評估，然後由每個子政策評估。如果您針對特定政策啟用 `Continue matching subsequent sibling nodes`選項，則即使在一或多個相符項目之後，評估仍會繼續。父政策的組態設定和聯絡點資訊會管理不符合任何子政策的提醒行為。根政策會管理不符合特定政策的任何提醒。 **注意** 您可以建立和編輯 Grafana 受管警示的通知政策。Alertmanager 警示的通知政策為唯讀。 **分組通知** 分組會將類似性質的提醒通知分類為單一漏斗。這可讓您在系統許多部分一次故障時控制較大中斷期間的提醒通知，進而同時啟動大量提醒。 **分組範例** 假設您有 100 個服務連接到不同環境中的資料庫。這些服務會依標籤 區分`env=environmentname`。已制定提醒規則，以監控您的服務是否可以到達資料庫。提醒規則會建立名為 的提醒`alertname=DatabaseUnreachable`。 如果發生網路分割區，其中一半的服務無法再連線到資料庫，則會啟動 50 個不同的提醒。在這種情況下，您想要接收單頁通知 （而不是 50)，其中包含受影響的環境清單。 您可以將分組設定為 `group_by: [alertname]`（不使用 `env`標籤，這對於每個服務都不同）。設定此組態後，Grafana 會傳送單一精簡通知，其中包含此提醒規則的所有受影響環境。 **特殊群組** Grafana 有兩個特殊群組。預設群組會將`group_by: null`*所有*警示分組為單一群組。您也可以使用名為 的特殊標籤`...`，依所有標籤分組提醒、有效停用分組，並將每個提醒傳送到自己的群組。 ## 使用通知 下列程序說明如何建立和管理通知政策。 **編輯根通知政策** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示以開啟**警示**頁面。 1. 選擇**通知政策**。 1. 從 **Alertmanager** 下拉式清單中，選取您要編輯的 Alertmanager。 1. 在**根政策**區段中，選擇**編輯**圖示 （筆）。 1. 在**預設聯絡點**中，更新當提醒規則不符合任何特定政策時，應為規則傳送通知的聯絡點。 1. 在**分組依據**中，選擇要分組提醒依據的標籤 （或特殊群組）。 1. 在**時間選項**中，從下列選項中選取 。 + **群組等待** – 在傳送初始通知之前，等待緩衝相同群組警示的時間。預設為 30 秒。 + **群組間隔** – 群組的兩個通知之間的最短時間間隔。預設值為 5 分鐘。 + **重複間隔** – 如果沒有將新警示新增至群組，則重新傳送通知之前的最短時間間隔。預設值為 4 小時。 1. 選擇**儲存**，以儲存變更。 **新增最上層特定政策** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示以開啟**警示**頁面。 1. 選擇**通知政策**。 1. 從 **Alertmanager** 下拉式清單中，選取您要編輯的 Alertmanager。 1. 在**特定路由**區段中，選擇**新增特定政策**。 1. 在**相符標籤**區段中，新增一或多個相符提醒標籤。有關標籤比對的詳細資訊，請參閱本主題的後文。 1. 在**聯絡點**中，如果提醒符合此特定政策，請新增要傳送通知的聯絡點。巢狀政策會覆寫此聯絡點。 1. 選擇性地選取**覆寫群組**，以指定與根政策不同的群組。 1. 選擇性地選取**覆寫一般時間**，以覆寫群組通知政策中的時間選項。 1. 選擇**儲存政策**以儲存變更。 **新增巢狀政策** 1. 展開您想要在其下建立巢狀政策的特定政策。 1. 選擇**新增巢狀政策**，然後新增詳細資訊 （如同新增最上層特定政策時）。 1. 選擇**儲存政策**以儲存變更。 **編輯特定政策** 1. 在**提醒**頁面中，選擇**通知政策**以開啟列出現有政策的頁面。 1. 選取您要編輯的政策，然後選擇**編輯**圖示 （筆）。 1. 進行任何變更 （如同新增最上層特定政策時）。 1. 選擇 **儲存政策**。 **標籤比對的運作方式** 如果警示的標籤符合政策上指定的所有*相符標籤*，則政策會比對警示。 + **Label** – 要比對的標籤名稱。它必須完全符合提醒的標籤名稱。 + **Operator** – 用來比較標籤值與相符標籤值的運算子。可用的運算子包括： + `=` 選取其值完全符合所提供字串的標籤。 + `!=` 選取其值不符合所提供字串的標籤。 + `=~` 選取其值符合所提供字串之 regex 解譯值的標籤 （提供的字串會解譯為規則表達式。 + `!=` 選取不符合所提供規則表達式的標籤。 + **值** – 符合標籤值的值。它可以比對為字串或規則表達式，視所選的運算子而定。 ## 靜音計時 靜音計時是政策未產生或傳送新通知的週期性時間間隔。使用它們來防止警示觸發特定和重複發生的期間，例如定期維護期間。 與靜音類似，靜音計時不會阻止評估警示規則，也不會阻止警示執行個體顯示在使用者介面中。它們只會防止通知建立。 您可以設定 Grafana 受管靜音計時，以及外部 Alertmanager 資料來源的靜音計時。 **相較於靜音的靜音計時** 下表重點介紹靜音時間和靜音之間的差異。 | 靜音計時 | 靜音 | | --- | --- | | 使用可重複發生的時間間隔定義 | 有固定的開始和結束時間 | | 已建立 ，然後新增至通知政策 | 使用標籤來比對提醒，以判斷是否靜音 | **建立靜音計時** 1. 在 Grafana 主控台的 Grafana 功能表中，選擇**警示 **（鈴鐺） 圖示以開啟**警示**頁面。 1. 選擇**通知政策**。 1. 從 **Alertmanager** 下拉式清單中，選取您要編輯的 Alertmanager。 1. 在**靜音計時**區段中，選擇**新增靜音計時**按鈕。 1. 選擇您要套用靜音調整的時間間隔。 1. 選擇**提交**以建立靜音計時。 **將靜音時間新增至通知政策** 1. 選取您要新增靜音時間的通知政策，然後選擇**編輯**按鈕。 1. 從**靜音時間**下拉式清單中，選取要新增至政策的靜音時間。 選擇**儲存政策**按鈕。 **時間間隔** 時間間隔是一段時間範圍內的定義。如果在此間隔期間啟動提醒，則會予以隱藏。使用 支援範圍 `:`（例如，`monday:thursday`)。靜音計時可包含多個時間間隔。時間間隔包含多個欄位 （詳細資訊請參閱下列清單），所有欄位都必須相符才能隱藏提醒。例如，如果您指定星期幾`monday:friday`和時間範圍為 8：00-9：00，則警示會在週一至週五的 8-9 之間隱藏，但不會在週六的 8-9 之間隱藏。 + **時間範圍** – 一天中隱藏通知的時間。包含兩個子欄位，**開始時間**和**結束時間**。範例時間為 `14:30`。時間以 24 小時表示，以 UTC 表示。 + **星期幾** – 星期幾。可以是一天，例如 `monday`、範圍，例如 `monday:friday`，或逗號分隔的天數清單，例如 `monday, tuesday, wednesday`。 + **月** – 要選取的月。您可以使用數字指定來指定月份，或使用完整月份名稱來指定月份，例如，`1`或`january`同時指定一月。您可以指定單一月份、月份範圍或以逗號分隔的月份清單。 + **當月天數** – 一個月內的日期。值的範圍可以是 `1`-`31`。負值會以相反順序指定月份的天數，因此 `-1`代表該月的最後一天。月份的天數可以指定為一天、天數範圍或逗號分隔的天數清單。