本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Annotations
<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)