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

转换函数

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

从计算中添加字段

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

连接字段

连接字段

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

例如，如果您有单独的查询来检索温度和正常运行时间数据（查询 A）以及空气质量指数和错误信息（查询 b），则应用串联变换会生成一个合并的数据框，其中所有相关信息都在一个视图中。

考虑以下两个。

查询 A：

查询 B：

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

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

来自查询结果的 Config

来自查询结果的 Config

使用此转换可以选择一个查询并提取标准选项，例如最小值、最大值、单位和阈值，然后将其应用于其他查询结果。这样可以根据特定查询返回的数据进行动态可视化配置。

Options

字段映射表

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

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

输入查询

Config 查询

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

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

值映射

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

Config 查询结果

在字段映射中，指定：

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

转换字段类型

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

此转换有以下选项：

例如，考虑以下查询，通过选择时间字段作为时间和日期格式为，可以对其进行修改YYYY。

结果：

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

提取字段

使用此转换可以选择数据源并从中提取不同格式的内容。此转换包含以下字段：

考虑以下数据集：

数据集示例

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

这将生成以下输出：

转换后的数据

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

从资源中查找字段

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

此转换包含以下字段：

例如，如果你有这样的数据：

数据集示例

使用此配置：

你会得到以下输出：

转换后的数据

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

按查询 RefID 筛选数据

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

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

按值筛选数据

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

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

所有字段的可用条件为：

数字字段的其他可用条件包括：

考虑以下数据集：

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

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

转换后的数据

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

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

在上面的示例中，我们之所以选择 Match all，是因为我们想包括温度低于 30°C 、海拔高于 100 的行。如果我们想包括温度低于 30°C 或海拔高于 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、Tru e、False 或空。

输出

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

分组到嵌套表

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

要计算字段的统计数据，请选中该字段旁边的复选框并选择计算选项。这将添加另一个包含要选择的统计信息的选择框。

下表显示了示例数据。

这种转换分为两个步骤。首先，指定一个或多个用于对数据进行分组的字段。这会将这些字段的所有相同值分组在一起，就像对它们进行排序一样。例如，如果您按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'}

Config:

value: 'what'

输出：

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

字段的标签

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

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

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

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

值字段名称

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

合并行为

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

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

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

合并后：

限制

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

以下示例说明了 L im it 转换对来自数据源的响应的影响：

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

这种转换可帮助您定制数据的可视化呈现方式，以专注于最相关的数据。

合并系列/表格

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

以下是一个示例插图，说明了 Merge 系列/表格转换对两个返回表数据的查询的影响：

查询 A：

查询 B：

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

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

按名称整理字段

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

变换字段

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

示例

鉴于这个初始查询结果：

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

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

按值分区

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

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

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

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

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

准备时间序列

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

多帧时间序列

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

示例

这个输入：

可以转换为：

宽时间序列

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

示例

这个输入：

可以转换为：

减少

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

考虑一下输入：

查询 A：

查询 B：

还原变压器有两种模式：

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

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

查询 A：

查询 B：

通过正则表达式重命名

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

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

通过这种转换，您可以定制数据以满足您的可视化需求，从而使您的仪表板信息更丰富，更便于用户使用。

行到字段

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

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

这种转换需要：

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

将多余字段映射到标签

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

例如：

输出：

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

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

示例

输入:

输出：

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

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

序列到行

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

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

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

查询 A：

查询 B：

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

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

排序依据

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

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

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

空间

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

这种转换允许您操作和分析地理空间数据，从而实现诸如在点之间创建线、计算空间属性等操作。

时间序列到表格的转换

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

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

回归分析

使用此变换创建包含统计模型预测值的新数据框。这对于在混乱数据中寻找趋势很有用。它的工作原理是使用线性回归或多项式回归将数学函数拟合到数据。然后，可以在可视化中使用该数据框来显示趋势线。

有两种不同的型号：