Transformations(转换)

概述

参考：

• 官方文档，面板 - 转换
• 官方文档，面板 - 转换 - 转换类型和选项(这里就是详解了每一种转换类型)

Transformations(转换) 经常用在 Table 面板中，我先以一个 Table 作为基础例子来说明 Transformations 的功能

转换顺序

如果同时存在多个转换, 则从上往下一次执行它们，这就有点像 Linux 中的管道，每一个转换会产生一个新的结果，这个结果将会传递给下一个转换继续进行处理。直到所有转换执行完成，在面板展示最终数据。

转换顺序的特性可以在这个例子中可以得到充分体现

Add field from calculation

添加一个新的字段，新字段的值可以通过计算得出。每个使用一次该转换即可添加一个新字段。

Filter by name(根据字段名称进行过滤)

使用 regex pattern(正则表达式模式) 删除部分查询结果，模式可以是包含或者排除。过滤的对象是 Field(字段)。

下图经过过滤后，我们仅显示 instance、pod、Value 这几个字段

Filter data by query

Filter data by query. This is useful if you are sharing the results from a different panel that has many queries and you want to only visualize a subset of that in this panel.

Group by

Group the data by a field values then process calculations for each group

Grouping to Matrix

https://grafana.com/docs/grafana/latest/panels-visualizations/query-transform-data/transform-data/#grouping-to-matrix

案例: https://stackoverflow.com/questions/67003375/in-grafana-how-can-i-turn-rows-into-columns1

分组到矩阵。可以将 一整列数据 按照相同的值进行分组后，将分组后的值作为 列头 或 行头 展示。最多处理3 列（也可以说处理 3 个字段）内容，并生成一个新的矩阵，原始字段的值作为新矩阵的输入，输出到新矩阵的 行、列、单元格 中

TODO: 为什么不能设置将多列的内容转成表头？

假如有如下原始数据：

应用这个转换设置后，让 month 列的值分组后变为 列名；让 event_name 列的值分组后变为 行名；单元格使用 count 列的值进行填充；如果单元格为空使用 0 值。转换后的输出结果为：

转换示例如下（指定了 哪列作为行名、哪列作为列名、哪列作为单元格的值）：

下面的 ClickHouse SQL 就是使用这种转换的最佳实践。转换之后，可以再配合 Add field from calculation 转换添加一列，以展示所有月份的数据总和。

SELECT
    event_name,
    formatDateTime(toStartOfMonth(found_time), '%Y-%m') AS month,
    count() AS count
FROM my_database.my_table
WHERE $__timeFilter(found_time)
GROUP BY event_name, month
ORDER BY event_type, month

Join by field(连接字段) Outer join

Joins many time series/tables by a field. This can be used to outer join multiple time series on the time field to show many time series in one table.

Labels to fields

Groups series by time and return labels or tags as fields. Useful for showing time series with labels in a table where each label key becomes a seperate column

Merge(合并)

Merge many series/tables and return a single table where mergeable values will be combined into the same row. Useful for showing multiple series, tables or a combination of both visualized in a table.

合并多个系列/表并返回一个表，其中可合并的值将被合并到同一行中。用于在一个表中显示多个序列、表或两者的组合。

Organize fields(组织字段)

重命名，重新排序或隐藏查询返回的字段。

下图经过组织后，字段的名称得以改变

Reduce(裁剪)

裁剪所有行或数据点，变为单个值。裁剪之后，可以通过 max、min、mean、last 之类的函数，显示对应的值。

下图就是裁剪之后的样式，原先的多个 Field，被整合到一个 Field，作为整个 Fild 的元素，每个元素都可以有一个或多个值(在对话框中可以选择要显示的值类型)。

我们使用 DeBug 模式可以看到这些数据在转换前后的样子：

从下图可以看出来，转换前有 10 个 Fields(包括时间)。转换后，原 Fields 的 name 会作为新 Fields 的元素进行填充。

Rename by regex(通过正则表达式重命名)

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

在下面的示例中，可以看到 instance 标签的值都带着 :9100，实际情况下，我们并不需要显示端口，那么就可以通过 Rename by regex 将其去掉

应用这个转换类型后，可以看到只剩下除了 9100 以外的字符串了。

Series to rows

Merge many series and return a single series with time, metric and value as columns. Useful for showing multiple time series visualized in a table.

合并多个系列，并以时间，度量和值作为列返回单个系列。 用于显示表格中可视化的多个时间序列。

将来自多个时间序列数据查询的结果合并为一个结果。 使用表格面板可视化效果时，这很有帮助。