本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Grafana 9 中的面板和可视化
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
*面板*是 Grafana 中的基本可视化构建块。每个面板都有一个特定于面板中所选数据来源的查询编辑器。查询编辑器允许您构建一个查询，以返回要可视化的数据。
每个面板都有各种各样的样式和格式选项。可以拖放面板并调整其大小，以便在控制面板上重新排列。
在添加面板之前，确保已配置数据来源。
可在工作区中安装其他[插件](grafana-plugins.md)以获得其他面板类型。
+ 有关使用特定数据来源的详细信息，请参阅 [连接到数据来源](AMG-data-sources.md)。
**Topics**
+ [面板编辑器概述](v9-panels-editor-overview.md)
+ [配置面板选项](v9-panels-configure-panel-options.md)
+ [配置标准选项](v9-panels-configure-standard-options.md)
+ [查询和转换数据](v9-panels-query-xform.md)
+ [配置阈值](v9-panels-configure-thresholds.md)
+ [配置数据链接](v9-panels-configure-data-links.md)
+ [配置字段覆盖](v9-panels-configure-overrides.md)
+ [配置值映射](v9-panels-configure-value-mappings.md)
+ [配置图例](v9-panels-configure-legend.md)
+ [计算类型](v9-panels-calculation-types.md)
+ [对可视化进行注释](v9-panels-annotate-visualizations.md)
+ [面板检查视图](v9-panels-panel-inspector.md)
+ [Grafana 9 提供的可视化](v9-panels-viz.md)
# 面板编辑器概述
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
本节介绍了 Grafana 面板编辑器的各个区域。
+ 面板标题：标题部分列出了显示面板的控制面板和以下控件：
+ **控制面板设置（齿轮）图标**：单击访问控制面板设置。
+ **丢弃**：丢弃自上次保存控制面板之后，对面板所做的更改。
+ **保存**：保存对面板所做的更改。
+ **应用**：应用您所做的更改，关闭面板编辑器，返回控制面板。您需要保存控制面板，以持久保留所应用的更改。
+ 可视化预览：可视化预览部分包含以下选项：
+ **表视图**：将任何可视化转换为表，以便查看数据。表视图有助于进行问题排查。此视图仅包含原始数据。不包括您可能应用于数据的转换，也不包括[表](v9-panels-table.md)可视化中可用的格式化选项。
+ **填充**：可视化预览会填充可用空间。如果更改侧窗格的宽度或底部窗格的高度，可视化效果会随之改变以填充可用空间。
+ **实际**：可视化预览的大小与控制面板上的大小完全一致。如果可用空间不足，可视化大小会缩减，同时保留纵横比。
+ **时间范围控制**：**默认**为浏览器本地时区或在更高级别选择的时区。
+ 数据部分：数据部分包含用于输入查询、转换数据和创建警报规则（如适用）的选项卡。
+ **查询选项卡**：选择您的数据来源，并在此处输入查询。
+ **转换选项卡**：应用数据转换。
+ **警报选项卡**：编写警报规则。
+ 面板显示选项：显示选项部分包含选项卡，您可以在其中配置数据可视化的各个方面。
## 打开面板检查抽屉
检查抽屉有助于您了解查询并进行问题排查。您可以查看任何面板的原始数据，将该数据导出到逗号分隔值（CSV）文件，查看查询请求，以及导出面板和数据 JSON。
**注意：**并非所有面板类型都包含所有选项卡。例如，控制面板列表面板没有要检查的原始数据，因此不显示“统计”、“数据”或“查询”选项卡。
面板检查器包含以下选项：
+ 面板检查抽屉显示会在右侧打开一个抽屉。单击右上角的箭头可展开或缩小抽屉窗格。
+ **数据选项卡**：显示应用转换后查询返回的原始数据。默认情况下，不会应用覆盖和值映射之类的字段选项。
+ **统计选项卡**：显示查询花费的时间和返回的数量。
+ **JSON 选项卡**：允许您查看和复制面板 JSON、面板数据 JSON 和数据帧结构 JSON。如果您在预置或管理 Grafana，这非常有用。
+ **查询选项卡**：显示 Grafana 查询数据来源时向服务器发送的请求。
+ **错误选项卡**：显示错误。仅在查询返回错误时可见。
# 配置面板选项
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
Grafana 面板是一个用户界面，用于定义数据来源查询，转换和格式化可视化中显示的数据。
面板编辑器包括一个查询生成器和一系列选项，您可以使用这些选项来转换数据，向面板添加信息。
本主题介绍了如何：
+ 打开面板进行编辑
+ 添加面板标题和描述
+ 查看面板 JSON 模型
+ 添加重复行和面板
## 编辑面板。
将面板添加到控制面板后，可以随时打开面板更改或更新查询、添加数据转换以及更改可视化设置。
1. 打开包含要编辑其面板的控制面板。
1. 将鼠标悬停在面板的任何部分，右上角就会显示操作菜单。
1. 单击菜单并选择**编辑**。
要使用键盘快捷键打开面板，请将鼠标悬停在面板上，然后按 **e** 键。
面板将以编辑模式打开。
## 向面板添加标题和描述
向面板添加标题和描述，与用户共享有关可视化的任何重要信息。例如，使用描述来记录可视化的目的。
1. 编辑面板。
1. 在面板显示选项窗格中，找到**图例选项**部分。
1. 输入**标题**。
在此字段中输入的文本将显示在面板编辑器和控制面板中的面板顶部。
1. 为面板和要显示的数据编写描述。
在此字段中输入的文本将显示在面板左上角的工具提示中。
您可以在**标题**和**描述**字段中使用[定义的变量](v9-dash-variables.md)，但不能使用[全局变量](v9-dash-variable-add.md#v9-dash-variable-add-global)。
## 查看面板 JSON 模型
浏览和导出面板、面板数据和数据帧 JSON 模型。
1. 打开包含面板的控制面板。
1. 将鼠标悬停在面板的任何部分，右上角就会显示操作菜单。
1. 单击菜单并选择**检查 > 面板 JSON**。
1. 在**选择来源**字段中，选择以下选项之一：
+ **面板 JSON**：显示代表面板的 JSON 对象。
+ **面板数据**：显示一个 JSON 对象，该对象表示传递给面板的数据。
+ **DataFrame structure：**显示应用了转换、字段配置和覆盖配置的原始结果集。
1. 要浏览 JSON，请单击 **>** 展开或折叠 JSON 模型的各个部分。
## 配置重复面板
您可以配置 Grafana 以向控制面板动态添加面板或行。动态面板是系统根据变量值创建的面板。变量会动态更改控制面板中所有面板的查询。
**注意**
重复面板需要变量来选择一个或多个项目；不能将面板重复零次以将其隐藏。
**开始前的准备工作：**
+ 确保查询包含多值变量。
**配置重复面板：**
1. 编辑要重复的面板。
1. 在显示选项窗格上，单击**面板选项 > 重复选项**。
1. 选择**方向**。
+ 选择**水平**排列面板 side-by-side。Grafana 可调整重复面板的宽度。当前，您不能将一行中的其他面板与重复的面板混合使用。
+ 选择**垂直**将面板排列成一列。重复面板的宽度与原始重复面板的宽度相同。
1. 要将更改传播到所有面板，请重新加载控制面板。
# 配置标准选项
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
Grafana 中使用的数据模型是一种面向列的表结构，统一了时间序列和表查询结果。此结构中的每一列都称为*字段*。一个字段可以表示单个时间序列或表列。
字段选项允许您更改数据在可视化中的显示方式。您应用的选项和替代不会更改数据，而是改变 Grafana 显示数据的方式。更改选项后，将应用于所有字段，即所有序列或列。例如，如果将单位更改为百分比，则所有带有数值的字段都将以百分比显示。
有关字段格式设置选项的完整列表，请参阅[标准选项定义](#v9-panels-standard-options-definitions)。
**注意**
您可以将标准选项应用于大多数内置 Grafana 面板。一些尚未更新到新面板和数据模型的旧面板和社区面板将缺少全部或部分字段选项。
1. 打开控制面板，单击面板标题，然后单击**编辑**。
1. 在面板显示选项窗格中，找到**标准选项**部分。
1. 选择要应用的标准选项。
1. 要预览更改，请单击您正在编辑的字段选项框的外部，或按 **Enter** 键。
## 标准选项定义
本节介绍了所有可用的标准选项。
您可以将标准选项应用于大多数内置 Grafana 面板。一些尚未更新到新面板和数据模型的旧面板和社区面板将缺少全部或部分字段选项。
除非您在正在编辑的字段选项框外部单击或按 Enter 键，否则大多数字段选项不会影响可视化。
**注意**
我们一直在努力为所有可视化添加和扩展选项，但并非所有选项都适用于所有可视化。
### 单位
允许选择字段应使用的单位。单击**单位**字段，然后向下钻取，直到找到所需的单位。您选择的单位将应用于除时间之外的所有字段。
#### 自定义单位
您也可以使用单位下拉列表来指定自定义单位、自定义前缀或后缀以及日期时间格式。
要选择自定义单位，请输入单位，然后在下拉列表中选择最后一个**自定义：xxx** 选项。
+ **后缀：** 应跟在值后面的自定义单位。
+ **前缀：** 应放在值前面的自定义单位。
+ **时间：** 自定义日期时间格式类型，例如 **time:YYYY-MM-DD**。有关格式语法和选项，请参阅[格式](https://momentjs.com/docs/#/displaying/)。
+ **si:** 自定义 SI 单位。例如：**si: mF**。这个更高级一些，因为您可以指定单位和来源数据比例。因此，如果您的来源数据表示为毫（千），请在单位前面加上该 SI 比例字符。
+ **计数：** 自定义计数单位。
+ **货币：** 自定义货币单位。
您还可以在单位选择器中粘贴原生表情符号，然后将其选择为自定义单位。
#### 字符串单位
Grafana 有时在解析字符串并将其显示为数字时过于激进。要配置 Grafana 以显示原始字符串值，请创建一个字段覆盖，并添加一个带有**字符串**单位的单位属性。
### 最小值
这让您可以设置百分比阈值计算中使用的最小值。留空表示根据所有序列和字段自动计算。
### 最大值
这让您可以设置百分比阈值计算中使用的最大值。留空表示根据所有序列和字段自动计算。
### 小数
指定 Grafana 在渲染值中包含的小数位数。如果将此字段留空，Grafana 会根据值自动截断小数位数。例如，1.1234 将显示为 1.12，100.456 将显示为 100。
要显示所有小数，请将单位设置为**字符串**。
### 显示名称
可设置所有字段的显示标题。您可以使用[变量](v9-dash-variables.md)。
当显示多个统计数据、字段或序列时，此字段控制每个统计数据中的标题。您可以使用 **\$1\$1\$1\$1field.name\$1** 这样的表达式，仅在标题中使用序列名称或字段名称。
假设有一个名为 Temp 的字段，标签为 \$1"Loc"="PBI", "Sensor"="3"\$1
| 表达式语法 | 示例 | 渲染为 | 说明 |
| --- | --- | --- | --- |
| \$1\$1\$1\$1field.displayName\$1 | 与语法相同 | Temp \$1Loc="PBI", Sensor="3"\$1 | 在 \$1\$1 中显示字段名称和标签（如果存在）。如果响应中只有一个标签键，那么对于标签部分，Grafana 会显示不带大括号的标签值。 |
| \$1\$1\$1\$1field.name\$1 | 与语法相同 | Temp | 显示字段的名称（不带标签）。 |
| \$1\$1\$1\$1field.labels\$1 | 与语法相同 | Loc="PBI", Sensor="3" | 显示不带名称的标签。 |
| \$1\$1\$1\$1field.labels.X\$1 | \$1\$1\$1\$1field.labels.Loc\$1 | PBI | 显示指定标签键的值。 |
| \$1\$1\$1\$1field.labels.\$1\$1values\$1 | 与语法相同 | PBI, 3 | 显示用逗号分隔的标签值（不含标签键）。 |
如果在呈现特定字段的表达式后该值为空字符串，则使用默认的显示方法。
### 颜色方案
颜色选项及其对可视化的影响取决于您正在使用的可视化效果。有些可视化有不同的颜色选项。
您可以指定单一颜色，也可以根据值选择连续（渐变）颜色方案。连续颜色使用相对于最小值和最大值的百分比来插值颜色。
选择以下调色板之一：
| 颜色模式 | 说明 |
| --- | --- |
| 单色 | 指定单一颜色，这在覆盖规则中很有用 |
| 来自阈值 | 通知 Grafana 从匹配的阈值中获取颜色 |
| 经典调色板 | Grafana 将通过序列索引在调色板中查找颜色来分配颜色。适用于图形、饼图和其他分类数据可视化 |
| Green-Yellow-Red （按价值计算） | 连续颜色方案 |
| Blue-Yellow-Red （按价值计算） | 连续颜色方案 |
| 蓝色（按值） | 连续颜色方案（面板背景为蓝色） |
| 红色（按值） | 连续颜色方案（面板背景为蓝色） |
| 绿色（按值） | 连续颜色方案（面板背景为蓝色） |
| 紫色（按值） | 连续颜色方案（面板背景为蓝色） |
### 无值
输入当字段值为空或 null 时 Grafana 应显示的内容。默认值为连字符（-）。
# 查询和转换数据
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
Grafana 支持多种类型的[数据来源](AMG-data-sources.md)。数据来源*查询*返回数据，供 Grafana *转换*和可视化。每个数据来源都使用自己的查询语言，而每个数据来源插件都实现了一个名为查询编辑器的查询构建用户界面。
## 关于查询
Grafana 面板通过查询与数据来源通信，查询会检索数据进行可视化。查询是用数据来源使用的查询语言编写的问题。
您可以在面板的数据来源选项中配置查询频率和数据收集限制。Grafana 每个面板最多支持 26 个查询。
有关每个数据来源查询语言的更多信息，请参阅[数据来源](AMG-data-sources.md)部分。
**查询编辑器**
每个数据来源的*查询编辑器*都提供了一个自定义的用户界面，可帮助您编写利用其独特功能的查询。
由于查询语言之间的差异，每个数据来源查询编辑器的外观和功能都不同。根据您的数据来源，查询编辑器可能会提供自动完成功能、指标名称、变量建议或可视化查询构建界面。
有关特定数据来源的独特查询编辑器功能的详细信息，请参阅其文档：
+ 有关 Grafana 中包含的数据来源，请参阅[内置数据来源](AMG-data-sources-builtin.md)。
+ 有关 Grafana Enterprise 中包含的数据来源，请参阅 [连接到企业数据来源](AMG-data-sources-enterprise.md)。
**查询语法**
数据来源使用不同的查询语言来请求数据。有关特定数据来源的独特查询语言的详细信息，请参阅其文档。
**PostgreSQL 示例：**
```
SELECT hostname FROM host WHERE region IN($region)
```
**PromQL 示例：**
```
query_result(max_over_time([${__range_s}s]) != )
```
**特殊数据来源**
Grafana 还包含三种特殊数据来源：**Grafana**、**混合**和**控制面板**。有关详细信息，请参阅数据来源
## 导航查询选项卡
面板的**查询**选项卡由以下元素组成：
+ **数据来源选择器**：选择要查询的数据来源。
+ **查询选项**：设置最大数据检索参数和查询运行时间间隔。
+ **查询检查器按钮**：打开查询检查器面板，您可以在其中查看和优化查询。
+ **查询编辑器列表**：列出您编写的查询。
+ **表达式**：使用表达式生成器创建警报表达式。有关表达式的更多信息，请参阅[编写表达式查询](v9-panels-query-xform-expressions.md)。
## 添加查询
查询返回数据，供 Grafana 在控制面板面板中可视化。创建面板时，Grafana 会自动选择默认数据来源。
**添加查询**
1. 编辑要向其中添加查询的面板。
1. 选择 **Query**（查询）选项卡。
1. 选择**数据来源**下拉菜单并选择一个数据来源。
1. 选择**查询选项**以配置所需的最大数据点数。有关查询选项的更多信息，请参阅 [查询选项](#v9-panels-query-xform-options)。
1. 使用查询编辑器编写查询。
1. 选择**应用**。
Grafana 查询数据来源并将数据可视化。
## 管理查询
Grafana 在可折叠的查询行中整理查询。每个查询行都包含一个查询编辑器，并以字母（A、B、C 等）进行标识。
要管理查询，您可以复制查询、隐藏查询、产出查询、重新排序查询以及切换查询编辑器的帮助。
## 查询选项
选择数据来源选择器旁边的**查询选项**，查看所选数据来源的设置。您在此处所做的更改仅影响在此面板中进行的查询。
Grafana 设置了以深灰色文本显示的默认值。更改以白色文本显示。要将字段恢复为默认设置，请从该字段中删除白色文本。
面板数据来源查询选项包括：
+ **最大数据点数**：如果数据来源支持该选项，则为返回的每个序列设置最大数据点数。如果查询返回的数据点数超过最大数据点设置，则数据来源将按 average、max 其他函数将其聚合在一起，来减少返回的数据点数。
您可以限制点数以提高查询性能或平滑可视化线条。默认值是图形的宽度（或像素数），因为只有图形面板有足够的空间显示尽可能多的数据点，才能实现可视化。
在流处理数据中，Grafana 对滚动缓冲使用最大数据点值。流处理是连续的数据流，而缓冲将数据流划分为多个块。例如，Loki 在实时跟踪模式下传输数据。
+ **最小间隔**：为自动计算的间隔设置最小限制，通常是最小抓取间隔。如果每 15 秒保存一次数据点，低于此间隔不会对您有什么好处。您也可以将其设置为比抓取间隔更高的最小值，以检索更粗粒度且运行良好的查询。
+ **间隔**：按时间对数据点进行聚合或分组时可以使用的时间范围。
Grafana 会自动计算适当的间隔，该间隔可用作模板化查询中的变量。变量以秒（`$__interval`）或毫秒（`$__interval_ms`）为单位。
间隔通常用于 sum 或 average 等聚合函数。例如，这是一个使用间隔变量的 Prometheus 查询：`rate(http_requests_total[$__interval])`。
此自动间隔是根据图形的宽度计算的。当用户缩小可视化时，间隔会增大，从而产生更粗粒度的聚合。同样，如果用户放大，间隔会减小，从而产生更细粒度的聚合。
有关更多信息，请参阅 [全局变量](v9-dash-variable-add.md#v9-dash-variable-add-global)。
+ **相对时间**：覆盖各个面板的相对时间范围，使其与控制面板右上角控制面板时间选择器中所选择的时间不同。您可以使用此函数在同一控制面板上显示不同时间段或日期的指标。
**注意**
当控制面板的时间范围为绝对值时，面板时间覆盖不起作用。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v9-panels-query-xform.html)
+ **时移**：通过相对于时间选取器移动面板的开始和结束时间，来覆盖各个面板的时间范围。例如，您可以将面板的时间范围移至比控制面板时间选择器早 2 小时。
**注意**
当控制面板的时间范围为绝对值时，面板时间覆盖不起作用。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v9-panels-query-xform.html)
+ **缓存超时**：*（仅在数据来源中可用时才可见）*如果您的时间序列存储具有查询缓存，则覆盖默认缓存超时。将此值指定为数值（秒）。
# 编写表达式查询
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
服务器端表达式使您能够用数学和其他运算查询返回的数据。表达式会创建新数据，但不操作数据来源返回的数据。
## 关于表达式
服务器端表达式使您能够用数学和其他运算查询返回的数据。表达式会创建新数据，但不操作数据来源返回的数据，除了一些小的数据重组，使数据成为表达式可接受的输入。
**使用表达式**
表达式主要由 [Grafana Alerting](v9-alerts.md) 使用。处理在服务器端完成，因此表达式可以在没有浏览器会话的情况下运行。但是，表达式也可以用于后端数据来源和可视化。
**注意**
表达式不适用于旧版控制面板警报。
表达式旨在通过合并来自不同数据来源的查询或提供数据来源中不可用的运算来扩充数据来源。
**注意**
在可能的情况下，应在数据来源内部进行数据处理。将数据从存储复制到 Grafana 服务器进行处理效率低下，因此表达式主要针对轻量级数据处理。
表达式适用于返回时间序列或数字数据的数据来源查询。还可以处理[多维数据](getting-started-grafanaui.md#time-series-dimensions)。例如，返回多个序列的查询，其中每个序列都由标签或标记标识。
单个表达式将一个或多个查询或其他表达式作为输入，并将数据添加到结果中。每个单独的表达式或查询都由一个变量表示，该变量是一个命名标识符，称为 RefID（例如，默认字母 `A` 或 `B`）。
要在另一个表达式中引用单个表达式或数据来源查询的输出，此标识符将用作变量。
**表达式类型**
表达式可以处理两种类型的数据。
+ 时间序列的集合。
+ 数字的集合，其中每个数字都是一个项。
每个集合均从单个数据来源查询或表达式返回，并由 ReFID 表示。每个集合都是一个集，而集中的每一项都由其维度唯一标识，这些维度以[标签](getting-started-grafanaui.md#labels)或键值对形式存储。
**数据来源查询**
服务器端表达式仅支持对后端数据来源的查询。通常假设数据是有标签的时间序列数据。将来，我们打算添加查询返回类型（数字或时间序列）数据的断言，以便表达式可以更好地处理错误。
与表达式一起使用时，数据来源查询由表达式引擎运行。在此过程中，将数据重组为一个时间序列或每个数据帧一个数字。例如，如果使用的数据来源在表视图中的一个帧上返回多个序列，那么在使用表达式运行时，您可能会发现其看起来有所不同。
目前，在使用数据帧时，唯一支持的非时间序列格式（数字）是表响应，返回的是无时间的数据帧、字符串列和一个数字列：
| Loc | 主机 | Avg\$1CPU |
| --- | --- | --- |
| MIA | A | 1 |
| NYC | B | 2 |
上面的示例将生成一个适用于表达式的数字。字符串列变成标签，数字列变成相应的值。例如 `{"Loc": "MIA", "Host": "A"}`，值为 1。
**操作**
您可以在表达式中使用以下运算：math、reduce 和 resample。
**数学**
Math 适用于时间序列或数字数据的自由格式数学公式。数学运算将数字和时间序列作为输入，并将其转换为不同的数字和时间序列。
在引用其他查询或表达式中的数据时，RefID 会以美元符号作为前缀，例如 `$A`。如果变量的名称中包含空格，则可以使用大括号语法，例如 `${my variable}`。
数字常量可以是十进制（`2.24`）、八进制（带前导 0 `072`）或十六进制（带前导 0x `0x2A`）。还支持指数和符号（例如 `-0.8e-2`）。
**运算符**
支持算术运算符（`+`、二元和一元 `-`、`*`、`/`、`%`、指数 `**`）、关系运算符（`<`、`>`、`==`、`!=`、`>=`、`<=`）和逻辑运算符（`&&`、`||` 和一元 `!`）。
运算对数据的行为方式取决于其是数字数据还是时间序列数据。
对于二元运算（例如 `$A + $B` 或 `$A || $B`），运算符根据数据类型按以下方式应用：
+ 如果 `$A` 和 `$B` 都是数字，则对这两个数字执行运算。
+ 如果一个变量是数字，而另一个变量是时间序列，则执行时间序列中每个点的值与数字之间的运算。
+ 如果 `$A` 和 `$B` 都是时间序列数据，则对 `$A` 和 `$B` 中存在的每个时间戳执行两个序列中每个值之间的运算。可使用 `Resample` 运算排列时间戳。
摘要：
+ 数字 OP 数字 = 数字
+ 数字 OP 序列 = 序列
+ 序列 OP 序列 = 序列
由于表达式处理由单个变量表示的多个序列或数字，因此二进制运算还会在两个变量之间执行联合（连接）。这是根据与每个序列或数字关联的标识标签完成的。
因此，如果 `$A` 中的数字带有 `{host=web01}` 等标签，而 `$B` 中的另一个数字具有相同的标签，则在每个变量中的这两个项目之间执行运算，结果将共享相同的标签。此联合的行为规则如下：
+ 无标签的项将连接到任何项。
+ 如果 `$A` 和 `$B` 都只包含一个项（一个序列或一个数字），则二者将会连接。
+ 如果标签是具体的数学运算，则会连接。
+ 如果标签是另一个标签的子集，例如 `$A` 中的一个项标记为 `{host=A,dc=MIA}`，而 `$B` 中的一个项标记为 `{host=A}`，则二者将会连接。
+ 如果在 `$A` 等变量中，每个项都有不同的标签键，则连接行为未定义。
关系运算符和逻辑运算符返回 0 表示 false，返回 1 表示 true。
**数学函数**
虽然大多数函数存在于自己的表达式运算中，但数学运算确实有一些类似于数学运算符或符号的函数。当函数可以取数字或序列时，将返回与参数相同的类型。如果是序列，则对序列中每个点的值执行运算。
*abs*
abs 返回其参数的绝对值，可以是数字或序列。例如，`abs(-1)` 或 `abs($A)`。
*is\$1inf*
is\$1inf 取一个数字或序列，`Inf` 值（负值或正值）返回 `1`，其他值返回 `0`。例如 `is_inf($A)`。
**注意**
例如，如果需要特别检查负无穷大，可以做一个比较，比如 `$A == infn()`。
*is\$1nan*
is\$1nan 取一个数字或序列，`NaN` 值返回 `1`，其他值返回 `0`。例如 `is_nan($A)`。此函数之所以存在，是因为 `NaN` 不等于 `NaN`。
*is\$1null*
is\$1null 取一个数字或序列，`null` 值返回 `1`，其他值返回 `0`。例如 `is_null($A)`。
*is\$1number*
is\$1number 取一个数字或序列，所有实数值返回 `1`，其他值返回 `0`（即 `null`、`Inf+`、`Inf-` 和 `NaN`）。例如 `is_number($A)`。
*log*
log 返回其参数的自然对数，可以是数字或序列。如果值小于 0，则返回 `NaN`。例如，`log(-1)` 或 `log($A)`。
*inf、infn、nan 和 null*
inf、infn、nan 和 null 函数都返回一个名称值。主要用于测试。示例：`null()`。
*round*
Round 返回一个四舍五入的整数值。例如，`round(3.123)` 或 `round($A)`。
*ceil*
Ceil 将数字向上舍入到最接近的整数值。例如，`ceil(3.123)` 将返回 `4`。
*floor*
Floor 将数字向下舍入到最接近的整数值。例如，`floor(3.123` 将返回 `3`。
**Reduce**
Reduce 取查询或表达式返回的一个或多个时间序列，将每个序列转换为一个数字。时间序列的标签作为标签保留在每个输出的归约数上。
*字段：*
+ **函数**：要使用的归约函数
+ **输入**：要重采样的变量（RefID（如 `A`））
+ **模式**：当序列包含非数值（null、NaN、\$1-Inf）时，允许控制归约函数的行为
**归约函数**
*计数*
Count 返回每个序列中的点数。
*平均值*
Mean 返回每个序列中所有值的总和除以该序列中的点数。在 `strict` 模式下，如果序列中的任何值为 null 或 nan，或者序列为空，则返回 NaN。
*Min 和 Max*
Min 和 Max 分别返回序列中的最小值或最大值。在 `strict` 模式下，如果序列中的任何值为 null 或 nan，或者序列为空，则返回 NaN。
*总计*
Sum 返回序列中所有值的总和。如果序列长度为零，则总和为 0。在 `strict` 模式下，如果序列中的任何值为 NaN 或 Null，则返回 NaN。
*Last*
Last 返回序列中的最后一个数字。如果该序列没有值，则返回 NaN。
**归约模式**
*Strict*
在 Strict 模式下，按原样处理输入序列。如果序列中的任何值为非数字（null、NaN 或 \$1-Inf），则返回 NaN。
*Drop Non-Numeric*
在此模式下，在运行归约函数之前，将筛选掉输入序列中的所有非数字值（null、NaN 或 \$1-Inf）。
*Replace Non-Numeric*
在此模式下，所有非数字值都将替换为预定义值。
**Resample**
Resample 会更改每个时间序列中的时间戳，使其具有一致的时间间隔。主要用例是，您可以对不共享相同时间戳的时间序列进行重采样，以便在其之间执行数学运算。这可以通过对两个序列中的每一个进行重采样，然后在引用重采样变量的数学运算中来完成。
*字段：*
+ **输入**：要重采样的时间序列数据变量（refID（如 `A`））
+ **重采样至**：重采样的时间持续，例如，`10s.` 单位 `s` 表示秒，`m` 表示分钟，`h` 表示小时，`d` 表示天，`w` 表示周，`y` 表示年。
+ **降采样**：当每个窗口样本有多个数据点时使用的归约函数。有关行为详细信息，请参阅归约运算。
+ **升采样**：用于填充无数据点窗口样本的方法。
+ **pad** 填充上一个已知值
+ **backfill** 回填下一个已知值
+ **fillna** 用来填充空白的样本窗口 NaNs
## 编写表达式
如果您的数据来源支持表达式，Grafana 会显示**表达式**按钮，并在查询编辑器列表中显示任何现有表达式。
**编写表达式**
1. 打开面板。
1. 在查询下方，选择**表达式**。
1. 在**运算**字段中，选择要编写的表达式类型。
1. 编写表达式。
1. 选择**应用**。
## 特殊情况
当任何查询的数据来源未返回序列或数字时，表达式引擎将返回 `NoData`。例如，如果请求包含两个由表达式合并的数据来源查询，而 `NoData` 由至少一个数据来源查询返回，则整个查询的返回结果为 `NoData`。有关 Grafana Alerting 如何处理 `NoData` 结果的更多信息，请参阅 [处理无数据或错误的情况](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error)。
# 与其他面板共享查询结果
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
通过 Grafana，您可以将一个面板中的查询结果用于控制面板中的任何其他面板。跨面板共享查询结果可以减少对数据来源的查询次数，从而提高控制面板的性能。
控制面板数据来源允许您在控制面板中选择一个面板，其中包含要共享结果的查询。Grafana 没有为每个面板发送单独的查询，而是发送一个查询，而其他面板则使用查询结果来构造可视化。
例如，当您有多个面板可视化相同的数据时，该策略可以大大减少查询的次数。
**共享查询结果**
1. [创建控制面板](v9-dash-creating.md)。
1. 将标题更改为 `Source panel`。使用此面板作为其他面板的来源。
1. 定义要共享的一个或多个查询。
如果您没有可用的数据源，请使用**TestData**数据源，它会返回一个可用于测试的随机时间序列。
1. 添加第二个面板，然后在查询编辑器中选择**控制面板**数据来源。
1. 在**使用来自面板列表的结果**中，选择您创建的第一个面板。
现在，在来源面板中定义的所有查询都可用于新面板。在来源面板中进行的查询可与多个面板共享。
您可以单击任何查询以转到定义查询的面板。
# 转换数据
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
转换是一种强大方法，可在系统应用可视化之前处理查询返回的数据。通过转换，您可以：
+ 重命名字段
+ 连接时间序列数据
+ 跨查询执行数学运算
+ 将一个转换的输出用作另一个转换的输入
对于依赖同一数据集中多个视图的用户来说，转换是一种创建和维护大量控制面板的有效方法。
您也可以将一个转换的输出用作另一个转换的输入，从而提高性能。
**注意**
有时，系统无法绘制转换后的数据。发生这种情况时，单击可视化上方的**表视图**切换按钮，以切换到数据的表视图。这有助于您了解转换的最终结果。
## 转换类型
Grafana 提供了多种转换数据的方式。下面是转换函数的完整列表。
## 转换顺序
当存在多个转换时，Grafana 会按其列出的顺序来应用。每次转换都会创建一个新的结果集，然后传递给处理管道中的下一个转换。
Grafana 应用转换的顺序会直接影响结果。例如，如果使用 Reduce 转换将一列的所有结果压缩为单个值，则只能对该值应用转换。
## 向数据添加转换函数
以下步骤将指导您向数据添加转换。
**向面板添加转换**
1. 导航到要在其中添加一个或多个转换的面板。
1. 选择面板标题，然后单击**编辑**。
1. 选择 **Transform (转换)** 选项卡。
1. 选择转换。此时会显示一个转换行，您可以在其中配置转换选项。
1. 要应用另一个转换，请选择**添加转换**。这次转换对上一次转换返回的结果执行操作。
## 调试转换
要查看转换的输入和输出结果集，请选择转换行右侧的调试图标。
输入和输出结果集有助于调试转换。
## 删除转换
建议删除不需要的转换。删除转换时，即从可视化中删除数据。
先决条件：
识别所有依赖转换的控制面板，并通知受影响的控制面板用户。
**删除转换**
1. 打开面板进行编辑。
1. 选择 **Transform (转换)** 选项卡。
1. 选择要删除的转换旁边的垃圾桶图标。
## 转换函数
您可以对数据执行以下转换。
**从计算添加字段**
使用此转换可以添加一个根据其他两个字段计算得出的新字段。每次转换都允许您添加一个新字段。
+ **模式**：选择一种模式：
+ **减少行**：对选定字段的每一行分别应用所选计算。
+ **二元选项**：对两个选定字段的单行中的值应用基本的数学运算（求和、乘法等）。
+ **字段名称**：选择要在新字段的计算中使用的字段名称。
+ **计算**：如果您选择**减少行**模式，则会出现**计算**字段。单击字段以查看可用于创建新字段的计算选项列表。有关可用计算的信息，请参阅[计算类型](v9-panels-calculation-types.md)。
+ **运算**：如果您选择**二元选项**模式，则出现**运算**字段。通过这些字段，您可以对来自两个选定字段的单行中的值进行基本数学运算。也可以使用数值进行二元运算。
+ **别名**：（可选）输入新字段的名称。如果将此项保留为空，则将对该字段命名以与计算匹配。
+ **替换所有字段**：（可选）如果您想在可视化中隐藏所有其他字段并仅显示经过计算字段，请使用此选项。
**连接字段**
这种转换将所有帧中的所有字段合并为一个结果。考虑以下两个查询。
查询 A：
| 临时文件 | 正常运行时间 |
| --- | --- |
| 15.4 | 1230233 |
查询 B：
| AQI | 错误 |
| --- | --- |
| 3.2 | 5 |
连接字段后，数据帧为：
| 临时文件 | 正常运行时间 | AQI | 错误 |
| --- | --- | --- | --- |
| 15.4 | 1230233 | 3.2 | 5 |
**来自查询结果的配置**
通过这种转换，您可以选择一个查询，从中提取**最小值**、**最大值**、**单位**和**阈值**等标准选项，并将其应用于其他查询结果。这实现了动态查询驱动的可视化配置。
如果您想为配置查询结果中的每一行提取唯一配置，请尝试行到字段的转换。
**Options**
+ **配置查询**：选择返回要用作配置的数据的查询。
+ **应用于**：选择要对哪些字段或序列应用配置。
+ **应用于选项**：通常是字段类型或字段名称正则表达式，具体取决于您在**应用于**中选择的选项。
**转换字段类型**
此转换会更改指定字段的字段类型。
+ **字段**：从可用字段中选择
+ **as** — 选择 FieldType 要转换为
+ **数字**：尝试将值变为数字
+ **字符串**：将值设为字符串
+ **时间**：尝试将值解析为时间
+ 将显示一个选项，用于通过诸 DateFormat 如 yyyy-mm-dd或 DD MM YYYY hh: mm: ss 之类的字符串将 a 指定为输入
+ **布尔值**：将值变为布尔值
例如，可通过选择时间字段“Time”和日期格式“YYYY”来修改以下查询。
| 时间 | 标记 | 值 |
| --- | --- | --- |
| 7/1/2017 | 高于 | 25 |
| 8/2/2018 | 低于 | 22 |
| 9/2/2019 | 低于 | 29 |
| 10/4/2020 | 高于 | 22 |
结果：
| 时间 | 标记 | 值 |
| --- | --- | --- |
| 1/1/2017 | 高于 | 25 |
| 1/1/2018 | 低于 | 22 |
| 2019 年 1 月 1 日 | 低于 | 29 |
| 1/1/2020 | 高于 | 22 |
**按名称筛选数据**
使用此转换可以移除部分查询结果。
Grafana 显示**标识符**字段，后面是您的查询返回的字段。
您可以通过以下两种方式之一应用筛选器：
+ 输入正则表达式。
+ 选择一个字段以切换对该字段的筛选。筛选后的字段显示为深灰色文本，未筛选的字段包含白色文本。
**按查询筛选数据**
如果您想要隐藏一个或多个查询，请在包含多个查询的面板中使用此转换。
Grafana 以深灰色文本显示查询标识字母。单击查询标识符以切换筛选。如果查询字母是白色的，则会显示结果。如果查询字母是深色的，则会隐藏结果。
**注意**
这种转换不适用于 Graphite，因为此数据来源不支持将返回的数据与查询关联。
**按值筛选数据**
此转换允许您直接在 Grafana 中筛选数据，并从查询结果中删除一些数据点。您可以选择包含或排除与您定义的一个或多个条件相匹配的数据。这些条件将应用于选定的字段。
如果您的数据来源未按值进行本机筛选，则此转换非常有用。如果您使用的是共享查询，也可以使用它来缩小要显示的值的范围。
所有字段的可用条件如下：
+ **正则表达式**：匹配正则表达式
+ **为 Null 值**：如果值为 null 值，则匹配
+ **为非 Null 值**：如果值为非 null 值，则匹配
+ **等于**：如果值等于指定值，则匹配
+ **不同**：如果值与指定值不同，则匹配
数值字段的可用条件如下：
+ **大于**：如果值大于指定值，则匹配
+ **小于**：如果值小于指定值，则匹配
+ **大于或等于**：如果值大于或等于指定值，则匹配
+ **小于或等于**：如果值小于或等于指定值，则匹配
+ **范围**：匹配指定的最小值和最大值之间的范围，包括最小值和最大值
考虑以下数据集：
| 时间 | 温度 | 海拔 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:23 | 32 | 101 |
| 7/7/2020 上午 11:34:22 | 28 | 125 |
| 7/7/2020 上午 11:34:21 | 26 | 110 |
| 7/7/2020 上午 11:34:20 | 23 | 98 |
| 7/7/2020 上午 10:32:24 | 31 | 95 |
| 7/7/2020 上午 10:31:22 | 20 | 85 |
| 7/7/2020 上午 9:30:57 | 19 | 101 |
如果**包括**温度低于 30°C 的数据点，配置将如下所示：
+ **筛选条件类型**：`Include`
+ **条件**：`Temperature` 匹配 `Lower Than 30` 的行
您将得到以下结果，其中仅包括低于 30°C 的温度：
| 时间 | 温度 | 海拔 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:22 | 28 | 125 |
| 7/7/2020 上午 11:34:21 | 26 | 110 |
| 7/7/2020 上午 11:34:20 | 23 | 98 |
| 7/7/2020 上午 10:31:22 | 20 | 85 |
| 7/7/2020 上午 9:30:57 | 19 | 101 |
您可以向筛选器添加多个条件。例如，您可能希望仅在海拔大于 100 时才包含数据。为此，请将该条件添加到以下配置：
+ 筛选条件类型：符合 `Match All` 条件的 `Include` 行
+ 条件 1：`Temperature` 匹配 `Lower` 而非 `30` 的行
+ 条件 2：`Altitude` 匹配 `Greater` 而非 `100` 的行
当您有多个条件时，您可以选择是希望将操作（包括/排除）应用于您添加的 **Match all** 条件的行，还是 **Match any** 条件的行。
在上面的示例中，我们之所以选择 **Match all**，是因为我们希望包括温度低于 30 且海拔高于 100 的行。如果我们想包括温度低于 30 或海拔高于 100 的行，则可以选择 **Match any**。这包括原始数据中的第一行，该行的温度为 32°C（与第一个条件不匹配），但海拔高度为 101（与第二个条件匹配），因此包括在内。
无效或配置不完整的条件将被忽略。
**Group by** (分组依据)
此转换按指定的字段（列）值对数据进行分组，并处理每个组的计算。单击以查看计算选项的列表。
以下是原始数据的示例：
| 时间 | Server ID | CPU 温度 | 服务器状态 |
| --- | --- | --- | --- |
| 7/7/2020 上午 11:34:20 | server 1 | 80 | 关闭 |
| 7/7/2020 上午 11:34:20 | server 3 | 62 | OK |
| 7/7/2020 上午 10:32:20 | server 2 | 90 | 过载 |
| 7/7/2020 上午 10:31:22 | server 3 | 55 | 正常 |
| 7/7/2020 上午 9:30:57 | server 3 | 62 | Rebooting |
| 7/7/2020 上午 9:30:05 | server 2 | 88 | OK |
| 7/7/2020 上午 9:28:06 | server 1 | 80 | OK |
| 7/7/2020 上午 9:25:05 | server 2 | 88 | OK |
| 7/7/2020 上午 9:23:07 | server 1 | 86 | OK |
该转换分两个步骤。首先，指定一个或多个字段作为数据分组依据。这会将这些字段的所有相同值分组到一起，就像对它们进行排序一样。例如，如果我们按服务器 ID 字段分组，则其将按以下方式对数据分组：
| 时间 | Server ID | CPU 温度 | 服务器状态 |
| --- | --- | --- | --- |
| 7/7/2020 上午 11:34:20 | server 1 | 80 | 关闭 |
| 7/7/2020 上午 9:28:06 | server 1 | 80 | OK |
| 7/7/2020 上午 9:23:07 | server 1 | 86 | OK |
| 7/7/2020 上午 10:32:20 | server 2 | 90 | 过载 |
| 7/7/2020 上午 9:30:05 | server 2 | 88 | OK |
| 7/7/2020 上午 9:25:05 | server 2 | 88 | OK |
| 7/7/2020 上午 11:34:20 | server 3 | 62 | OK |
| 7/7/2020 上午 10:31:22 | server 3 | 55 | 正常 |
| 7/7/2020 上午 9:30:57 | server 3 | 62 | Rebooting |
包含相同服务器 ID 值的所有行将分组在一起。
选择作为数据分组依据的字段后，可以在其他字段上添加各种计算，计算将应用于每组行。例如，您可能想要计算每台服务器的平均 CPU 温度。因此，我们可以将应用于 CPU 温度字段的*平均值*计算相加，得到以下结果：
| Server ID | CPU 温度（平均值） |
| --- | --- |
| server 1 | 82 |
| server 2 | 88.6 |
| server 3 | 59.6 |
我们可以添加多个计算。例如：
+ 对于“时间”字段，我们可以计算*上个*值，以了解每台服务器上一个数据点的接收时间
+ 对于“服务器状态”字段，我们可以计算*上个*值，以了解每台服务器上一次的状态值。
+ 对于“温度”字段，我们可以计算*上个*值，以了解每台服务器的最新监控温度。
然后我们会得到：
| Server ID | CPU 温度（平均值） | CPU 温度（上个值） | 时间（上个值） | 服务器状态（上个值） |
| --- | --- | --- | --- | --- |
| server 1 | 82 | 80 | 7/7/2020 上午 11:34:20 | 关闭 |
| server 2 | 88.6 | 90 | 7/7/2020 上午 10:32:20 | 过载 |
| server 3 | 59.6 | 62 | 7/7/2020 上午 11:34:20 | OK |
此转换使您能够从时间序列中提取关键信息，并以便捷的方式显示这些信息。
**按字段连接**
使用此转换将多个结果连接到一个表中。这对于将多个时间序列结果转换为具有共享时间字段的单个宽表特别有用。
*内连接*
内连接合并多个表中的数据，其中所有表共享选定字段中的相同值。这种类型的连接会排除每个结果中值不匹配的数据。
使用此转换将多个查询结果（通过连接字段或首次列组合）合并为一个结果，并删除无法成功连接的行。
在以下示例中，两个查询返回表数据。在应用内连接转换之前，将其可视化为两个独立的表。
查询 A：
| 时间 | 任务 | 正常运行时间 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 节点 | 25260122 |
| 7/7/2020 上午 11:24:20 | postgre | 123001233 |
| 7/7/2020 上午 11:14:20 | postgre | 345001233 |
查询 B：
| 时间 | 服务器 | 错误 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | server 1 | 15 |
| 7/7/2020 上午 11:24:20 | server 2 | 5 |
| 7/7/2020 上午 11:04:20 | server 3 | 10 |
应用内连接转换后的结果如下所示：
| 时间 | 任务 | 正常运行时间 | 服务器 | 错误 |
| --- | --- | --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 节点 | 25260122 | server 1 | 15 |
| 7/7/2020 上午 11:24:20 | postgre | 123001233 | server 2 | 5 |
*外连接*
外连接包括来自内连接的所有数据，以及在每个输入中值不匹配的行。内连接在时间字段上连接查询 A 和查询 B，而外连接包括所有在时间字段上不匹配的行。
在以下示例中，两个查询返回表数据。在应用外连接转换之前，将其可视化为两个表。
查询 A：
| 时间 | 任务 | 正常运行时间 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 节点 | 25260122 |
| 7/7/2020 上午 11:24:20 | postgre | 123001233 |
| 7/7/2020 上午 11:14:20 | postgre | 345001233 |
查询 B：
| 时间 | 服务器 | 错误 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | server 1 | 15 |
| 7/7/2020 上午 11:24:20 | server 2 | 5 |
| 7/7/2020 上午 11:04:20 | server 3 | 10 |
应用外连接转换后的结果如下所示：
| 时间 | 任务 | 正常运行时间 | 服务器 | 错误 |
| --- | --- | --- | --- | --- |
| 7/7/2020 上午 11:04:20 | | | server 3 | 10 |
| 7/7/2020 上午 11:14:20 | postgre | 345001233 | | |
| 7/7/2020 上午 11:34:20 | 节点 | 25260122 | server 1 | 15 |
| 7/7/2020 上午 11:24:20 | postgre | 123001233 | server 2 | 5 |
**标签到字段**
此转换将包含标签或标记的时间序列结果更改为表，其中每个标签键和值都包含在表结果中。标签可以显示为列或行值。
给定两个时间序列的查询结果：
+ 序列 1：标签 Server=Server A，Datacenter=EU
+ 序列 2：标签 Server=Server B，Datacenter=EU
在**列**模式下，结果如下所示：
| 时间 | 服务器 | Datacenter | 值 |
| --- | --- | --- | --- |
| 7/7/2020 上午 11:34:20 | Server A | EU | 1 |
| 7/7/2020 上午 11:34:20 | Server B | EU | 2 |
在“行”模式下，结果对每个序列都创建一个表，并显示每个标签值，如下所示：
| label | 值 |
| --- | --- |
| 服务器 | Server A |
| Datacenter | EU |
| label | 值 |
| --- | --- |
| 服务器 | Server B |
| Datacenter | EU |
*值字段名称*
如果您选择 Server 作为**值字段名称**，则 Server 标签的每个值都将获得一个字段。
| 时间 | Datacenter | Server A | Server B |
| --- | --- | --- | --- |
| 7/7/2020 上午 11:34:20 | EU | 1 | 2 |
*合并行为*
标签到字段转换器在内部是两个独立的转换。第一个作用于单个序列，并将标签提取到字段。第二个是合并转换，将所有结果合并到一个表。合并转换会尝试连接所有匹配字段。此合并步骤是必需的，无法关闭。
**注意**
*合并*转换可以单独使用，详细说明如下。
为了说明这一点，这里有一个示例，其中有两个查询返回没有重叠标签的时间序列。
+ 序列 1：标签 Server=ServerA
+ 序列 2：标签 Datacenter=EU
首先会生成这两个表：
| 时间 | 服务器 | 值 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | ServerA | 10 |
| 时间 | Datacenter | 值 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | EU | 20 |
合并后：
| 时间 | 服务器 | 值 | Datacenter |
| --- | --- | --- | --- |
| 7/7/2020 上午 11:34:20 | ServerA | 10 | |
| 7/7/2020 上午 11:34:20 | | 20 | EU |
**合并**
使用此转换将来自多个查询的结果合并为一个结果。这在使用表面板可视化时很有用。可以合并的值将合并到同一行中。如果共享字段包含相同的数据，则可以合并值。
在下面的示例中，我们有两个返回表数据的查询。在应用转换之前，将其可视化为两个独立的表。
查询 A：
| 时间 | 任务 | 正常运行时间 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 节点 | 25260122 |
| 7/7/2020 上午 11:24:20 | postgre | 123001233 |
查询 B：
| 时间 | 任务 | 错误 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 节点 | 15 |
| 7/7/2020 上午 11:24:20 | postgre | 5 |
以下是应用合并转换后的结果：
| 时间 | 任务 | 错误 | 正常运行时间 |
| --- | --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 节点 | 15 | 25260122 |
| 7/7/2020 上午 11:24:20 | postgre | 5 | 123001233 |
**整理字段**
使用此转换可以重命名、重新排序或隐藏查询返回的字段。
**注意**
此转换仅适用于具有单个查询的面板。如果您的面板有多个查询，则必须应用外连接转换或删除多余的查询。
Grafana 会显示查询返回的字段列表。你可以：
+ 将光标悬停在字段上以更改字段顺序。光标变成手形，然后您就可以将该字段拖到新的位置。
+ 通过单击字段名称旁边的眼睛图标隐藏或显示字段。
+ 通过在重命名框中键入新名称来重命名字段。
**按值分区**
在绘制多个序列时，这种转换可避免使用不同 `WHERE` 子句对同一数据来源进行多次查询。考虑一个包含以下数据的指标 SQL 表：
| 时间 | Region | 值 |
| --- | --- | --- |
| 2022 年 10 月 20 日下午 12:00:00 | 美国 | 1520 |
| 2022 年 10 月 20 日下午 12:00:00 | EU | 2936 |
| 2022 年 10 月 20 日凌晨 1:00:00 | 美国 | 1327 |
| 2022 年 10 月 20 日凌晨 1:00:00 | EU | 912 |
在 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'
```
| 时间 | Region | 值 |
| --- | --- | --- |
| 2022 年 10 月 20 日下午 12:00:00 | 美国 | 1520 |
| 2022 年 10 月 20 日凌晨 1:00:00 | 美国 | 1327 |
| 时间 | Region | 值 |
| --- | --- | --- |
| 2022 年 10 月 20 日下午 12:00:00 | EU | 2936 |
| 2022 年 10 月 20 日凌晨 1:00:00 | EU | 912 |
**Reduce**
*Reduce* 转换将计算应用于帧中的每个字段，并返回单个值。应用此转换时，将删除时间字段。
考虑以下输入：
查询 A：
| 时间 | 临时文件 | 正常运行时间 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 12.3 | 256122 |
| 7/7/2020 上午 11:24:20 | 15.4 | 1230233 |
查询 B：
| 时间 | AQI | 错误 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 6.5 | 15 |
| 7/7/2020 上午 11:24:20 | 3.2 | 5 |
reduce 转换器具有两种模式：
+ **序列到行**：为每个字段创建一行，为每个计算创建一列。
+ **减少字段**：保留现有的框架结构，但将每个字段折叠为单个值。
例如，如果将**第一个**和**最后一个**计算与**序列到行**转换一起使用，则结果为：
| 字段 | 第一个 | Last |
| --- | --- | --- |
| 临时文件 | 12.3 | 15.4 |
| 正常运行时间 | 256122 | 1230233 |
| AQI | 6.5 | 3.2 |
| 错误 | 15 | 5 |
最后一次计算的 Reduce 字段会产生两个帧，每个帧都有一行：
查询 A：
| 临时文件 | 正常运行时间 |
| --- | --- |
| 15.4 | 1230233 |
查询 B：
| AQI | 错误 |
| --- | --- |
| 3.2 | 5 |
**按正则表达式重命名**
使用此转换，可以使用正则表达式和替换模式来重命名部分查询结果。
您可以指定一个正则表达式，该正则表达式只应用于匹配，同时指定一个支持反向引用的替换模式。例如，假设您在可视化每台主机的 CPU 使用情况，并希望删除域名。您可以将正则表达式设置为 `([^\.]+)\..+`，并将替换模式设置为 `$1`，`web-01.example.com` 将变为 `web-01`。
**行到字段**
行到字段的转换将行转换为单独的字段。这非常有用，因为可以单独设置字段的样式和配置。还可以使用附加字段作为动态字段配置的来源，或将其映射到字段标签。然后，可以使用其他标签为生成的字段定义更好的显示名称。
此转换包括一个字段表，该表列出了配置查询返回的数据中的所有字段。通过此表，您可以控制应将哪些字段映射到每个配置属性（\$1用作\$1\$1选项）。如果返回的数据中有多行，您还可以选择要选择的值。
这种转换需要：
+ 一个字段用作字段名称的来源。
默认情况下，转换使用第一个字符串字段作为来源。您可以在要使用的字段的**用作**列中选择**字段名称**，来覆盖此默认设置。
+ 一个字段用作值的来源。
默认情况下，转换使用第一个数字字段作为来源。但您可以在要使用的字段的**用作**列中选择**字段值**，来覆盖此默认设置。
在以下位置可视化数据时非常有用：
+ 计量表
+ Stat
+ 饼图
*将多余字段映射到标签*
如果字段未映射到配置属性，Grafana 会自动将其用作输出字段上标签的来源：
示例：
| Name | DataCenter | 值 |
| --- | --- | --- |
| ServerA | 美国 | 100 |
| ServerB | EU | 200 |
输出：
| ServerA（标签： DataCenter: 美国） | ServerB（标签： DataCenter：欧盟） |
| --- | --- |
| 10 | 20 |
现在可以在字段显示名称中使用额外的标签，提供更完整的字段名称。
如果要从一个查询中提取配置并将其应用于另一个查询，则应使用查询结果转换中的配置。
*示例*
输入：
| Name | 值 | 最大值 |
| --- | --- | --- |
| ServerA | 10 | 100 |
| ServerB | 20 | 200 |
| ServerC | 30 | 300 |
输出：
| ServerA（配置：max=100） | ServerB（配置：max=200） | ServerC（配置：max=300） |
| --- | --- | --- |
| 10 | 20 | 30 |
如您所见，来源数据中的每一行都变成一个单独的字段。现在，每个字段还设置了最大配置选项。最小值、最大值、单位和阈值等选项都是字段配置的一部分，如果这样设置，可视化将使用这些选项，而不是在面板编辑器选项窗格中手动配置的任何选项。
**准备时间序列**
当数据来源以您要使用的面板不支持的格式返回时间序列数据时，准备时间序列转换非常有用。
这种转换通过将时间序列数据从宽格式转换为长格式或反过来，来帮助您解决此问题。
选择**多帧时间序列**选项，将时间序列数据框从宽格式转换为长格式。
选择**宽时间序列**选项，将时间序列数据框从长格式转换为宽格式。
**序列到行**
使用此转换可将多个时间序列数据查询的结果合并为一个结果。这在使用表面板可视化时很有用。
此转换的结果将包含三列：时间、指标和值。添加指标列是为了方便您查看该指标来自哪个查询。通过在来源查询上定义标签来自定义此值。
在下面的示例中，有两个查询返回时间序列数据。在应用转换之前，将其可视化为两个独立的表。
查询 A：
| 时间 | 温度 |
| --- | --- |
| 7/7/2020 上午 11:34:20 | 25 |
| 7/7/2020 上午 10:31:22 | 22 |
| 7/7/2020 上午 9:30:05 | 19 |
查询 B：
| 时间 | 湿度 |
| --- | --- |
| 7/7/2020 上午 11:34:20 | 24 |
| 7/7/2020 上午 10:32:20 | 29 |
| 7/7/2020 上午 9:30:57 | 33 |
以下是将序列应用于行转换后的结果。
| 时间 | 指标 | 值 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 温度 | 25 |
| 7/7/2020 上午 11:34:20 | 湿度 | 22 |
| 7/7/2020 上午 10:32:20 | 湿度 | 29 |
| 7/7/2020 上午 10:31:22 | 温度 | 22 |
| 7/7/2020 上午 9:30:57 | 湿度 | 33 |
| 7/7/2020 上午 9:30:05 | 温度 | 19 |
**排序依据**
此转换将按配置的字段对每一帧排序，选中 `reverse` 后，值将按相反的顺序返回。
**限制**
使用此转换来限制显示的行数。
在下面的示例中，我们从数据来源获得了以下响应：
| 时间 | 指标 | 值 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 温度 | 25 |
| 7/7/2020 上午 11:34:20 | 湿度 | 22 |
| 7/7/2020 上午 10:32:20 | 湿度 | 29 |
| 7/7/2020 上午 10:31:22 | 温度 | 22 |
| 7/7/2020 上午 9:30:57 | 湿度 | 33 |
| 7/7/2020 上午 9:30:05 | 温度 | 19 |
以下是添加值为“3”的限制转换后的结果：
| 时间 | 指标 | 值 |
| --- | --- | --- |
| 7/7/2020 上午 11:34:20 | 温度 | 25 |
| 7/7/2020 上午 11:34:20 | 湿度 | 22 |
| 7/7/2020 上午 10:32:20 | 湿度 | 29 |
# 查询问题排查
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
本页提供了如何解决常见控制面板问题的信息。
**当我重新排列函数时，得到不同的结果**
函数顺序非常重要。就像数学一样，函数的放置顺序会影响结果。
**检查查询请求和响应**
最常见的问题与数据来源的查询和响应有关。似乎是 Grafana 中的错误或可视化问题，其实是数据来源查询或数据来源响应的问题。首先检查面板查询和响应。
有关更多信息，请参阅[检查请求和响应数据](v9-panels-panel-inspector.md)。
**查询速度缓慢**
查询返回多少个数据点？ 返回大量数据点的查询速度会很慢。尝试：
+ 在**查询选项**中，限制返回的**最大数据点**。
+ 在**查询选项**中，增加**最小间隔**时间。
+ 在查询中，使用 `group by` 函数。
# 配置阈值
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
本节包含有关在可视化中使用阈值的信息。您将了解阈值及其默认值、如何添加或删除阈值以及向旧版面板添加阈值。
## 关于阈值
阈值是您为指标指定的值，当达到或超过阈值时，该值会直观地反映在控制面板中。
阈值为您提供了一种根据查询结果有条件地设置可视化样式和颜色的方法。您可以将阈值应用于大多数（但不是全部）可视化。有关可视化的更多信息，请参阅[可视化面板](v9-panels.md)。
您可以使用阈值：
+ 为[时间序列可视化](v9-panels-time-series.md)中的网格线或网格区域区域着色
+ 为[时间序列可视化](v9-panels-time-series.md)中的线条着色
+ 为[统计可视化](v9-panels-stat.md)中的背景或值文本着色
+ 为[仪表可视化](v9-panels-gauge.md)中的仪表和阈值标记着色
+ 为 [Geomap 可视化](v9-panels-geomap.md)中的标记着色
+ 为[表可视化](v9-panels-table.md)中的单元格文本或背景着色
+ 在[状态时间线可视化](v9-panels-state-timeline.md)中定义区域和区域颜色
有两种类型的阈值：
+ **绝对**阈值由数字定义。例如，从 1 到 150 的刻度 80。
+ **百分比**阈值是相对于最小值或最大值定义的。例如，80%。
### 默认阈值
在支持此阈值的可视化中，Grafana 将默认阈值设置为：
+ 80 = 红色
+ 基本 = 绿色
+ 模式 = 绝对
**基本**值表示负无穷大。这种颜色通常表示良好。
## 添加或删除阈值
您可以根据需要向面板添加任意数量的阈值。Grafana 会自动将阈值从最高到最低排序。
当阈值与业务运营不再相关时，将其删除。删除阈值时，系统会从包含该阈值的所有可视化中将其删除。
1. 添加阈值：
1. 编辑要向其中添加阈值的面板。
1. 在选项侧窗格中，找到**阈值**部分，然后单击 **\$1 添加阈值**。
1. 选择阈值颜色、数字和模式。阈值模式适用于此面板上的所有阈值。
1. 对于时间序列面板，选择**显示阈值**选项。
1. 要删除阈值，请导航到包含阈值的面板，然后单击要删除的阈值旁边的垃圾桶图标。
## 向旧图形面板添加阈值
在图形面板可视化中，阈值让您可以为图形添加线条或截面，以便在图形超过阈值时更容易识别。
1. 导航到要向其添加阈值的图形面板。
1. 在**面板**选项卡上，单击**阈值**。
1. 单击**添加阈值**。
1. 填写以下字段：
+ **T1**：需要两个值才能显示阈值。
+ **lt** 或 **gt**：选择 **lt** 表示小于，或选择 **gt** 表示大于，以指示阈值适用的范围。
+ **值**：输入阈值。Grafana 沿 Y 轴在该值处绘制一条阈值线。
+ **颜色**：选择与颜色对应的条件，或定义自己的颜色。
+ **自定义**：定义填充颜色和线条颜色。
+ **critical**：填充和线条颜色为红色。
+ **warning**：填充和线条颜色为黄色。
+ **ok**：填充和线条颜色为绿色。
+ **填充**：控制是否显示阈值填充。
+ **线条**：控制是否显示阈值线条。
+ **Y 轴**：选择**左**或**右**。
1. 单击**保存**将更改保存到控制面板中。
# 配置数据链接
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
您可以使用数据链接变量或数据链接来创建面板之间的链接。
## 数据链接变量
您可以使用数据链接中的变量来查看序列字段、标签和值。有关数据链接的更多信息，请参阅 [数据链接](#v9-panels-data-links)。
要查看可用变量列表，请在数据链接 **URL** 字段中键入 **\$1**，以查看可使用的变量列表。
**注意**
这些变量在 6.4 中发生了变化，因此，如果您使用的是旧版 Grafana，请使用版本选择器为旧版本的 Grafana 选择文档。
您也可以在数据链接中使用模板变量 URLs，请参阅[添加和管理控制面板变量](v9-dash-variables.md)。
## 时间范围面板变量
您可以使用这些变量在数据链接 URL 中包含当前时间范围。
+ **\$1\$1url\$1time\$1range**：当前控制面板的时间范围（即 **?from=now-6h&to=now**）
+ **\$1\$1\$1from 和 \$1\$1\$1to**：有关更多信息，请参阅 [全局变量](v9-dash-variable-add.md#v9-dash-variable-add-global)。
## 序列变量
特定于序列的变量在 **\$1\$1series** 命名空间下可用：
+ **\$1\$1series.name**：URL 的序列名称
## 字段变量
特定于字段的变量在 **\$1\$1field** 命名空间下可用：
+ **\$1\$1field.name**：字段的名称
+ **\$1\$1field.labels.