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

转换函数

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

从计算添加字段

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

连接字段

连接字段

使用此转换将所有帧中的所有字段合并为一个结果。

例如，如果您有单独的查询来检索温度和正常运行时间数据（查询 A）以及空气质量指数和错误信息（查询 B），则应用连接转换将生成一个合并的数据框，其中包含所有相关信息。

考虑以下两个查询。

查询 A：

查询 B：

连接字段后，数据帧为：

这种转换简化了合并不同来源数据的过程，为分析和可视化提供了全面的视图。

来自查询结果的配置

来自查询结果的配置

通过这种转换，您可以选择一个查询，从中提取最小值、最大值、单位和阈值等标准选项，并将其应用于其他查询结果。这可以根据特定查询返回的数据实现动态可视化配置。

Options

字段映射表

在配置选项下方，可以找到字段映射表。此表列出了在配置查询返回的数据中找到的所有字段，以及用作和选择选项。可实现对将字段映射到配置属性的控制，对于多行，允许选择要选择的值。

以下示例显示了输入查询和用作字段配置的查询。

输入查询

配置查询

输出查询（与输入相同，但现在的值字段上有配置）

现在，每个字段还设置了最大配置选项。最小值、最大值、单位和阈值等选项是字段配置的一部分。如果进行设置，则可视化将使用这些选项，而不是在面板编辑器选项窗格中手动配置的任何选项。

值映射

您还可以将查询结果转换为值映射。使用此选项，配置查询结果中的每一行都定义了一个值映射行。请参阅以下示例。

配置查询结果

在字段映射中，指定：

Grafana 根据您的查询结果构建值映射，并将其应用于真实的数据查询结果。您应该会看到根据配置查询结果映射和着色的值。

转换字段类型

使用此转换来修改指定字段的字段类型。

此转换具有以下选项：

例如，下面的查询可通过选择时间字段 Time 和日期格式 YYYY 来修改。

结果：

这种转换让您可以灵活地调整数据类型，确保可视化效果的兼容性和一致性。

提取字段

使用此转换选择数据来源，从中提取不同格式的内容。此转换具有以下字段：

考虑以下数据集：

数据集示例

您可以使用以下配置来准备供时间序列面板使用的数据：

这将生成以下输出：

转换后的数据

通过这种转换，您可以通过各种方式提取和格式化数据。您可以根据特定的数据需求自定义提取格式。

从资源中查找字段

使用此转换可通过从外部来源查找其他字段来丰富字段值。

此转换具有以下字段：

例如，如果您拥有以下数据：

数据集示例

使用此配置：

您将得到以下输出：

转换后的数据

这种转换允许您通过从外部来源获取更多信息来扩充数据，提供更全面的数据集进行分析和可视化。

按查询 refId 筛选数据

使用此转换可在包含多个查询的面板中隐藏一个或多个查询。

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

按值筛选数据

使用此转换可直接在可视化中有选择地筛选数据点。此转换提供了根据应用于选定字段的一个或多个条件来包含或排除数据的选项。

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

所有字段的可用条件如下：

数值字段的其他可用条件如下：

考虑以下数据集：

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

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

转换后的数据

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

当您有多个条件时，您可以选择是希望将操作（包括/排除）应用于您添加的 Match all 条件的行，还是 Match any 条件的行。

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

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

这种多功能数据筛选转换允许您根据特定条件有选择地包含或排除数据点。自定义标准以定制您的数据呈现方式，从而满足您独特的分析需求。

按名称筛选字段

使用此转换可删除部分查询结果。可通过三种方式筛选字段名称：

使用正则表达式

使用正则表达式进行筛选时，会包含与正则表达式匹配的字段名称。例如，使用正则表达式 'prod.*' 将仅返回以 prod 开头的字段

正则表达式可以包含使用 ${variableName} 语法插值的控制面板变量。

手动选择包含的字段

选择或取消选择字段名称以将其从结果中删除。如果还包含正则表达式，则包含与表达式匹配的字段，即使未选中这些字段。

使用控制面板变量

选择来自变量以选择用于包含字段的控制面板变量。通过设置具有多个选项的控制面板变量，可以在多个可视化中显示相同的字段。

通过这种转换，您可以灵活地定制查询结果，以便专注于有效分析和可视化所需的特定字段。

格式化字符串

使用此转换来自定义字符串字段的输出。此转换具有以下字段：

这种转换提供了一种便捷的方式来标准化和定制字符串数据的表示方式，以实现更好的可视化和分析。

格式化时间

使用此转换来自定义时间字段的输出。可以使用 Moment.js 格式字符串来格式化输出。例如，如果您只想显示时间字段的年份，则可以使用格式字符串“YYYY”来显示日历年份（例如，1999 年或 2012 年）。

