本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
註解視覺效果
本文件主題是針對支援 Grafana 9.x 版的 Grafana 工作區所設計。
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱。在 Grafana 第 10 版工作
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱。在 Grafana 第 8 版中工作
註釋提供了一種使用豐富事件標記圖形上的點的方法。當您將游標停留在註解上時，您可以取得事件說明和事件標籤。文字欄位可以包含更詳細的其他系統的連結。
原生註解
Grafana 隨附原生註解存放區，可直接從圖形面板或透過 HTTP API 新增註解事件。
新增註釋
-
在儀表板中，按一下「時間序列」面板上的。上下文菜單將出現。
-
在關聯式功能表中，按一下「加入註解」。
-
加入註解描述，並選擇性地加入標籤。
-
按一下 Save (儲存)。
或者，若要新增註釋，Ctrl+Click或Cmd+Click在「時間序列」面板和「新增註解」彈出式視窗中會出現。
加入區域註釋
-
在管控面板
Ctrl+Click或「時間序列」面板Cmd+Click上。 -
在上下文菜單中，單擊添加註釋。
-
加入註解描述，並選擇性地加入標籤。
-
按一下 Save (儲存)。
編輯註釋
-
在管控面板中，將游標暫留在「時間序列」面板上的註釋指示器上。
-
按一下註解工具提示中的編輯 (鉛筆) 圖示。
-
修改描述，並選擇性地修改標籤。
-
按一下 Save (儲存)。
刪除註釋
-
在管控面板中，將游標暫留在「時間序列」面板上的註釋指示器上。
-
按一下註解工具提示中的垃圾桶圖示。
內建查詢
加入註釋後，它們仍然可見。這是因為所有儀表板上都存在內建註解查詢。此註釋查詢將獲取源自當前儀表板的所有註釋事件，並將其顯示在創建它們的面板上。這包括警示狀態歷程記錄註釋。您可以開啟「註釋」設定 (透過「儀表板齒輪」(Dashboard 齒輪選單) 並修改名為的查詢，來停止擷取和繪製註釋。Annotations &
Alerts (Built-in)
當您使用「另存新檔」功能複製儀表板時，它會取得新的儀表板 ID，因此在來源儀表板上建立的註釋將不再顯示在副本上。如果您加入新的註釋查詢並依標籤篩選，您仍然可以顯示它們。這只有在來源儀表板上的註釋具有要篩選的標籤時才有效。
按標籤查詢
您可以透過將「篩選條件」設定為，建立新查詢以透過-- Grafana --資料來源從原生註解存放區擷取註釋Tags。
Grafana v8.1 及更高版本也支援預先輸入現有標籤，至少提供一個標籤。
例如，建立註解查詢名稱outages並指定標籤outage。此查詢將顯示帶有中斷標籤的所有註釋（從任何儀表板或通過 API）。如果在註釋查詢中定義了多個標籤，則 Grafana 將僅顯示符合所有標籤的註釋。若要修改行為，請啟用Match
any，然後 Grafana 會顯示包含您提供之任何一個標籤的註解。
在 Grafana v5.3 + 中，可以在標籤查詢中使用模板變量。因此，如果您有顯示不同服務統計資料的儀表板，以及指定要顯示哪些服務的範本變數，您現在可以在註解查詢中使用相同的範本變數，僅顯示這些服務的註解。
查詢其他資料來源
註釋事件通過註釋查詢獲取。若要將新的註釋查詢新增至儀表板，請開啟儀表板設定功能表，然後選取「註釋」。這將打開儀表板註釋設置視圖。若要建立新的註解查詢，請按 [新增] 按鈕。
指定註釋查詢的名稱。此名稱會指定給切換 (核取方塊)，可讓您啟用或停用顯示此查詢的註解事件。例如，您可能有兩個名為Deploys和的註釋查詢Outages。該切換將允許您決定要顯示的註釋。
註釋查詢詳情
每個資料來源的註解查詢選項都不同。有關特定資料來源中註釋的資訊，請參閱特定資料來源主題。
