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

# 註釋視覺效果
<a name="v9-panels-annotate-visualizations"></a>

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

註釋提供使用豐富事件在圖形上標記點的方法。當您將滑鼠暫留在註釋上時，您可以取得事件描述和事件標籤。文字欄位可以包含其他系統的連結，其中包含更多詳細資訊。

**原生註釋**

Grafana 隨附原生註釋存放區，以及直接從圖形面板或透過 HTTP API 新增註釋事件的功能。

**新增註釋**

1. 在儀表板中，按一下**時間序列**面板。隨即顯示內容功能表。

1. 在內容功能表中，按一下**新增註釋**。

1. 新增註釋描述，以及選擇性的標籤。

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

或者，若要新增註釋，`Ctrl+Click`或在**時間序列**面板`Cmd+Click`上，則會顯示**新增註釋**快顯視窗。

**新增區域註釋**

1. 在儀表板中，`Ctrl+Click`或在**時間序列**面板`Cmd+Click`上。

1. 在內容功能表中，按一下**新增註釋**。

1. 新增註釋描述，以及選擇性的標籤。

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

**編輯註釋**

1. 在儀表板中，將滑鼠暫留在**時間序列**面板上的註釋指標上。

1. 按一下註釋工具提示中的編輯 （鉛筆） 圖示。

1. 修改描述，以及選擇性的標籤。

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

**刪除註釋**

1. 在儀表板中，將滑鼠暫留在**時間序列**面板上的註釋指標上。

1. 按一下註釋工具提示中的垃圾桶圖示。

**內建查詢**

新增註釋之後，它們仍然可見。這是因為存在於所有儀表板上的內建註釋查詢。此註釋查詢將擷取來自目前儀表板的所有註釋事件，並在建立它們的面板上顯示它們。這包括提醒狀態歷史記錄註釋。您可以開啟註釋設定 （透過儀表板齒輪功能表） 並修改名為 的查詢，以停止擷取和繪製**註釋**`Annotations & Alerts (Built-in)`。

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

**依標籤查詢**

您可以建立新的查詢，透過`-- Grafana --`資料來源從原生註釋存放區擷取註釋，方法是將**篩選條件**設定為 `Tags`。

Grafana v8.1 和更新版本也支援預先輸入現有標籤，至少提供一個標籤。

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

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

**查詢其他資料來源**

註釋事件會透過註釋查詢擷取。若要將新的註釋查詢新增至儀表板，請開啟儀表板設定選單，然後選取**註釋**。這會開啟儀表板註釋設定檢視。若要建立新的註釋查詢，請按一下**新增**按鈕。

指定註釋查詢的名稱。此名稱會提供給切換 （核取方塊），可讓您啟用或停用顯示來自此查詢的註釋事件。例如，您可能有兩個名為 `Deploys`和 的註釋查詢`Outages`。切換可讓您決定要顯示哪些註釋。

**註釋查詢詳細資訊**

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