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

转换数据

在系统应用可视化之前，转换是一种强大的操作查询返回的数据的方法。使用变换，您可以：

对于依赖同一数据集的多个视图的用户，转换提供了一种创建和维护大量仪表板的有效方法。

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

转换类型

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

变换顺序

当有多个变换时，Grafana 会按照列出的顺序应用它们。每次转换都会创建一个结果集，然后将其传递到处理管道中的下一个转换。

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

向数据添加转换函数

以下步骤将指导您向数据添加转换。

调试转换

要查看转换的输入和输出结果集，请选择转换行右侧的错误图标。

输入和输出结果集可以帮助您调试转换。

删除转换

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

先决条件：

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

转换函数

您可以对数据执行以下转换。

从计算中添加字段

使用此转换可以添加一个根据其他两个字段计算得出的新字段。每次转换都允许您添加一个新字段。

连接字段

此变换将所有帧中的所有字段合并为一个结果。考虑一下这两个查询。

查询 A：

查询 B：

连接字段后，数据框将是：

来自查询结果的 Config

此转换允许您选择一个查询，然后从中提取标准选项，例如最小值、最大值、单位和阈值，并将其应用于其他查询结果。这支持动态查询驱动的可视化配置。

如果您想为配置查询结果中的每一行提取唯一的配置，请尝试将行转换为字段。

Options

转换字段类型

此转换会更改指定字段的字段类型。

例如，通过选择时间字段作为时间，将日期格式选择为YYYY，可以修改以下查询。

结果：

按名称筛选数据

使用此转换可以移除部分查询结果。

Grafana 显示 “标识符” 字段，然后显示查询返回的字段。

您可以通过以下两种方式之一应用过滤器：

按查询筛选数据

如果您想隐藏一个或多个查询，请在包含多个查询的面板中使用此转换。

Grafana 以深灰色文本显示查询标识字母。单击查询标识符可切换筛选。如果查询信是白色的，则会显示结果。如果查询信是深色的，则结果将被隐藏。

按值筛选数据

这种转换允许您直接在 Grafana 中筛选数据，并从查询结果中删除一些数据点。您可以选择包含或排除与您定义的一个或多个条件相匹配的数据。这些条件将应用于所选字段。

如果您的数据源未按值进行本地筛选，则此转换非常有用。如果您使用的是共享查询，也可以使用它来缩小要显示的值。

所有字段的可用条件为：

数值字段的可用条件是：

考虑以下数据集：

如果包括温度低于 30°C 的数据点，则配置将如下所示：

您将得到以下结果，其中仅包括低于 30°C 的温度：

您可以向筛选器中添加多个条件。例如，您可能只想在海拔高度大于 100 时才包含数据。为此，请将该条件添加到以下配置中：

当您有多个条件时，可以选择是否要将操作（包括/排除）应用于匹配所有条件的行还是匹配您添加的任何条件的行。

在上面的示例中，我们之所以选择 Match all，是因为我们想包括温度低于 30 且海拔高于 100 的行。如果我们想包括温度低于 30 或海拔高于 100 的行，则可以选择 Match any。这将包括原始数据中的第一行，其温度为32°C（与第一个条件不匹配），但海拔为101（与第二个条件相匹配），因此将其包括在内。

无效或配置不完整的条件将被忽略。

Group by (分组依据)

此转换按指定的字段（列）值对数据进行分组，并对每个组进行计算。单击查看计算选项列表。

以下是原始数据的示例。

这种转变分为两个步骤。首先，指定一个或多个字段作为数据分组依据。这会将这些字段的所有相同值组合在一起，就像对它们进行排序一样。例如，如果我们按服务器 ID 字段进行分组，那么它将按以下方式对数据进行分组：

服务器 ID 值相同的所有行都组合在一起。

选择要按哪个字段对数据进行分组后，可以在其他字段上添加各种计算，然后将计算应用于每组行。例如，我们可以计算每台服务器的平均CPU温度。因此，我们可以添加应用于 “CPU 温度” 字段的平均值计算得出以下结果：

我们可以添加多个计算。例如：

然后我们会得到：

这种转换使您能够从时间序列中提取关键信息，并以方便的方式显示这些信息。

按字段加入

使用此转换将多个结果联接到一个表中。这对于将多个时间序列结果转换为具有共享时间字段的单个宽表特别有用。

内部联接

内联接合并来自多个表的数据，其中所有表共享选定字段中的相同值。这种类型的联接不包括每个结果中值不匹配的数据。

使用此转换将来自多个查询（合并到传递的联接字段或第一个时间列上）的结果合并为一个结果，并删除无法成功联接的行。

在以下示例中，两个查询返回表数据。在应用内部联接转换之前，它被可视化为两个单独的表。

查询 A：

查询 B：

应用内部联接变换后的结果如下所示：

外连接

外连接包括来自内部联接的所有数据以及每个输入中值不匹配的行。当内部联接在时间字段上连接查询 A 和查询 B 时，外部联接包括时间字段上所有不匹配的行。

在以下示例中，两个查询返回表数据。在应用外部联接转换之前，它被可视化为两个表。

查询 A：

查询 B：

应用外连接转换后的结果如下所示：

字段的标签

