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

# 註釋視覺效果
<a name="v10-dash-annotations"></a>

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

註釋提供使用豐富事件在視覺效果上標記點的方法。它們會在所有圖形面板上以垂直線條和圖示視覺化。當您將滑鼠暫留在註釋上時，您可以取得事件描述和事件標籤。文字欄位可以包含其他系統的連結，其中包含更多詳細資訊。

您可以透過三種方式註釋視覺效果：
+ 直接在面板中使用[內建註釋查詢](#v10-dash-built-in-query)。
+ 使用 Grafana HTTP API。
+ 在儀表板設定中設定註釋查詢。

在前兩個案例中，您要建立新的註釋，而在最後從資料來源查詢現有的註釋。內建註釋查詢也支援此功能。

本節說明第一個和第三個選項；如需使用 Grafana HTTP API 的相關資訊，請參閱 [註釋 API](v10-Grafana-API-Annotations.md)。

下列視覺化類型支援註釋：
+ 時間序列 
+ 狀態時間軸
+ 蠟燭圖

## 在面板中建立註釋
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana 能夠使用所有儀表板上存在的[內建註釋查詢，直接從面板新增註釋](#v10-dash-built-in-query)事件。您以這種方式建立的註釋會存放在 Grafana 中。

若要直接在面板中新增註釋：
+ 必須已儲存儀表板。
+ 必須啟用內建查詢。

**新增註釋**

1. 在儀表板中，選取您要新增註釋的面板。隨即顯示內容功能表。

1. 在內容功能表中，選取**新增註釋**。

1. （選用） 新增註釋描述和標籤。

1. 選取**儲存**。

或者，若要新增註釋，請在選取面板時按 `Ctrl`（或 `Cmd`)，即會顯示**新增註釋**快顯視窗。

**區域註釋**

您也可以建立註釋，涵蓋視覺化中的區域或時段。

**新增區域註釋**

1. 在儀表板中，選取面板的區域時按 `Ctrl`（或 `Cmd`)。

1.  新增註釋描述和標籤 （選用）。

1.  按一下 **Save (儲存)**。

**編輯註釋**

1. 在儀表板中，將滑鼠游標暫留在面板上的註釋指標上。

1. 選取註釋工具提示中的**編輯** （鉛筆） 圖示。

1. 修改描述和/或標籤。

1. 選取**儲存**。

**刪除註釋**

1. 在儀表板中，將滑鼠游標暫留在面板上的註釋指標上。

1. 選取註釋工具提示中的**刪除** （垃圾桶） 圖示。

## 透過儀表板設定擷取註釋
<a name="v10-dash-fetch-annotations"></a>

在儀表板設定中，您可以在**註釋**下新增查詢，以使用任何資料來源擷取註釋，包括內建的資料註釋資料來源。註釋查詢會傳回事件，這些事件可在儀表板的圖形中視覺化為事件標記。

**新增註釋查詢**

1. 選取儀表板標頭中的**設定** （齒輪） 圖示，以開啟設定選單。

1. 選取**註釋**。

1. 按一下**新增註釋查詢**。

1. 輸入註釋查詢的名稱。

   此名稱會提供給切換 （核取方塊），可讓您啟用顯示來自此查詢的註釋事件。

1. 選取註釋的資料來源。

   您也可以選擇**開啟進階資料來源挑選器**以查看更多選項，包括新增資料來源 （僅適用於管理員）。

1. 如果您不想立即使用註釋查詢，請清除**已啟用**核取方塊。

1. 如果您不希望註釋查詢切換顯示在儀表板中，請選取**隱藏**核取方塊。

1. 選取事件標記的顏色。

1. 在**顯示**下拉式清單中，選擇下列其中一個選項：
   + **所有面板** – 註釋會顯示在支援註釋的所有面板上。
   + **選取的面板** – 註釋會顯示在您選取的所有面板上。
   + 除了 **之外的所有面板** – 除了您選取的面板之外，註釋會顯示在所有面板上。

1. 設定查詢。

   每個資料來源的註釋查詢選項都不同。如需特定資料來源中註釋的資訊，請參閱 [連線至資料來源](AMG-data-sources.md)。

## 內建查詢
<a name="v10-dash-built-in-query"></a>

新增註釋之後，它們仍然可見。這是因為所有儀表板上都存在內建註釋查詢。此註釋查詢將擷取來自目前儀表板的所有註釋事件，這些儀表板存放在 Grafana 中，並在建立它們的面板上顯示它們。這包括提醒狀態歷史記錄註釋。

根據預設，內建註釋查詢會使用`Grafana`特殊資料來源，且僅支援使用此資料來源的手動註釋。您可以在內建註釋查詢中使用另一個資料來源，但您只能使用該資料來源的查詢編輯器建立自動註釋。

若要直接將註釋新增至儀表板，必須啟用此查詢。

**確認已啟用內建查詢**

1. 選取儀表板標頭中的儀表板**設定** （齒輪） 圖示，以開啟儀表板設定選單。

1. 選取**註釋**。

1. 尋找**註釋和提醒 （內建） **查詢。

   如果它在查詢名稱之前顯示**已停用**，則您需要選取查詢名稱來開啟它並更新設定。

**停止擷取和繪製註釋**

1. 選取儀表板標頭中的儀表板**設定** （齒輪） 圖示，以開啟儀表板設定選單。

1. 選取**註釋**。

1. 選取**註釋和提醒 （內建） **查詢。

1. 選取**已啟用**切換以將其關閉。

當您使用**「另存新檔**」功能複製儀表板時，它會取得新的儀表板 ID，因此在來源儀表板上建立的註釋將不再顯示在副本上。如果您新增**註釋查詢**並依標籤篩選，仍然可以顯示它們。不過，這只有在來源儀表板上的註釋具有要篩選的標籤時才有效。

**依標籤篩選查詢**

您可以透過將**篩選條件**設定為 ，來建立新的查詢，以使用`Grafana`資料來源從內建註釋查詢擷取註釋`Tags`。

例如，建立註釋查詢名稱`outages`並指定標籤 `outage`。此查詢會顯示具有 `outage`標籤的所有註釋 （來自任何儀表板或透過 API)。如果在註釋查詢中定義多個標籤，則 Grafana 只會顯示符合所有標籤的註釋。若要修改行為，請啟用**任何相符**，Grafana 會顯示包含您提供之任何標籤的註釋。

 您也可以在標籤查詢中使用範本變數。這表示如果您有一個儀表板顯示不同服務的統計資料，以及指定要顯示哪些服務的範本變數，您可以在註釋查詢中使用相同的範本變數，只顯示這些服務的註釋。