Annotations

Grafana 中提供了一个 Annotations 注释的方法，通过该方式可以在图形上标记一个点，当将鼠标悬停在上面的时候，可以获得该注释的具体信息，我们可以在 Panel 面板中某一个点添加注释，也可以在某一个区域内添加注释。

Grafana 带有本地注释存储，并且能够直接从图形面板或通过 HTTP API 添加注释事件。

在某一个点添加注释，我们只需要按住 Ctrl/Cmd 键点击鼠标左键（也可以直接点击左键会弹出添加注释的对话框），然后就可以添加注释描述和标签，标签可以添加多个。当添加区域注释的时候我们也可以按住 Ctrl/Cmd 并选择区域来创建区域注释。

添加注释

接下来我们以 CPU 使用率的图形面板中来添加注释为例进行说明，我们可以将鼠标移动到图形中需要添加注释的点位置，然后按住 Ctrl/Cmd 按键点击左键，或者直接在需要添加注释的点点击左键，会弹出一个添加注释的对话框：

点击 Add annotation 就会弹出添加注释的对话框：

在对话框中可以输入当前注释的描述信息以及标签，可以添加新的标签也可以选择现有的标签，点击 Save 即可创建注释：

如果要添加一个区域注释的话则最好按住 Cmd/Ctrl 按键然后拖动鼠标选择需要注释的区域，注释添加完后，可以直接在面板上看到，注释一般是以一条竖线或者是一个区域的形式显示，当然我们也可以通过设置来控制注释是否显示。

查询注释

注释创建后默认会一直显示在面板中，但是可以通过设置注释显示或者隐藏，我们可以对 Grafana 默认的注释过滤器 Annotations & Alerts 进行配置，当然也可以创建自定义的注释过滤器，内置的注释过滤器将获取当前 Dashboard 的所有注释事件，并将它们显示在创建它们的面板上。

找到 Annotations & Alerts (Built-in) 这个内置的注释，直接点击开始编辑：

如果去掉 Hidden 复选框，则可以在 Dashboard 最上方看到 Annotations & Alerts 这个选项，将勾去掉，注释消失，选中，注释出现。

此外还可以对注释进行过滤，可以基于 Dashboard 也可以基于标签进行过滤：

当然如果不想使用内置的这个注释，也可以自己单独创建一个来控制注释的查询显示。