转换前：

涂上 “YYYY-MM-DD hh: mm: ss” 之后：

通过此转换，您可以定制可视化中的时间表示形式，从而在显示时态数据时提供灵活性和精度。

Group by (分组依据)

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

以下是原始数据的示例：

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

包含相同服务器 ID 值的所有行将分组在一起。

选择作为数据分组依据的字段后，可以在其他字段上添加各种计算，计算将应用于每组行。例如，您可能想要计算每台服务器的平均 CPU 温度。因此，我们可以将应用于 CPU 温度字段的平均值计算相加，得到以下结果：

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

然后我们会得到：

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

分组到矩阵

使用此转换来组合三个字段（用作查询输出中的列、行和单元格值字段的输入）并生成矩阵。矩阵的计算方式如下：

原始数据

我们可以使用 Server Status 的值作为列名、Server ID 值作为行名、CPU Temperature 作为每个单元格的内容来生成一个矩阵。每个单元格的内容将显示在现有列（Server Status）和行组合（Server ID）中。对于其余单元格，您可以选择在 Null、True、False 或 Empty 之间显示哪个值。

输出

使用此转换通过指定查询结果中的字段来构造矩阵。矩阵输出反映了这些字段中唯一值之间的关系。这有助于您以清晰、结构化的矩阵格式呈现复杂的关系。

分组到嵌套表

使用此转换按指定的字段（列）值对数据分组，并处理每个组的计算。生成的记录共享相同的分组字段值，并显示在嵌套表中。

要计算字段的统计数据，请选择字段旁边的框，然后选择计算选项。这将添加另一个选择框，其中包含要选择的统计数据。

下表显示了示例数据。

此转换分两个步骤。首先，指定一个或多个字段，作为数据分组依据。这会将这些字段的所有相同值分组在一起，就像对其进行排序一样。例如，如果您按 Server ID 字段分组，Grafana 会按以下方式对数据分组：

选择作为数据分组依据的字段后，可以在其他字段上添加各种计算，计算将应用于每组行。例如，您可能想要计算每台服务器的平均 CPU 温度。因此，将应用于 CPU 温度字段的平均值计算相加，得到以下结果：

创建热图

使用此转换来准备直方图数据，以可视化一段时间内的趋势。与热图可视化类似，此转换将直方图指标转换为时间桶。

X 桶

此设置决定如何将 x 轴拆分为桶。

Y 桶

此设置决定如何将 y 轴拆分为桶。

假设有以下数据集：

直方图

使用此转换可根据输入数据生成直方图，从而可视化值的分布。

原始数据

序列 1：

序列 2：

输出

使用生成的直方图可视化值的分布，从而深入了解数据的分布和密度。

按字段连接

使用此转换将多个结果合并到一个表中，从而合并来自不同查询的数据。

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

内连接

内连接合并多个表中的数据，其中所有表共享选定字段中的相同值。这种类型的连接会排除每个结果中值不匹配的数据。

使用此转换将多个查询结果（通过连接字段或首次列组合）合并为一个结果，并删除无法成功连接的行。

在以下示例中，两个查询返回表数据。在应用内连接转换之前，将其可视化为两个独立的表。

查询 A：

查询 B：

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

外连接

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

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

查询 A：

查询 B：

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

按标签连接

使用此转换将多个结果连接到一个表中。

这对于将多个时间序列结果转换为具有共享标签字段的单个宽表特别有用。

示例

输入 1：series1{what='Temp', cluster='A', job='J1'}

输入 2：series2{what='Temp', cluster='B', job='J1'}

输入 3：series3{what='Speed', cluster='B', job='J1'}

配置：

value: 'what'

输出：

通过这种转换，有效地组合和整理时间序列数据，以获得全面的见解。

标签到字段

使用此转换将带有标签或标记的时间序列结果转换为表，包括结果中每个标签的键和值。将标签显示为列值或行值，以增强数据可视化。

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

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

在“行”模式下，结果对每个序列都创建一个表，并显示每个标签值，如下所示：

值字段名称

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

合并行为

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

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

首先会生成这两个表：

合并后：

限制

使用此转换来限制显示的行数，提供更集中的数据视图。这在处理大型数据集时特别有用。

以下示例说明了限制转换对数据来源响应的影响：

以下是添加值为“3”的限制转换后的结果：

此转换可帮助您定制数据的可视化表示形式，以专注于最相关的数据。

合并序列/表

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

下面是一个示例，说明了合并序列/表转换对返回表数据的两个查询的影响：

查询 A：

查询 B：

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

这种转换将查询 A 和查询 B 中的值合并到一个统一的表中，从而增强了显示效果，以获得更好的见解。

按名称整理字段

