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

# 註釋
<a name="dashboard-annotations"></a>

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

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

## 原生註釋
<a name="native-annotations"></a>

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

## 新增註釋
<a name="adding-annotations"></a>

 若要新增註釋，請按 **Ctrl** 或 **Cmd**，然後選擇您要新增註釋的位置。若要從其他儀表板搜尋註釋，請在其中新增標籤。

### 新增區域註釋
<a name="adding-regions-events"></a>

 若要建立區域的註釋，請在選擇區域時按 **Ctrl** 或 **Cmd**。

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

 新增註釋後，該註釋會保持可見。這是因為所有儀表板上都存在內建註釋查詢。此註釋查詢會擷取來自目前儀表板的所有註釋事件，並將其顯示在建立它們的面板上。這包括提醒狀態歷史記錄註釋。您可以選擇**儀表板設定** （齒輪） 圖示、選擇**註釋，然後修改名為 的查詢**，以停止擷取和顯示註釋`Annotations & Alerts (Built-in)`。

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

### 依標籤查詢
<a name="annotation-query-by-tag"></a>

 您可以使用`-- Grafana --`資料來源並將**篩選條件**設定為**標籤**，來建立新的註釋查詢，以從原生註釋存放區擷取註釋。指定至少一個標籤。例如，建立名為 的註釋查詢`outages`，並指定名為 的標籤`outage`。此查詢會顯示您建立 （從任何儀表板或透過 API) 且具有 `outage`標籤的所有註釋。

根據預設，如果您在註釋查詢中新增多個標籤，Amazon Managed Grafana 只會顯示具有您提供之所有標籤的註釋。若要顯示至少包含您提供的其中一個標籤的註釋，請開啟**符合任何**標籤。

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

## 查詢其他資料來源
<a name="querying-other-data-sources"></a>

 使用註釋查詢擷取註釋事件。若要將新的註釋查詢新增至儀表板，請選擇**儀表板設定** （齒輪） 圖示，選擇 `Annotations`，然後選擇**新增**。

 指定註釋查詢的名稱。此名稱會以核取方塊顯示，用於顯示或隱藏此查詢的註釋事件。例如，您可能有兩個名為 `Deploys`和 的註釋查詢`Outages`。您可以選取或清除核取方塊，以指定要顯示的註釋。

### 註釋查詢詳細資訊
<a name="annotation-query-details"></a>

 每個資料來源的註釋查詢選項都不同。
+ [使用 Graphite 查詢編輯器的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [使用 OpenSearch 資料來源的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [使用 Prometheus 的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [使用 MySQL 的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [使用 PostgreSQL 的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)