这是存档文档v9.0.去最新版本

;指示板;注释

注释

注释提供了一种用丰富的事件在图上标记点的方法。将鼠标悬停在注释上时,可以获得事件描述和事件标记。文本字段可以包含到其他系统的链接,提供更详细的信息。

本机注释

Grafana附带了一个本地注释存储,并能够直接从图形面板或通过HTTP API

添加注释

  1. 在仪表板上单击时间序列面板。将出现一个上下文菜单。
  2. 在上下文菜单中单击添加注释添加注释上下文菜单
  3. 添加注释描述和标记(可选)。添加注释弹窗
  4. 单击save。

或者,添加注释,Ctrl/Cmd+单击时间序列面板和添加注释弹出窗口将出现

添加区域注释

  1. 在仪表板上按Ctrl/Cmd+单击并拖动时间序列面板。添加注释弹窗
  2. 添加注释描述和标记(可选)。
  3. 单击save。

编辑注释

  1. 在仪表板中,将鼠标悬停在时间序列面板上的注释指示器上。添加注释弹窗
  2. 单击注释工具提示中的铅笔图标。
  3. 修改描述和/或标签。
  4. 单击save。

删除注释

  1. 在仪表板中,将鼠标悬停在时间序列面板上的注释指示器上。添加注释弹窗
  2. 单击注释工具提示中的垃圾图标。

内置查询

在您添加注释之后,它们仍然是可见的。这是因为所有仪表板上都有内置的注释查询。这个注释查询将获取来自当前仪表板的所有注释事件,并在创建它们的面板上显示它们。这包括警报状态历史注释。控件可以停止获取和绘制注释注释设置(通过Dashboard cogs菜单)和修改查询命名注释和警报(内置)

方法复制指示板时另存为它将获得一个新的仪表板id,因此在源仪表板上创建的注释将不再在副本上可见。如果你添加一个新的,你仍然可以显示它们注释查询并通过标记进行筛选。但这只有在源仪表板上的注释有可筛选的标记时才有效。

按标签查询

方法可以创建从本机注释存储区获取注释的新查询——格拉夫娜——通过设置数据源通过过滤标签

Grafana v8.1和更高版本还支持在现有标记之前输入,提供至少一个标记。

例如,创建注释查询名称中断并指定一个标记停机.该查询将显示所有注释(来自任何仪表板或通过API)停机标签。如果在一个注释查询中定义了多个标记,那么Grafana将只显示与所有标记匹配的注释。要修改行为,请启用匹配任何, Grafana将显示包含您提供的任何一个标签的注释。

在Grafana v5.3+中,可以在标记查询中使用模板变量。因此,如果您有一个显示不同服务统计信息的仪表板和一个指示要显示哪些服务的模板变量,那么您现在可以在注释查询中使用相同的模板变量来只显示这些服务的注释。

查询其他数据源

注释事件是通过注释查询获取的。要向仪表板添加新的注释查询,请打开仪表板设置菜单,然后选择注释.这将打开仪表板注释设置视图。来创建一个新的注释查询按钮。

为注释查询指定一个名称。此名称用于切换(复选框),该切换将允许您启用/禁用显示来自此查询的注释事件。例如,您可能有两个注释查询部署而且中断.切换将允许您决定要显示哪些注释。

注释查询详细信息

注释查询选项对于每个数据源都是不同的。有关特定数据源中的注释的信息,请参阅数据源的话题。