使用此转换可重命名、重新排序或隐藏面板中单个查询返回的字段。此转换仅适用于具有单个查询的面板。如果您的面板有多个查询，则必须应用外连接转换或删除多余的查询。

转换字段

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

示例

鉴给定此初始查询结果：

您可以应用重命名字段覆盖来创建：

通过此转换，您可以定制查询结果的显示，从而确保在 Grafana 中清晰而有洞察力的方式表示数据。

按值分区

使用此转换可以简化绘制多个序列的过程，而无需使用不同的 WHERE 子句进行多次查询。

这在使用指标 SQL 表时特别有用，如以下示例所示：

通过按值分区转换器，您可以发出单个查询，并根据您选择的一个或多个列（字段）中的唯一值来拆分结果。下面的示例使用了 Region。

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

这种转换简化了流程，提高了在同一时间序列可视化中可视化多个序列的灵活性。

准备时间序列

使用此转换可以解决当数据来源返回的时间序列数据格式与所需可视化的格式不兼容的问题。这种转换允许您在宽格式和长格式之间转换时间序列数据。

多帧时间序列

使用此选项可将时间序列数据帧从宽格式转换为长格式。当您的数据来源以需要重塑的格式提供时间序列信息，以使其与可视化最佳兼容时，这尤其有用。

示例

以下输入：

可以转换为：

宽时间序列

使用此选项可将时间序列数据帧从长格式转换为宽格式。当您的数据来源以长格式提供时间序列数据，而您的可视化需要宽格式时，这尤其有用。

示例

以下输入：

可以转换为：

Reduce

使用此转换将计算应用于数据帧中的每个字段，并返回单个值。这种转换对于将多个时间序列数据合并成更紧凑的汇总格式特别有用。应用此转换时，将删除时间字段。

考虑以下输入：

查询 A：

查询 B：

reduce 转换器具有两种模式：

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

最后一次计算的 Reduce 字段会产生两个帧，每个帧都有一行：

查询 A：

查询 B：

按正则表达式重命名

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

您可以指定一个正则表达式，该正则表达式只应用于匹配，同时指定一个支持反向引用的替换模式。例如，假设您在可视化每台主机的 CPU 使用情况，并希望删除域名。您可以将正则表达式设置为 ([^\.]+)\..+，并将替换模式设置为 $1，web-01.example.com 将变为 web-01。

通过这种转换，您可以定制数据以满足可视化需求，从而使您的控制面板信息更丰富且用户友好。

行到字段

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

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

这种转换需要：

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

将多余字段映射到标签

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

示例：

输出：

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

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

示例

输入:

输出：

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

这种转换允许将行转换为单个字段，便于动态字段配置，并将其他字段映射到标签。

序列到行

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

此转换的结果将包含三列：时间、指标和值。添加指标列是为了方便您查看该指标来自哪个查询。通过在来源查询上定义标签来自定义此值。

在下面的示例中，有两个查询返回时间序列数据。在应用转换之前，将其可视化为两个独立的表。

查询 A：

查询 B：

以下是将序列应用于行转换后的结果。

这种转换有助于合并来自多个时间序列查询的结果，提供了一个简化的统一数据集，以便以表格形式进行高效的分析和可视化。

排序依据

使用此转换可根据指定字段对查询结果中的每个帧进行排序，从而使您的数据更易于理解和分析。通过配置所需的排序字段，您可以控制数据在表或可视化中的显示顺序。

使用反向开关对指定字段内的值进行反向排序。当您想要在升序和降序之间快速切换以满足分析需求时，此功能特别有用。

例如，在从数据来源检索时间序列数据的场景中，可以应用排序依据转换，以根据时间戳按升序或降序排列数据帧，具体取决于分析要求。此功能可确保您轻松导航和解释时间序列数据，从有序且视觉连贯的演示中获得有价值的见解。

空间

使用此转换将空间运算应用于查询结果。

此转换让您可以操作和分析地理空间数据，从而支持在点之间创建线条、计算空间属性等操作。

时间序列到表的转换

使用此转换将时间序列结果转换为表，将时间序列数据帧转换为趋势字段。然后可以使用迷你图单元格类型呈现趋势字段，为每个表格行生成内联迷你图。如果有多个时间序列查询，则每个查询都将生成一个单独的表数据帧。可使用连接或合并转换来连接这些数据，以生成一个每行包含多个迷你图的表。

对于每个生成的趋势字段值，可以选择计算函数。默认为最后一个非 null 值。此值显示在迷你图旁边，用于对表行进行排序。

回归分析

使用此转换创建一个新的数据帧，其中包含统计模型预测值。这对于在混乱数据中发现趋势非常有用。其工作原理是使用线性或多项式回归将数学函数拟合到数据。然后，在可视化中使用数据帧来显示趋势线。

有两种不同的模式：