此转换会将包含标签或标签的时间序列结果更改为表格，其中每个标签键和值都包含在表结果中。标签可以显示为列或行值。

给定两个时间序列的查询结果：

在 “列” 模式下，结果如下所示：

在 “行” 模式下，每个系列的结果都有一个表格，并显示每个标签值，如下所示：

值字段名称

如果您选择 “服务器” 作为 “值” 字段名称，则服务器标签的每个值都将获得一个字段。

合并行为

字段转换器的标签在内部是两个独立的转换。第一个作用于单个系列，并将标签提取到字段。第二个是合并转换，它将所有结果合并到一个表中。合并转换会尝试在所有匹配的字段上进行联接。此合并步骤是必需的，无法关闭。

为了说明这一点，这里有一个示例，其中有两个查询返回没有重叠标签的时间序列。

这将首先生成以下两个表：

合并后：

合并

使用此转换可将多个查询的结果合并为一个结果。这在使用表格面板可视化时很有用。可以合并的值合并到同一行中。如果共享字段包含相同的数据，则值可以合并。

在下面的示例中，我们有两个返回表数据的查询。在应用转换之前，它会被可视化为两个单独的表。

查询 A：

查询 B：

以下是应用合并转换后的结果：

整理字段

使用此转换可以重命名、重新排序或隐藏查询返回的字段。

Grafana 显示查询返回的字段列表。您可以：

按值分区

在绘制多个系列时，这种转换可以帮助消除使用不同WHERE子句对同一个数据源进行多次查询的需要。考虑一个包含以下数据的指标 SQL 表：

在 v9.3 之前，如果你想在同一个 TimeSeries 面板中绘制美国的红色趋势线和欧盟的蓝色趋势线，你可能需要将其分成两个查询：

SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'

这还要求您提前知道指标表中实际存在哪些区域。

使用按值分割转换器，您现在可以发出单个查询，然后在您选择的一列或多列 (fields) 中按唯一值拆分结果。下面的示例使用了 Region。

SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'

减少

R ed uce 转换对框架中的每个字段应用计算并返回单个值。应用此变换时会移除时间字段。

考虑一下输入：

查询 A：

查询 B：

还原变压器有两种模式：

例如，如果您将 “第一个” 和 “最后一个” 计算与 “序列到行” 转换一起使用，则结果将是：

“最后一次计算” 的 “减少” 字段会生成两个帧，每个帧都有一行：

查询 A：

查询 B：

通过正则表达式重命名

使用此转换可使用正则表达式和替换模式重命名部分查询结果。

您可以指定仅适用于匹配项的正则表达式以及支持反向引用的替换模式。例如，假设您正在可视化每台主机的 CPU 使用率，并且想要删除域名。你可以将正则表达式设置为，([^\.]+)\..+将替换模式设置为$1，web-01.example.com将变成。web-01

行到字段

行到字段转换将行转换为单独的字段。这很有用，因为字段可以单独设置样式和配置。它还可以使用其他字段作为动态字段配置的来源，或将其映射到字段标签。然后，可以使用其他标签为生成的字段定义更好的显示名称。

此转换包括一个字段表，该表列出了配置查询返回的数据中的所有字段。此表允许您控制应将哪个字段映射到每个配置属性（*Use as** 选项）。如果返回的数据中有多行，您也可以选择要选择的值。

这种转换需要：

在以下位置可视化数据时很有用：

将多余字段映射到标签

如果字段未映射到配置属性，Grafana 会自动将其用作输出字段上标签的来源-

例如：

输出：

现在可以在字段显示名称中使用额外的标签，从而提供更完整的字段名称。

如果要从一个查询中提取配置并将其应用于另一个查询，则应使用查询结果转换中的配置。

示例

输入:

输出：

如您所见，源数据中的每一行都变成了一个单独的字段。现在，每个字段还设置了最大配置选项。诸如最小值、最大值、单位和阈值之类的选项都是字段配置的一部分，如果这样设置，则可视化将使用该选项，而不是在面板编辑器选项窗格中手动配置的任何选项。

准备时间序列

当数据源以您要使用的面板不支持的格式返回时间序列数据时，准备时间序列转换非常有用。

这种转换通过将时间序列数据从宽格式转换为长格式或反过来来帮助您解决此问题。

选择多帧时间序列选项，将时间序列数据框从宽格式转换为长格式。

选择宽时间序列选项，将时间序列数据框从长格式转换为宽格式。

序列到行

使用此转换可将多个时间序列数据查询的结果合并为一个结果。这在使用表格面板可视化时很有用。

此转换的结果将包含三列：时间、指标和值。添加了 “指标” 列，因此您可以轻松查看该指标来自哪个查询。通过在源查询中定义 Label 来自定义此值。

在下面的示例中，我们有两个查询返回时间序列数据。在应用转换之前，它会被可视化为两个单独的表。

查询 A：

查询 B：

以下是将 Series 应用于行变换后的结果。

排序依据

此转换将按配置的字段对每一帧进行排序，选中后reverse，值将按相反的顺序返回。

限制

使用此转换来限制显示的行数。

在下面的示例中，我们得到了来自数据源的以下响应：

以下是添加值为 '3' 的 Limit 变换后的结果：