转换数据

本文档主题专为支持 Grafana 10.x 版本的 Grafana 工作区而设计。

对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅 使用 Grafana 版本 9。

对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅 使用 Grafana 版本 8。

转换是一种强大方法，可在系统应用可视化之前处理查询返回的数据。通过转换，您可以：

• 重命名字段

• 连接时间序列数据

• 跨查询执行数学运算

• 将一个转换的输出用作另一个转换的输入

对于依赖同一数据集中多个视图的用户来说，转换是一种创建和维护大量控制面板的有效方法。

您也可以将一个转换的输出用作另一个转换的输入，从而提高性能。

注意

有时，系统无法绘制转换后的数据。发生这种情况时，单击可视化上方的表视图切换按钮，以切换到数据的表视图。这有助于您了解转换的最终结果。

转换类型

Grafana 提供了多种转换数据的方式。下面是转换函数的完整列表。

转换顺序

当存在多个转换时，Grafana 会按其列出的顺序来应用。每次转换都会创建一个新的结果集，然后传递给处理管道中的下一个转换。

Grafana 应用转换的顺序会直接影响结果。例如，如果使用 Reduce 转换将一列的所有结果压缩为单个值，则只能对该值应用转换。

向数据添加转换函数

以下步骤将指导您向数据添加转换。本文档不包括每种转换类型的步骤。

向面板添加转换

1. 导航到要在其中添加一个或多个转换的面板。

2. 将鼠标悬停在面板的任何部分，右上角就会显示操作菜单。

3. 从操作菜单上选择编辑。

4. 选择转换选项卡。

5. 选择一个转换。此时会显示一个转换行，您可以在其中配置转换选项。

6. 要应用另一个转换，请选择添加转换。这次转换对上一次转换返回的结果执行操作。

调试转换

要查看转换的输入和输出结果集，请选择转换行右侧的调试（bug）图标。这将显示输入数据，并将转换结果显示为输出。

输入和输出结果集有助于调试转换。

禁用转换

您可以选择转换行右上角的显示（眼睛）图标来禁用或隐藏转换。这将禁用该特定转换的应用操作，并有助于在逐个更改多个转换时识别问题。

筛选转换

如果您的转换使用多个查询，则可以筛选这些查询，并将所选转换仅应用于其中一个查询。为此，请选择转换行右上角的筛选器图标。这将打开一个下拉列表，其中列出了面板上使用的查询列表。在这里，您可以选择要转换的查询。

您也可以按注释（包括样本）进行筛选，对其应用转换。执行此操作时，字段列表会发生变化，以反映注释或样本工具提示中的字段。

如果面板具有多个查询或数据来源（即面板或注释数据），则始终显示筛选器图标，但如果应用先前的合并查询输出的转换，则筛选器图标可能不起作用。这是因为转换会采用前一个转换的输出。

删除转换

建议删除不需要的转换。删除转换时，即从可视化中删除数据。

先决条件：

识别所有依赖转换的控制面板，并通知受影响的控制面板用户。

删除转换

1. 打开面板进行编辑。

2. 选择转换选项卡。

3. 选择要删除的转换旁边的垃圾桶图标。