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

# 对可视化进行注释
<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. 单击**保存**。

或者，要添加注释，请在**时间序列**面板上 `Ctrl+Click` 或 `Cmd+Click`，将会显示**添加注释**弹出窗口。

**添加区域注释**

1. 在控制面板中，在**时间序列**面板上 `Ctrl+Click` 或 `Cmd+Click`。

1. 在上下文菜单中，单击**添加注释**。

1. 添加注释描述和标签（可选）。

1. 单击**保存**。

**编辑注释**

1. 在控制面板中，将鼠标悬停在**时间序列**面板中的注释指示器上。

1. 单击注释工具提示中的编辑（铅笔）图标。

1. 修改描述和标签（可选）。

1. 单击**保存**。

**删除注释**

1. 在控制面板中，将鼠标悬停在**时间序列**面板中的注释指示器上。

1. 单击注释工具提示中的垃圾桶图标。

**Built-in query**

添加注释后，将仍然可见。这是因为所有控制面板上都存在内置的注释查询。此注释查询将获取源于当前控制面板的所有注释事件，并将其显示在创建事件的面板上。这包括警报状态历史记录注释。您可以打开“注释”设置（通过控制面板齿轮菜单），并修改名为 `Annotations & Alerts (Built-in)` 的查询，来阻止获取和绘制**注释**。

当您使用**另存为**功能复制控制面板时，将获得一个新的控制面板 ID，因此在来源控制面板上创建的注释将不再显示在副本上。如果您添加新的**注释查询**并按标签筛选，则仍然可以显示。仅当来源控制面板上的注释具有可筛选的标签时，这才有效。

**按标签查询**

您可以将**筛选依据**设置为 `Tags` 来创建新的查询，以通过 `-- Grafana --` 数据来源从原生注释存储库获取注释。

Grafana v8.1 及更高版本还支持提前输入现有标签，至少提供一个标签。

例如，创建注释查询名称 `outages` 并指定标签 `outage`。此查询将显示带有中断标签的所有注释（来自任何控制面板或通过 API）。如果在注释查询中定义了多个标签，Grafana 将仅显示与所有标签匹配的注释。要修改行为，请启用 `Match any`，Grafana 将显示包含您提供的任何一个标签的注释。

在 Grafana v5.3\+ 中，可在标签查询中使用模板变量。因此，如果您有一个显示不同服务的统计信息的控制面板和一个指示显示哪些服务的模板变量，您现在可以在注释查询中使用相同的模板变量，仅显示这些服务的注释。

**查询其他数据来源**

注释事件是通过注解查询获取的。要向控制面板添加新的注释查询，请打开控制面板设置菜单，然后选择**注释**。这将打开控制面板注释设置视图。要创建新的注释查询，请单击**新建**按钮。

指定注释查询的名称。此名称被赋予切换功能（复选框），允许您启用或禁用此查询中显示的注释事件。例如，您可能有两个名为 `Deploys` 和 `Outages` 的注释查询。通过切换，您可以决定显示哪些注释。

**注释查询详细信息**

每个数据来源的注释查询选项都不同。有关特定数据来源中注释的信息，请参阅特定[数据来源](AMG-data-sources.md)主题。