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

# Grafana 10 中的面板和可视化
<a name="v10-panels"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

*面板*是 Grafana 中的基本可视化构建块。每个面板都有一个特定于面板中所选数据来源的查询编辑器。查询编辑器允许您构建一个查询，以返回要可视化的数据。

每个面板都有各种各样的样式和格式选项。可以拖放面板并调整其大小，以便在控制面板上重新排列。

在添加面板之前，确保已配置数据来源。

可在工作区中安装其他[插件](grafana-plugins.md)以获得其他面板类型。

有关使用特定数据来源的详细信息，请参阅 [连接到数据来源](AMG-data-sources.md)。

**Topics**
+ [面板编辑器概述](v10-panels-editor-overview.md)
+ [面板检查视图](v10-panels-panel-inspector.md)
+ [查询和转换数据](v10-panels-query-xform.md)
+ [配置面板选项](v10-panels-configure-panel-options.md)
+ [配置标准选项](v10-panels-configure-standard-options.md)
+ [配置图例](v10-panels-configure-legend.md)
+ [配置数据链接](v10-panels-configure-data-links.md)
+ [配置值映射](v10-panels-configure-value-mappings.md)
+ [配置阈值](v10-panels-configure-thresholds.md)
+ [配置字段覆盖](v10-panels-configure-overrides.md)
+ [Grafana 10 提供的可视化](v10-panels-viz.md)

# 面板编辑器概述
<a name="v10-panels-editor-overview"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

在面板编辑器中，您可以更新可视化项的所有元素，包括数据来源、查询、时间范围和显示选项。

要将面板添加到新的控制面板，请选择控制面板中间的 **\$1 添加可视化**。要将面板添加到现有控制面板，请在控制面板标题中选择**添加**，然后在下拉列表中选择**可视化**。您也可以从相同或不同的控制面板中复制和粘贴现有面板。

## 面板菜单
<a name="v10-panels-editor-menu"></a>

要访问面板编辑器，请将鼠标悬停在任何面板的右上角。选择出现的面板菜单图标，然后选择**编辑**。

面板菜单还允许访问以下操作：
+ **查看**：以全屏模式查看面板。
+ **编辑**：打开面板编辑器以编辑面板和可视化选项。
+ **共享**：以链接或库面板的形式共享面板。
+ **Explore**：在 **Explore** 中打开面板，您可以在其中专注于查询。
+ **检查**：打开**检查**抽屉，您可以在其中查看面板数据、统计、元数据、JSON 和查询。
  + **数据**：在**数据**选项卡中打开**检查**抽屉。
  + **查询**：在**查询**选项卡中打开**检查**抽屉。
  + **面板 JSON**：在 **JSON** 选项卡中打开**检查**抽屉。
+ **扩展**：访问已安装应用程序提供的其他操作，例如声明事件。只有在安装了为面板菜单提供扩展的应用程序插件时，才会显示此选项。
+ **更多**：访问其他面板操作。
  + **重复**：创建面板的副本。重复面板与原始面板分开查询数据。如果要使用相同的查询结果，可以使用第二个面板中的 `Dashboard` 数据来源。
  + **复制**：将面板复制到剪贴板。
  + **创建库面板**：创建可导入其他控制面板的面板。
  + **创建警报**：在 **Alerting** 中打开警报规则配置页面，您可以在其中根据面板查询创建 [Grafana 管理的警报](v10-alerts.md)。
  + **隐藏图例**：隐藏面板图例。
  + **获取帮助**：向 Grafana Labs 技术支持发送快照或面板数据。
+ **删除**：从控制面板上删除面板。

## 面板编辑器
<a name="v10-panels-editor-view"></a>

本节介绍了 Grafana 面板编辑器的各个区域。
+ 面板标题：标题部分列出了显示面板的控制面板和以下控件：
  + **丢弃**：丢弃自上次保存控制面板之后，对面板所做的更改。
  + **保存**：保存对面板所做的更改。
  + **应用**：应用您所做的更改，关闭面板编辑器，返回控制面板。您需要保存控制面板，以持久保留所应用的更改。
+ 可视化预览：可视化预览部分包含以下选项：
  + **表视图**：将任何可视化转换为表，以便查看数据。表视图有助于进行问题排查。此视图仅包含原始数据。不包括您可能应用于数据的转换，也不包括[表](v10-panels-table.md)可视化中可用的格式化选项。
  + **填充**：可视化预览会填充可用空间。如果更改侧窗格的宽度或底部窗格的高度，可视化效果会随之改变以填充可用空间。
  + **实际**：可视化预览的大小与控制面板上的大小完全一致。如果可用空间不足，可视化大小会缩减，同时保留纵横比。
  + **时间范围控制**：**默认**为浏览器本地时区或在更高级别选择的时区。
+ 数据部分：数据部分包含用于输入查询、转换数据和创建警报规则（如适用）的选项卡。
  + **查询选项卡**：选择您的数据来源，并在此处输入查询。有关更多信息，请参阅 [查询和转换数据](v10-panels-query-xform.md)。最初创建控制面板时，系统会提示您选择数据来源。您可以在此选项卡中更新数据来源或查询。
  + **转换选项卡**：应用数据转换。有关更多信息，请参阅 [查询和转换数据](v10-panels-query-xform.md)。
  + **警报选项卡**：编写警报规则。有关更多信息，请参阅 [Grafana 10 版本中的警报](v10-alerts.md)。
+ 面板显示选项：显示选项部分包含选项卡，您可以在其中配置数据可视化的各个方面。详细信息因所选可视化类型而异。

## 面板检查抽屉
<a name="v10-panels-editor-inspect"></a>

检查抽屉有助于您了解查询并进行问题排查。您可以查看任何面板的原始数据，将该数据导出到逗号分隔值（CSV）文件，查看查询请求，以及导出面板和数据 JSON。

**注意**  
并非所有面板类型都包含所有选项卡。例如，控制面板列表面板没有要检查的原始数据，因此不显示“统计”、“数据”或“查询”选项卡。

面板检查器包含以下选项：
+ 面板检查抽屉显示会在右侧显示为抽屉。选择右上角的箭头可展开或缩小抽屉窗格。
+ **数据选项卡**：显示应用转换后查询返回的原始数据。默认情况下，不会应用覆盖和值映射之类的字段选项。
+ **统计选项卡**：显示查询花费的时间和返回的数量。
+ **JSON 选项卡**：允许您查看和复制面板 JSON、面板数据 JSON 和数据帧结构 JSON。如果您在预置或管理 Grafana，这非常有用。
+ **查询选项卡**：显示 Grafana 查询数据来源时向服务器发送的请求。
+ **错误选项卡**：显示查询返回的任何错误。此选项卡仅在查询返回错误时可见。

# 面板检查视图
<a name="v10-panels-panel-inspector"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

面板检查视图可通过面板菜单打开，有助于您了解面板并排查问题。您可以检查任何 Amazon Managed Grafana 面板的原始数据，将该数据导出到逗号分隔值（CSV）文件，查看查询请求，以及导出面板和数据 JSON。

**注意**  
并非所有面板类型都包含所有选项卡。例如，控制面板列表面板没有要检查的原始数据，因此不显示“统计”、“数据”或“查询”选项卡。

面板检查器包含以下选项：

1. 面板检查器在窗格顶部显示**检查：**。选择右上角的箭头可展开或缩小窗格。

1. **数据选项卡**：显示应用转换后查询返回的原始数据。默认情况下，不会应用覆盖和值映射之类的字段选项。

1. **统计选项卡**：显示查询花费的时间和返回的数量。

1. **JSON 选项卡**：允许您查看和复制面板 JSON、面板数据 JSON 和数据帧结构 JSON。如果您在预置或管理 Grafana，这非常有用。

1. **查询选项卡**：显示 Grafana 查询数据来源时向服务器发送的请求。

1. **错误选项卡**：显示任何错误。仅在查询返回错误时可见。

## 下载原始查询结果
<a name="v10-panels-raw-query-results"></a>

Amazon Managed Grafana 会生成一个 CSV 文件，其中包含您的数据，包括对该数据的任何转换。您可以选择在面板应用字段选项或字段选项覆盖之前或之后查看数据。

**下载原始查询结果**

1. 编辑包含要下载的查询数据的面板。

1. 在查询编辑器中，选择**查询检查器**。

1. 选择**日期**。

   如果您的面板包含多个查询或查询多个节点，您还有其他选项。
   + **选择结果**：选择要查看的结果集数据。
   + **转换数据**
   + **按时间连接**：一次查看所有查询的原始数据，每列一个结果集。选择列标题以对数据重新排序。

1. 要在系统应用字段覆盖之前查看数据，请选择**格式化数据**切换按钮。

1. 要下载专门针对 Excel 格式化的 CSV 文件，请选择**下载 Excel** 切换按钮。

1. 选择**下载 CSV**。

## 检查查询性能
<a name="v10-panels-query-performance"></a>

**统计**选项卡显示统计数据，告诉您查询需要多长时间、发送的查询数量以及返回的行数。此信息有助于您对查询进行问题排查，尤其是在任何数字意外偏高或偏低时。

**检查查询性能**

1. 编辑包含要检查性能的查询的面板。

1. 在查询编辑器中，选择**查询检查器**。

1. 选择**统计**。

统计数据以只读格式显示。

## 检查查询请求和响应
<a name="v10-panels-query-request-response"></a>

如果要对返回意外结果或未能返回预期结果的查询进行问题排查，请检查查询请求和响应数据。

1. 编辑包含要导出的查询的面板。

1. 在查询编辑器中，选择**查询检查器**。

1. 选择**刷新**。

   面板将填充响应数据。

1. 根据需要进行调整，然后重新运行查询。

1. 要下载查询请求和响应数据，请单击**复制到剪贴板**图标，然后将结果粘贴到其他应用程序中。

# 查询和转换数据
<a name="v10-panels-query-xform"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

Amazon Managed Grafana 支持多种类型的[数据来源](AMG-data-sources.md)。数据来源*查询*返回数据，供 Grafana *转换*和可视化。每个数据来源都使用自己的查询语言，而每个数据来源插件都实现了一个名为查询编辑器的查询构建用户界面。

**Topics**
+ [关于查询](#v10-panels-query-xform-about)
+ [导航查询选项卡](#v10-panels-query-xform-navigate)
+ [添加查询](#v10-panels-query-xform-add)
+ [管理查询](#v10-panels-query-xform-manage)
+ [查询选项](#v10-panels-query-xform-options)
+ [编写表达式查询](v10-panels-query-xform-expressions.md)
+ [与其他面板共享查询结果](v10-panels-query-share.md)
+ [转换数据](v10-panels-xform.md)
+ [查询问题排查](v10-panels-query-troubleshoot.md)
+ [计算类型](v10-panels-calculation-types.md)

## 关于查询
<a name="v10-panels-query-xform-about"></a>

Grafana 面板通过查询与数据来源通信，查询会检索数据进行可视化。查询是用数据来源使用的查询语言编写的问题。

您可以在面板的数据来源选项中配置查询频率和数据收集限制。Grafana 每个面板最多支持 26 个查询。

有关每个数据来源查询语言的更多信息，请参阅[数据来源](AMG-data-sources.md)部分。

**查询编辑器**

每个数据来源的*查询编辑器*都提供了一个自定义的用户界面，可帮助您编写利用其独特功能的查询。

由于查询语言之间的差异，每个数据来源查询编辑器的外观和功能都不同。根据您的数据来源，查询编辑器可能会提供自动完成功能、指标名称、变量建议或可视化查询构建界面。

有关特定数据来源的唯一查询编辑器功能的详细信息，包括有关查询和语法的信息，请参阅数据来源文档：
+ 有关 Amazon Managed Grafana 中包含的数据来源，请参阅[内置数据来源](AMG-data-sources-builtin.md)。
+ 有关 Grafana Enterprise 中包含的数据来源，请参阅 [连接到企业数据来源](AMG-data-sources-enterprise.md)。
+ 对于通过 [使用插件目录查找插件](grafana-plugins.md#plugin-catalog) 安装的其他数据来源插件，文档链接在插件目录的列表中。

**查询语法**

数据来源使用不同的查询语言来请求数据。有关特定数据来源的独特查询语言的详细信息，请参阅其文档。

**PostgreSQL 示例：**

```
SELECT hostname FROM host WHERE region IN($region)
```

**PromQL 示例：**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**特殊数据来源**

Grafana 还包含三种特殊数据来源：**Grafana**、**混合**和**控制面板**。有关更多信息，请参阅 [连接到数据来源](AMG-data-sources.md)。

## 导航查询选项卡
<a name="v10-panels-query-xform-navigate"></a>

面板的**查询**选项卡由以下元素组成：
+ **数据来源选择器**：选择要查询的数据来源。
+ **查询选项**：设置最大数据检索参数和查询运行时间间隔。
+ **查询检查器按钮**：打开查询检查器面板，您可以在其中查看和优化查询。
+ **查询编辑器列表**：列出您编写的查询。
+ **表达式**：使用表达式生成器创建警报表达式。有关表达式的更多信息，请参阅[编写表达式查询](v10-panels-query-xform-expressions.md)。

## 添加查询
<a name="v10-panels-query-xform-add"></a>

查询返回数据，供 Grafana 在控制面板面板中可视化。创建面板时，Grafana 会自动选择默认数据来源。

**添加查询**

1. 编辑要向其中添加查询的面板。

1. 选择 **Query**（查询）选项卡。

1. 选择**数据来源**下拉菜单并选择一个数据来源。

1. 选择**查询选项**以配置所需的最大数据点数。有关查询选项的更多信息，请参阅 [查询选项](#v10-panels-query-xform-options)。

1. 使用查询编辑器编写查询。

1. 选择**应用**。

Grafana 查询数据来源并将数据可视化。

## 管理查询
<a name="v10-panels-query-xform-manage"></a>

Grafana 在可折叠的查询行中整理查询。每个查询行都包含一个查询编辑器，并以字母（A、B、C 等）进行标识。

要管理查询，您可以复制查询、隐藏查询、删除查询、重新排序查询以及切换查询编辑器的帮助。

## 查询选项
<a name="v10-panels-query-xform-options"></a>

选择数据来源选择器旁边的**查询选项**，查看所选数据来源的设置。您在此处所做的更改仅影响在此面板中进行的查询。

Grafana 设置了以深灰色文本显示的默认值。更改以白色文本显示。要将字段恢复为默认设置，请从该字段中删除白色文本。

面板数据来源查询选项包括：
+ **最大数据点数**：如果数据来源支持该选项，则为返回的每个序列设置最大数据点数。如果查询返回的数据点数超过最大数据点设置，则数据来源将按 average、max 其他函数将其聚合在一起，来减少返回的数据点数。

  您可以限制点数以提高查询性能或平滑可视化线条。默认值是图形的宽度（或像素数），因为只有图形面板有足够的空间显示尽可能多的数据点，才能实现可视化。

  在流处理数据中，Grafana 对滚动缓冲使用最大数据点值。流处理是连续的数据流，而缓冲将数据流划分为多个块。
+ **最小间隔**：为自动计算的间隔设置最小限制，通常是最小抓取间隔。如果每 15 秒保存一次数据点，低于此间隔不会对您有什么好处。您也可以将其设置为比抓取间隔更高的最小值，以检索更粗粒度且运行良好的查询。
+ **间隔**：按时间对数据点进行聚合或分组时可以使用的时间范围。

  Grafana 会自动计算适当的间隔，该间隔可用作模板化查询中的变量。变量以秒（`$__interval`）或毫秒（`$__interval_ms`）为单位。

  间隔通常用于 sum 或 average 等聚合函数。例如，这是一个使用间隔变量的 Prometheus 查询：`rate(http_requests_total[$__interval])`。

  此自动间隔是根据图形的宽度计算的。当用户缩小可视化时，间隔会增大，从而产生更粗粒度的聚合。同样，如果用户放大，间隔会减小，从而产生更细粒度的聚合。

  有关更多信息，请参阅 [全局变量](v10-dash-variable-add.md#v10-dash-variable-add-global)。
+ **相对时间**：覆盖各个面板的相对时间范围，使其与控制面板右上角控制面板时间选择器中所选择的时间不同。您可以使用此函数在同一控制面板上显示不同时间段或日期的指标。
**注意**  
当控制面板的时间范围为绝对值时，面板时间覆盖不起作用。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v10-panels-query-xform.html)
+ **时移**：通过相对于时间选取器移动面板的开始和结束时间，来覆盖各个面板的时间范围。例如，您可以将面板的时间范围移至比控制面板时间选择器早 2 小时。
**注意**  
当控制面板的时间范围为绝对值时，面板时间覆盖不起作用。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v10-panels-query-xform.html)
+ **缓存超时**：*（仅在数据来源中可用时才可见）*如果您的时间序列存储具有查询缓存，则覆盖默认缓存超时。将此值指定为数值（秒）。

# 编写表达式查询
<a name="v10-panels-query-xform-expressions"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

服务器端表达式使您能够用数学和其他运算查询返回的数据。表达式会创建新数据，但不操作数据来源返回的数据。

## 关于表达式
<a name="v10-panels-query-about"></a>

服务器端表达式使您能够用数学和其他运算查询返回的数据。表达式会创建新数据，但不操作数据来源返回的数据，除了一些小的数据重组，使数据成为表达式可接受的输入。

**使用表达式**

[Grafana Alerting](v10-alerts.md) 使用最常用的表达式。处理在服务器端完成，因此表达式可以在没有浏览器会话的情况下运行。但是，表达式也可以用于后端数据来源和可视化。

**注意**  
表达式不适用于旧版控制面板警报。

表达式旨在通过合并来自不同数据来源的查询或提供数据来源中不可用的运算来扩充数据来源。

**注意**  
在可能的情况下，应在数据来源内部进行数据处理。将数据从存储复制到 Grafana 服务器进行处理效率低下，因此表达式主要针对轻量级数据处理。

表达式适用于返回时间序列或数值数据的数据来源查询。还可以处理[多维数据](getting-started-grafanaui.md#time-series-dimensions)。例如，返回多个序列的查询，其中每个序列都由标签或标记标识。

单个表达式将一个或多个查询或其他表达式作为输入，并将数据添加到结果中。每个单独的表达式或查询都由一个变量表示，该变量是一个命名标识符，称为 RefID（例如，默认字母 `A` 或 `B`）。

要在另一个表达式中引用单个表达式或数据来源查询的输出，此标识符将用作变量。

**表达式类型**

表达式可以处理两种类型的数据。
+ 时间序列的集合。
+ 数字的集合，其中每个数字都是一个项。

每个集合均从单个数据来源查询或表达式返回，并由 ReFID 表示。每个集合都是一个集，而集中的每一项都由其维度唯一标识，这些维度以[标签](getting-started-grafanaui.md#labels)或键值对形式存储。

**数据来源查询**

服务器端表达式仅支持对后端数据来源的查询。通常假设数据是有标签的时间序列数据。

与表达式一起使用时，数据来源查询由表达式引擎运行。在此过程中，将数据重组为一个时间序列或每个数据帧一个数字。例如，如果使用的数据来源在表视图中的一个帧上返回多个序列，那么在使用表达式运行时，您可能会发现其看起来有所不同。

目前，在使用数据帧时，唯一支持的非时间序列格式（数字）是表响应，返回的是无时间的数据帧、字符串列和一个数字列：

以下示例表生成一个适用于表达式的数字。字符串列变成标签，数字列变成相应的值。例如 `{"Loc": "MIA", "Host": "A"}`，值为 1。


| Loc | 主机 | Avg\$1CPU | 
| --- | --- | --- | 
| MIA | A | 1 | 
| NYC | B | 2 | 

**操作**

您可以在表达式中使用以下运算：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` 运算排列时间戳。

摘要：
+ 数字 <Operation> 数字 = 数字
+ 数字 <Operation> 序列 = 序列
+ 序列 <Operation> 序列 = 序列

由于表达式处理由单个变量表示的多个序列或数字，因此二进制运算还会在两个变量之间执行联合（连接）。这是根据与每个序列或数字关联的标识标签完成的。

因此，如果 `$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

## 编写表达式
<a name="v10-panels-query-write"></a>

如果您的数据来源支持表达式，Grafana 会显示**表达式**按钮，并在查询编辑器列表中显示任何现有表达式。

**编写表达式**

1. 打开面板。

1. 在查询下方，选择**表达式**。

1. 在**运算**字段中，选择要编写的表达式类型。

1. 编写表达式。

1. 选择**应用**。

## 特殊情况
<a name="v10-panels-query-special"></a>

当任何查询的数据来源未返回序列或数字时，表达式引擎将返回 `NoData`。例如，如果请求包含两个由表达式合并的数据来源查询，而 `NoData` 由至少一个数据来源查询返回，则整个查询的返回结果为 `NoData`。有关 Grafana Alerting 如何处理 `NoData` 结果的更多信息，请参阅 [配置 Grafana 管理的警报规则](v10-alerting-configure-grafanamanaged.md)。

如果在多个查询中使用表达式，则表达式引擎要求所有查询都返回相同的时间戳。例如，如果使用数学方法合并多个 SQL 查询的结果（每个查询都使用 `SELECT NOW() AS "time"`），那么只有当所有查询都将 `NOW()` 评估为相同的时间戳时，表达式才会起作用，但这种情况并不总是发生。要解决此问题，可以将 `NOW()` 替换为任意时间，例如 `SELECT 1 AS "time"` 或任何其他有效的 UNIX 时间戳。

# 与其他面板共享查询结果
<a name="v10-panels-query-share"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

通过 Grafana，您可以将一个面板中的查询结果用于控制面板中的任何其他面板。跨面板共享查询结果可以减少对数据来源的查询次数，从而提高控制面板的性能。

*控制面板*数据来源允许您在控制面板中选择一个面板，其中包含要共享结果的查询。Grafana 没有为每个面板发送单独的查询，而是发送一个查询，而其他面板则使用查询结果来构造可视化。

例如，当您有多个面板可视化相同的数据时，该策略可以大大减少查询的次数。

**共享查询结果**

1. [创建控制面板](v10-dash-creating.md)。

1. 将标题更改为 `Source panel`。使用此面板作为其他面板的来源。

1. 定义要共享的一个或多个查询。

   如果没有可用的数据来源，可使用 **Grafana** 数据来源，这将返回一个可用于测试的随机时间序列。

1. 添加第二个面板，然后在查询编辑器中选择**控制面板**数据来源。

1. 在**使用来自面板列表的结果**中，选择您创建的第一个面板。

现在，在来源面板中定义的所有查询都可用于新面板。在来源面板中进行的查询可与多个面板共享。

您可以单击任何查询以转到定义查询的面板。

# 转换数据
<a name="v10-panels-xform"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

转换是一种强大方法，可在系统应用可视化之前处理查询返回的数据。通过转换，您可以：
+ 重命名字段
+ 连接时间序列数据
+ 跨查询执行数学运算
+ 将一个转换的输出用作另一个转换的输入

对于依赖同一数据集中多个视图的用户来说，转换是一种创建和维护大量控制面板的有效方法。

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

**注意**  
有时，系统无法绘制转换后的数据。发生这种情况时，单击可视化上方的**表视图**切换按钮，以切换到数据的表视图。这有助于您了解转换的最终结果。

## 转换类型
<a name="v10-panels-xform-types"></a>

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

## 转换顺序
<a name="v10-panels-xform-order"></a>

当存在多个转换时，Grafana 会按其列出的顺序来应用。每次转换都会创建一个新的结果集，然后传递给处理管道中的下一个转换。

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

## 向数据添加转换函数
<a name="v10-panels-xform-add"></a>

以下步骤将指导您向数据添加转换。本文档不包括每种转换类型的步骤。

**向面板添加转换**

1. 导航到要在其中添加一个或多个转换的面板。

1. 将鼠标悬停在面板的任何部分，右上角就会显示操作菜单。

1. 从操作菜单上选择**编辑**。

1. 选择**转换**选项卡。

1. 选择一个转换。此时会显示一个转换行，您可以在其中配置转换选项。

1. 要应用另一个转换，请选择**添加转换**。这次转换对上一次转换返回的结果执行操作。

## 调试转换
<a name="v10-panels-xform-debug"></a>

要查看转换的输入和输出结果集，请选择转换行右侧的调试（bug）图标。这将显示输入数据，并将转换结果显示为输出。

输入和输出结果集有助于调试转换。

## 禁用转换
<a name="v10-panels-xform-disable"></a>

您可以选择转换行右上角的显示（眼睛）图标来禁用或隐藏转换。这将禁用该特定转换的应用操作，并有助于在逐个更改多个转换时识别问题。

## 筛选转换
<a name="v10-panels-xform-filter"></a>

如果您的转换使用多个查询，则可以筛选这些查询，并将所选转换仅应用于其中一个查询。为此，请选择转换行右上角的筛选器图标。这将打开一个下拉列表，其中列出了面板上使用的查询列表。在这里，您可以选择要转换的查询。

您也可以按注释（包括样本）进行筛选，对其应用转换。执行此操作时，字段列表会发生变化，以反映注释或样本工具提示中的字段。

如果面板具有多个查询或数据来源（即面板或注释数据），则始终显示筛选器图标，但如果应用先前的合并查询输出的转换，则筛选器图标可能不起作用。这是因为转换会采用前一个转换的输出。

## 删除转换
<a name="v10-panels-xform-delete"></a>

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

先决条件：

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

**删除转换**

1. 打开面板进行编辑。

1. 选择**转换**选项卡。

1. 选择要删除的转换旁边的垃圾桶图标。

# 转换函数
<a name="v10-panels-xform-functions"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

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

## 从计算添加字段
<a name="v10-panels-xform-funcs-add"></a>

使用此转换可以添加一个根据其他两个字段计算得出的新字段。每次转换都允许您添加一个新字段。
+ **模式**：选择一种模式：
  + **减少行**：对选定字段的每一行分别应用所选计算。
  + **二元选项**：对两个选定字段的单行中的值应用基本的二元运算（求和、乘法等）。
  + **一元运算**：对选定字段的单行中的值应用基本的一元运算。可用运算包括：
    + **绝对值（abs）**：返回给定表达式的绝对值。以正数表示与零的距离。
    + **自然指数（exp）**：返回 *e* 的给定表达式的幂次。
    + **自然对数（ln）**：返回给定表达式的自然对数。
    + **下限（floor）**：返回小于或等于给定表达式的最大整数。
    + **上限（ceil）**：返回大于或等于给定表达式的最小整数。
  + **累积函数**：对当前行和前面所有行应用函数。
    + **总计**：计算不超过当前行的累积总数。
    + **平均值**：计算截至当前行（包括当前行）的平均值。
  + **窗口函数**：应用窗口函数。窗口可以*尾随*，也可以*居中*。对于尾随窗口，当前行将是窗口中的最后一行。对于居中窗口，窗口将在当前行居中。对于偶数窗口大小，窗口将在当前行和上一行之间居中。
    + **平均值**：计算移动平均数或移动平均值。
    + ****：计算移动标准差。
    + **方差**：计算移动方差。
  + **行索引**：插入带有行索引的字段。
+ **字段名称**：选择要在新字段的计算中使用的字段名称。
+ **计算**：如果您选择**减少行**模式，则会出现**计算**字段。选择字段以查看可用于创建新字段的计算选项列表。有关可用计算的信息，请参阅[计算类型](v10-panels-calculation-types.md)。
+ **运算**：如果选择**二元运算**或**一元运算**模式，则会出现**运算**字段。通过这些字段，您可以对来自两个选定字段的单行中的值进行基本数学运算。也可以使用数值进行二元运算。
+ **百分位数**：如果选择**行索引**模式，则会出现**百分位数**开关。此开关可将行索引转换为占总行数的百分比。
+ **别名**：（可选）输入新字段的名称。如果将此项保留为空，则将对该字段命名以与计算匹配。
+ **替换所有字段**：（可选）如果您想在可视化中隐藏所有其他字段并仅显示经过计算字段，请使用此选项。

**注意**  
**累积函数**和**窗口函数**当前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

## 连接字段
<a name="v10-panels-xform-funcs-concat"></a>

**连接字段**

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

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

考虑以下两个查询。

*查询 A：*


| 临时文件 | 正常运行时间 | 
| --- | --- | 
| 15.4 | 1230233 | 

*查询 B：*


| AQI | 错误 | 
| --- | --- | 
| 3.2 | 5 | 

连接字段后，数据帧为：


| 临时文件 | 正常运行时间 | AQI | 错误 | 
| --- | --- | --- | --- | 
| 15.4 | 1230233 | 3.2 | 5 | 

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

## 来自查询结果的配置
<a name="v10-panels-xform-funcs-config"></a>

**来自查询结果的配置**

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

**Options**
+ **配置查询**：选择返回要用作配置的数据的查询。
+ **应用于**：选择要对哪些字段或序列应用配置。
+ **应用于选项**：指定字段类型或使用字段名称正则表达式，具体取决于您在**应用于**中选择的选项。

**字段映射表**

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

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

*输入查询*


| 时间 | 值 | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

*配置查询*


| 时间 | 值 | 
| --- | --- | 
| 1626178119127 | 100 | 
| 1626178119129 | 100 | 

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


| 时间 | 值（配置：Max=100） | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

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

**值映射**

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

*配置查询结果*


| 值 | 文本 | 颜色 | 
| --- | --- | --- | 
| L | 低 | blue | 
| M | 中 | green | 
| H | 高 | red | 

*在字段映射中，指定：*


| 字段 | 用作 | Select | 
| --- | --- | --- | 
| 值 | 值映射/值 | 所有值 | 
| 文本 | 值映射/文本 | 所有值 | 
| 颜色 | 值映射/颜色 | 所有值 | 

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

## 转换字段类型
<a name="v10-panels-xform-funcs-convert"></a>

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

此转换具有以下选项：
+ **字段**：从可用字段中选择。
+ **as** — 选择 FieldType 要转换为的。
  + **数字**：尝试将值变为数字。
  + **字符串**：将值设为字符串。
  + **时间**：尝试将值解析为时间。
    + 将显示一个选项，用于通过字符串将 a 指定 DateFormat 为输入，例如`yyyy-mm-dd`或`DD MM YYYY hh:mm:ss`。
  + **布尔值**：将值变为布尔值。
  + **枚举**：将值变为枚举。
    + 将显示一个表来管理枚举。
  + **其他**：尝试将值解析为 json。

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


| 时间 | 标记 | 值 | 
| --- | --- | --- | 
| 2017-07-01 | 高于 | 25 | 
| 2018-08-02 | 低于 | 22 | 
| 2019-09-02 | 低于 | 29 | 
| 2020-10-04 | 高于 | 22 | 

结果：


| 时间 | 标记 | 值 | 
| --- | --- | --- | 
| 2017-01-01 00:00:00 | 高于 | 25 | 
| 2018-01-01 00:00:00 | 低于 | 22 | 
| 2019-01-01 00:00:00 | 低于 | 29 | 
| 2020-01-01 00:00:00 | 高于 | 22 | 

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

## 提取字段
<a name="v10-panels-xform-funcs-extract"></a>

使用此转换选择数据来源，从中提取不同格式的内容。此转换具有以下字段：
+ **来源**：选择数据来源的字段。
+ **格式**：选择以下选项之一：
  + **JSON**：从来源解析 JSON 内容。
  + **键\$1值对**：从来源解析 `a=b` 或 `c:d` 格式的内容。
  + **自动**：自动发现字段。
+ **替换所有字段**：（可选）如果要在可视化中隐藏所有其他字段并仅显示经过计算字段，请选择此选项。
+ **保留时间**：（可选）仅当**替换所有字段**为 true 时才可用。在输出中保留时间字段。

考虑以下数据集：

**数据集示例**


| Timestamp | json\$1data | 
| --- | --- | 
| 163667874000000000000 | \$1"value": 1\$1 | 
| 163667868000000000000 | \$1"value": 5\$1 | 
| 1636678620000000000 | \$1"value": 12\$1 | 

您可以使用以下配置来准备供[时间序列面板](v10-panels-time-series.md)使用的数据：
+ 来源：json\$1data
+ 格式：JSON
  + 字段：value
  + 别名：my\$1value
+ 替换所有字段：true
+ 保留时间：true

这将生成以下输出：

**转换后的数据**


| Timestamp | my\$1value | 
| --- | --- | 
| 163667874000000000000 | 1 | 
| 163667868000000000000 | 5 | 
| 1636678620000000000 | 12 | 

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

## 从资源中查找字段
<a name="v10-panels-xform-funcs-lookup"></a>

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

此转换具有以下字段：
+ **字段**：从数据集中选择一个文本字段。
+ **查找**：从**国家**、**美国各州**和**机场**中选择。

**注意**  
此转换仅支持空间数据。

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

**数据集示例**


| 位置 | 值 | 
| --- | --- | 
| AL | 0 | 
| AK | 10 | 
| 亚利桑那州 | 5 | 
| 阿肯色州 | 1 | 
| 某个地方 | 5 | 

使用此配置：
+ 字段：位置
+ 查找：美国各州

您将得到以下输出：

**转换后的数据**


| 位置 | ID | Name | Lng | Lat | 值 | 
| --- | --- | --- | --- | --- | --- | 
| AL | AL | Alabama | -80.891064 | 12.448457 | 0 | 
| AK | AK | 阿肯色州 | -100.891064 | 24.448457 | 10 | 
| 亚利桑那州 |  |  |  |  | 5 | 
| 阿肯色州 |  |  |  |  | 1 | 
| 某个地方 |  |  |  |  | 5 | 

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

## 按查询 refId 筛选数据
<a name="v10-panels-xform-funcs-queryrefid"></a>

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

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

**注意**  
这种转换不适用于 Graphite，因为此数据来源不支持将返回的数据与查询关联。

## 按值筛选数据
<a name="v10-panels-xform-funcs-values"></a>

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

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

所有字段的可用条件如下：
+ **正则表达式**：匹配正则表达式。
+ **为 Null 值**：如果值为 null 值，则匹配。
+ **为非 Null 值**：如果值为非 null 值，则匹配。
+ **等于**：如果值等于指定值，则匹配。
+ **不同**：如果值与指定值不同，则匹配。

数值字段的其他可用条件如下：
+ **大于**：如果值大于指定值，则匹配。
+ **小于**：如果值小于指定值，则匹配。
+ **大于或等于**：如果值大于或等于指定值，则匹配。
+ **小于或等于**：如果值小于或等于指定值，则匹配。
+ **范围**：匹配指定的最小值和最大值之间的范围，包括最小值和最大值。

考虑以下数据集：


| 时间 | 温度 | 海拔 | 
| --- | --- | --- | 
| 2020-07-07 11:34:23 | 32 | 101 | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:32:24 | 31 | 95 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

如果**包括**温度低于 30°C 的数据点，配置将如下所示：
+ 筛选器类型：“包含”
+ 条件：“温度”与“低于”“30”匹配的行

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

**转换后的数据**


| 时间 | 温度 | 海拔 | 
| --- | --- | --- | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

您可以向筛选器添加多个条件。例如，您可能希望仅在海拔大于 100 时才包含数据。为此，请将该条件添加到以下配置：
+ 筛选器类型：“包含”符合“全部匹配”条件的行
+ 条件 1：“温度”与“低于”“30”匹配的行
+ 条件 2：“海拔”与“高于”“100”匹配的行

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

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

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

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

## 按名称筛选字段
<a name="v10-panels-xform-funcs-name"></a>

使用此转换可删除部分查询结果。可通过三种方式筛选字段名称：
+ 输入正则表达式。
+ 手动选择包含的字段。
+ 使用控制面板变量。

*使用正则表达式*

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

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

*手动选择包含的字段*

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

*使用控制面板变量*

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

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

## 格式化字符串
<a name="v10-panels-xform-funcs-string"></a>

使用此转换来自定义字符串字段的输出。此转换具有以下字段：
+ **大写**：将整个字符串格式化为大写字符。
+ **小写**：将整个字符串格式化为小写字符。
+ **句子大小写**：将字符串的第一个字符格式化为大写。
+ **标题大小写**：将字符串中每个单词的第一个字符格式化为大写。
+ **Pascal 大小写**：将字符串中每个单词的第一个字符格式化为大写，并且单词之间不包含空格。
+ **Camel 大小写**：将字符串中每个单词的第一个字符（第一个单词除外）格式化为大写，并且单词之间不包含空格。
+ **Snake 大小写**：将字符串中的所有字符格式化为小写，并在单词之间使用下划线而不是空格。
+ **Kebab 大小写**：将字符串中的所有字符格式化为小写，并在单词之间使用短划线而不是空格。
+ **修剪**：删除字符串中的所有前导和尾随空格。
+ **子字符串**：使用指定的开始和结束位置返回字符串的子字符串。

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

**注意**  
此转换目前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

## 格式化时间
<a name="v10-panels-xform-funcs-time"></a>

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

**转换前：**


| Timestamp | 事件 | 
| --- | --- | 
| 163667874000000000000 | 系统启动 | 
| 163667868000000000000 | 用户登录 | 
| 1636678620000000000 | 数据更新 | 

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


| Timestamp | 事件 | 
| --- | --- | 
| 2021-11-12 14:25:40 | 系统启动 | 
| 2021-11-12 14:24:40 | 用户登录 | 
| 2021-11-12 14:23:40 | 数据更新 | 

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

**注意**  
此转换作为 alpha 功能在与 Grafana v10 兼容的工作区中可用。

## 分组依据
<a name="v10-panels-xform-funcs-group"></a>

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

以下是原始数据的示例：


| 时间 | 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 name="v10-panels-xform-funcs-groupmatrix"></a>

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

**原始数据**


| Server ID | CPU 温度 | 服务器状态 | 
| --- | --- | --- | 
| server 1 | 82 | OK | 
| server 2 | 88.6 | OK | 
| server 3 | 59.6 | 关闭 | 

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

**输出**


| 服务器 IDServer 状态 | OK | 关闭 | 
| --- | --- | --- | 
| server 1 | 82 |  | 
| server 2 | 88.6 |  | 
| server 3 |  | 59.6 | 

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

## 分组到嵌套表
<a name="v10-panels-xform-funcs-grouptable"></a>

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

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

下表显示了示例数据。


| 时间 | 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 | 

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


| Server ID | 数据 | 
| --- | --- | 
| 时间 | CPU 温度 | 服务器状态 | 
| --- | --- | --- | 
| 时间 | CPU 温度 | 服务器状态 | 
| --- | --- | --- | 
| 时间 | CPU 温度 | 服务器状态 | 
| --- | --- | --- | 
| server 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 7/7/2020 上午 11:34:20 | 80 | 关闭 | 
| 7/7/2020 上午 9:28:06 | 80 | OK | 
| 7/7/2020 上午 9:23:07 | 86 | OK | 
| 7/7/2020 上午 10:32:20 | 90 | 过载 | 
| 7/7/2020 上午 9:30:05 | 88 | OK | 
| 7/7/2020 上午 9:25:05 | 88 | OK | 
| 7/7/2020 上午 11:34:20 | 62 | OK | 
| 7/7/2020 上午 10:31:22 | 55 | 正常 | 
| 7/7/2020 上午 9:30:57 | 62 | Rebooting | 

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


| Server ID | CPU 温度（平均值） |  | 
| --- | --- | --- | 
| 时间 | 服务器状态 | 
| --- | --- | 
| 时间 | 服务器状态 | 
| --- | --- | 
| 时间 | 服务器状态 | 
| --- | --- | 
| server 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 2 | 88.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 3 | 59.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 7/7/2020 上午 11:34:20 | 关闭 | 
| 7/7/2020 上午 9:28:06 | OK | 
| 7/7/2020 上午 9:23:07 | OK | 
| 7/7/2020 上午 10:32:20 | 过载 | 
| 7/7/2020 上午 9:30:05 | OK | 
| 7/7/2020 上午 9:25:05 | OK | 
| 7/7/2020 上午 11:34:20 | OK | 
| 7/7/2020 上午 10:31:22 | OK | 
| 7/7/2020 上午 9:30:57 | Rebooting | 

## 创建热图
<a name="v10-panels-xform-funcs-heatmap"></a>

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

**X 桶**

此设置决定如何将 x 轴拆分为桶。
+ **大小**：可在输入字段中指定时间间隔。例如，时间范围为 `1h` 会在 x 轴上创建 1 小时宽的单元格。
+ **计数**-对于 non-time-related系列，使用此选项定义存储桶中的元素数量。

**Y 桶**

此设置决定如何将 y 轴拆分为桶。
+ **线性的**
+ **对数**：选择以 2 为底数的对数或以 10 为底数的对数。
+ **Symlog**：使用对称的对数刻度。选择以 2 为底数的对数或以 10 为底数的对数，允许负值。

假设有以下数据集：


| Timestamp | 值 | 
| --- | --- | 
| 2023-01-01 12:00:00 | 5 | 
| 2023-01-01 12:15:00 | 10 | 
| 2023-01-01 12:30:00 | 15 | 
| 2023-01-01 12:45:00 | 8 | 
+ 在 X 桶设置为 `Size: 15m`，Y 桶设置为 `Linear` 的情况下，直方图在 X 轴上以 15 分钟为时间间隔整理值，在 Y 轴上以线性方式整理值。
+ 在 X 桶设置为 `Count: 2`，Y 桶设置为 `Logarithmic (base 10)` 的情况下，直方图在 x 轴上将值分成两组，在 y 轴上使用对数刻度。

## 直方图
<a name="v10-panels-xform-funcs-histogram"></a>

使用此转换可根据输入数据生成直方图，从而可视化值的分布。
+ **桶大小**：桶中最低和最高项目之间的范围（xMin 到 xMax）。
+ **存储桶偏移量**-存储 non-zero-based桶的偏移量。
+ **合并序列**：使用所有可用序列创建统一的直方图。

**原始数据**

序列 1：


| A | B | C | 
| --- | --- | --- | 
| 1 | 3 | 5 | 
| 2 | 4 | 6 | 
| 3 | 5 | 7 | 
| 4 | 6 | 8 | 
| 5 | 7 | 9 | 

序列 2：


| C | 
| --- | 
| 5 | 
| 6 | 
| 7 | 
| 8 | 
| 9 | 

**输出**


| xMin | xMax | A | B | C | C | 
| --- | --- | --- | --- | --- | --- | 
| 1 | 2 | 1 | 0 | 0 | 0 | 
| 2 | 3 | 1 | 0 | 0 | 0 | 
| 3 | 4 | 1 | 1 | 0 | 0 | 
| 4 | 5 | 1 | 1 | 0 | 0 | 
| 5 | 6 | 1 | 1 | 1 | 1 | 
| 6 | 7 | 0 | 1 | 1 | 1 | 
| 7 | 8 | 0 | 1 | 1 | 1 | 
| 8 | 9 | 0 | 0 | 1 | 1 | 
| 9 | 10 | 0 | 0 | 1 | 1 | 

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

## 按字段连接
<a name="v10-panels-xform-funcs-joinfield"></a>

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

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

**内连接**

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

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

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

查询 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 | 

## 按标签连接
<a name="v10-panels-xform-funcs-joinlabel"></a>

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

这对于将多个时间序列结果转换为具有共享**标签**字段的单个宽表特别有用。
+ **连接**：选择在所有时间序列中的可用或通用标签之间进行连接的标签。
+ **值**：输出结果的名称。

**示例**

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


| 时间 | 值 | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

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


| 时间 | 值 | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

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


| 时间 | 值 | 
| --- | --- | 
| 22 | 22 | 
| 28 | 77 | 

配置：

```
value: 'what'
```

输出：


| cluster | 作业 | 临时文件 | Speed | 
| --- | --- | --- | --- | 
| A | J1 | 10 |  | 
| A | J1 | 200 |  | 
| B | J1 | 10 | 22 | 
| B | J1 | 200 | 77 | 

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

## 标签到字段
<a name="v10-panels-xform-funcs-labelstofields"></a>

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

给定两个时间序列的查询结果：
+ 序列 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 name="v10-panels-xform-funcs-limit"></a>

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

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


| 时间 | 指标 | 值 | 
| --- | --- | --- | 
| 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 | 

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

## 合并序列/表
<a name="v10-panels-xform-funcs-merge"></a>

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

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

*查询 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 | 

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

## 按名称整理字段
<a name="v10-panels-xform-funcs-organize"></a>

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

**转换字段**

Grafana 会显示查询返回的字段列表。你可以：
+ **更改字段顺序**：将字段拖到列表中的新位置。
+ **隐藏或显示字段**：使用字段名称旁边的眼睛图标切换字段的可见性。
+ **重命名字段**：在**重命名**框中键入新名称。

**示例**

鉴给定此初始查询结果：


| 时间 | 指标 | 值 | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 温度 | 25 | 
| 2020-07-07 11:34:20 | 湿度 | 22 | 
| 2020-07-07 10:32:20 | 湿度 | 29 | 

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


| 时间 | 传感器 | 读数 | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 温度 | 25 | 
| 2020-07-07 11:34:20 | 湿度 | 22 | 
| 2020-07-07 10:32:20 | 湿度 | 29 | 

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

## 按值分区
<a name="v10-panels-xform-funcs-partition"></a>

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

**注意**  
此功能可用于兼容 Grafana 9 及更高版本的工作区。

这在使用指标 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 | 

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

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

## 准备时间序列
<a name="v10-panels-xform-funcs-preparetimeseries"></a>

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

**多帧时间序列**

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

*示例*

以下输入：


| Timestamp | Value1 | Value2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

可以转换为：


| Timestamp | 变量 | 值 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Value1 | 10 | 
| 2023-01-01 00:00:00 | Value2 | 20 | 
| 2023-01-01 01:00:00 | Value1 | 15 | 
| 2023-01-01 01:00:00 | Value2 | 25 | 

**宽时间序列**

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

*示例*

以下输入：


| Timestamp | 变量 | 值 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Value1 | 10 | 
| 2023-01-01 00:00:00 | Value2 | 20 | 
| 2023-01-01 01:00:00 | Value1 | 15 | 
| 2023-01-01 01:00:00 | Value2 | 25 | 

可以转换为：


| Timestamp | Value1 | Value2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

## Reduce
<a name="v10-panels-xform-funcs-reduce"></a>

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

考虑以下输入：

查询 A：


| 时间 | 临时文件 | 正常运行时间 | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 12.3 | 256122 | 
| 2020-07-07 11:24:20 | 15.4 | 1230233 | 

查询 B：


| 时间 | AQI | 错误 | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 6.5 | 15 | 
| 2020-07-07 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 | 

## 按正则表达式重命名
<a name="v10-panels-xform-funcs-rename"></a>

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

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

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

## 行到字段
<a name="v10-panels-xform-funcs-row"></a>

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

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

这种转换需要：
+ 一个字段用作字段名称的来源。

  默认情况下，转换使用第一个字符串字段作为来源。您可以在要使用的字段的**用作**列中选择**字段名称**，来覆盖此默认设置。
+ 一个字段用作值的来源。

  默认情况下，转换使用第一个数字字段作为来源。但您可以在要使用的字段的**用作**列中选择**字段值**，来覆盖此默认设置。

在以下位置可视化数据时非常有用：
+ 计量表
+ Stat
+ 饼图

**将多余字段映射到标签**

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

示例：


| Name | DataCenter | 值 | 
| --- | --- | --- | 
| ServerA | 美国 | 100 | 
| ServerB | EU | 200 | 

输出：


| ServerA（标签： DataCenter: 美国） | ServerB（标签： DataCenter：欧盟） | 
| --- | --- | 
| 100 | 200 | 

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

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

**示例**

输入：


| Name | 值 | 最大值 | 
| --- | --- | --- | 
| ServerA | 10 | 100 | 
| ServerB | 20 | 200 | 
| ServerC | 30 | 300 | 

输出：


| ServerA（配置：max=100） | ServerB（配置：max=200） | ServerC（配置：max=300） | 
| --- | --- | --- | 
| 10 | 20 | 30 | 

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

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

## 序列到行
<a name="v10-panels-xform-funcs-series"></a>

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

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

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

*查询 A：*


| 时间 | 温度 | 
| --- | --- | 
| 2020-07-07 11:34:20 | 25 | 
| 2020-07-07 10:31:22 | 22 | 
| 2020-07-07 09:30:05 | 19 | 

*查询 B：*


| 时间 | 湿度 | 
| --- | --- | 
| 2020-07-07 11:34:20 | 24 | 
| 2020-07-07 10:32:20 | 29 | 
| 2020-07-07 09:30:57 | 33 | 

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


| 时间 | 指标 | 值 | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 温度 | 25 | 
| 2020-07-07 11:34:20 | 湿度 | 22 | 
| 2020-07-07 10:32:20 | 湿度 | 29 | 
| 2020-07-07 10:31:22 | 温度 | 22 | 
| 2020-07-07 09:30:57 | 湿度 | 33 | 
| 2020-07-07 09:30:05 | 温度 | 19 | 

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

## 排序依据
<a name="v10-panels-xform-funcs-sort"></a>

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

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

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

## 空间
<a name="v10-panels-xform-funcs-spatial"></a>

使用此转换将空间运算应用于查询结果。
+ **操作**：选择一个操作：
  + **准备空间字段**：根据其他字段的结果设置几何字段。
    + **位置模式**：选择位置模式（这些选项由**计算值**和**转换**模式共用）：
      + **自动**：根据默认字段名称自动识别位置数据。
      + **坐标**：指定纬度和经度字段。
      + **地理哈希**：指定地理哈希字段。
      + **查找**：指定地名录位置字段。
  + **计算值**-使用几何定义新字段 (heading/distance/area)。
    + **函数**：选择要应用于几何图形的数学运算：
      + **方向**：计算两点之间的方向。
      + **面积**：计算由几何图形的多边形包围的面积。
      + **距离**：计算两点之间的距离。
  + **转换**：对几何图形应用空间运算。
    + **运算**：选择要应用于几何图形的运算：
      + **作为行**：在每一行上创建一个具有顶点的单行特征。
      + **线生成器**：在两点之间创建一条线。

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

## 时间序列到表的转换
<a name="v10-panels-xform-funcs-seriestotable"></a>

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

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

## 回归分析
<a name="v10-panels-xform-funcs-regression"></a>

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

有两种不同的模式：
+  **线性回归**：将线性函数拟合到数据。
+  **多项式回归**：将多项式函数拟合到数据。

**注意**  
此转换目前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

# 查询问题排查
<a name="v10-panels-query-troubleshoot"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

本页提供了如何解决常见控制面板问题的信息。

**当我重新排列函数时，得到不同的结果**

函数顺序非常重要。就像数学一样，函数的放置顺序会影响结果。

**检查查询请求和响应**

最常见的问题与数据来源的查询和响应有关。似乎是 Grafana 中的错误或可视化问题，其实是数据来源查询或数据来源响应的问题。首先检查面板查询和响应。

有关更多信息，请参阅[检查请求和响应数据](v10-panels-panel-inspector.md)。

**查询速度缓慢**

查询返回多少个数据点？ 返回大量数据点的查询速度会很慢。尝试：
+ 在**查询选项**中，限制返回的**最大数据点**。
+ 在**查询选项**中，增加**最小间隔**时间。
+ 在查询中，使用 `group by` 函数。

# 计算类型
<a name="v10-panels-calculation-types"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

下表包含可在 Grafana 中执行的计算列表。您可以在**转换**选项卡以及条形仪表、仪表和统计数据可视化中找到这些计算结果。


| 计算 | 说明 | 
| --- | --- | 
| 全部为 null | 当所有值都为 null 时为 True | 
| 所有值 | 包含所有值的数组 | 
| 所有唯一值 | 包含所有唯一值的数组 | 
| 全部为 0 | 当所有值都为 0 时为 True | 
| 更改计数 | 字段值更改的次数 | 
| 计数 | 字段中值的数量 | 
| Delta | 值的累积变化，仅计算增量 | 
| 区别 | 字段第一个值和最后一个值的差 | 
| 百分比差 | 字段第一个值和最后一个值的百分比差 | 
| 去重计数 | 字段中唯一值的数量 | 
| 第一个 | 字段中第一个值 | 
| 第一个\$1（非 null） | 首先，字段中的值不是空值（也排除 NaNs） | 
| Last | 字段中最后一个值 | 
| 最后一个\$1（非 null） | 字段中的最后一个非空值（也排除 NaNs） | 
| 最大值 | 字段的最大值 | 
| 平均值 | 字段中所有值的平均值 | 
| 方差 | 字段中所有值的方差 | 
| StdDev | 字段中所有值的标准差 | 
| 最小值 | 字段的最小值 | 
| 最小值（大于 0） | 字段的最小正值 | 
| Range | 字段的最大值和最小值的差 | 
| 步骤 | 字段值之间的最小间隔 | 
| Total | 字段中所有值的总和 | 

# 配置面板选项
<a name="v10-panels-configure-panel-options"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

Grafana 面板是数据的可视化表示，您可以通过定义数据来源查询、转换和格式化数据以及配置可视化设置来自定义该面板。

面板编辑器包括一个查询生成器和一系列选项，您可以使用这些选项来转换数据，向面板添加信息。

本主题介绍了如何：
+ 打开面板进行编辑
+ 添加面板标题和描述
+ 查看面板 JSON 模型
+ 配置重复行和面板

## 编辑面板
<a name="v10-panels-edit-a-panel"></a>

将面板添加到控制面板后，可以随时打开面板更改或更新查询、添加数据转换以及更改可视化设置。

**编辑面板**

1. 打开包含要编辑其面板的控制面板。

1. 将鼠标悬停在面板的任何部分，右上角就会显示操作菜单。

1. 选择菜单，然后选择**编辑**。

   要使用键盘快捷键打开面板，请将鼠标悬停在面板上，然后按 `e` 键。

   面板将以编辑模式打开。

## 向面板添加标题和描述
<a name="v10-panels-add-title-description"></a>

向面板添加标题和描述，与用户共享有关可视化的任何重要信息。例如，使用描述来记录可视化的目的。

1. 编辑面板。

1. 在面板显示选项窗格中，找到**图例选项**部分。

1. 输入**标题**。

   在此字段中输入的文本将显示在面板编辑器和控制面板中的面板顶部。

1. 为面板和要显示的数据编写描述。

   在此字段中输入的文本将显示在面板左上角的工具提示中。

   您可以在**标题**和**描述**字段中使用[定义的变量](v10-dash-variables.md)，但不能使用[全局变量](v10-dash-variable-add.md#v10-dash-variable-add-global)。

## 查看面板 JSON 模型
<a name="v10-panels-json-model"></a>

浏览和导出面板、面板数据和数据帧 JSON 模型。

**查看面板 JSON 模型**

1. 打开包含面板的控制面板。

1. 将鼠标悬停在面板的任何部分，右上角就会显示操作菜单。

1. 从菜单中选择**检查 > 面板 JSON**。

1. 在**选择来源**字段中，选择以下选项之一：
   + **面板 JSON**：显示代表面板的 JSON 对象。
   + **面板数据**：显示一个 JSON 对象，该对象表示传递给面板的数据。
   + **DataFrame st** ructure-显示面板的数据结构，包括已应用的所有转换、字段配置和覆盖配置。

1. 要浏览 JSON，请选择 **>** 展开或折叠 JSON 模型的各个部分。

## 配置重复面板
<a name="v10-panels-configure-repeating-panels"></a>

您可以配置 Grafana 以向控制面板动态添加面板或行。动态面板是系统根据变量值创建的面板。变量会动态更改控制面板中所有面板的查询。有关重复面板的更多信息，请参阅 [创建控制面板](v10-dash-creating.md)。

**注意**  
重复面板需要变量来选择一个或多个项目；不能将面板重复零次以将其隐藏。

*先决条件*
+ 确保查询包含多值变量。

**配置重复面板**

1. 编辑要重复的面板。

1. 在显示选项窗格上，选择**面板选项 > 重复选项**。

1. 选择**方向**。
   + 选择**水平**排列面板 side-by-side。Grafana 可调整重复面板的宽度。您不能将一行中的其他面板与重复的面板混合使用。
   + 选择**垂直**将面板排列成一列。重复面板的宽度与原始重复面板的宽度相同。

1. 要将更改传播到所有面板，请重新加载控制面板。

# 配置标准选项
<a name="v10-panels-configure-standard-options"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

Grafana 中使用的数据模型是一种面向列的表结构，统一了时间序列和表查询结果。此结构中的每一列都称为*字段*。一个字段可以表示单个时间序列或表列。

字段选项允许您更改数据在可视化中的显示方式。您应用的选项和替代不会更改数据，而是改变 Grafana 显示数据的方式。更改选项后，将应用于所有字段，即所有序列或列。例如，如果将单位更改为百分比，则所有带有数值的字段都将以百分比显示。

本主题后面提供了字段格式设置选项的完整列表。

**注意**  
您可以将标准选项应用于大多数内置 Grafana 面板。一些尚未更新到新面板和数据模型的旧面板和社区面板将缺少全部或部分字段选项。

**配置标准选项**

1. 打开控制面板。将鼠标悬停在面板的任何部分，控制面板右上角就会显示操作菜单。

1. 从 操作菜单上选择**编辑**。

1. 在面板显示选项窗格中，找到**标准选项**部分。

1. 选择要应用的标准选项。

1. 要预览更改，请选择您正在编辑的字段选项框的外部，或按 **Enter** 键。

**标准选项定义**

本节介绍了所有可用的标准选项。

您可以将标准选项应用于大多数内置 Grafana 面板。一些尚未更新到新面板和数据模型的旧面板和社区面板将缺少全部或部分字段选项。

除非您在正在编辑的字段选项框外部单击或按 **Enter** 键，否则大多数字段选项不会影响可视化。

**注意**  
Grafana Labs 一直在努力为所有可视化添加和扩展选项，但并非所有选项都适用于所有可视化。

## 单位
<a name="v10-panels-standard-options-unit"></a>

允许选择字段应使用的单位。选择**单位**字段，然后向下钻取，直到找到所需的单位。您选择的单位将应用于除时间之外的所有字段。

### 自定义单位
<a name="v10-panels-standard-options-custom-units"></a>

您也可以使用单位下拉列表来指定自定义单位、自定义前缀或后缀以及日期时间格式。

要选择自定义单位，请输入单位，然后在下拉列表中选择最后一个**自定义：xxx** 选项。
+ **后缀：<suffix>** 应跟在值后面的自定义单位。
+ **前缀：<prefix>** 应放在值前面的自定义单位。
+ **时间：<format>** 自定义日期时间格式类型，例如 `time:YYYY-MM-DD`。有关格式语法和选项，请参阅 *Moment.js 文档*中的[格式](https://momentjs.com/docs/#/displaying/)。
+ **si:<base scale><unit characters>** 自定义 SI 单位。例如：`si: mF`。这个更高级一些，因为您可以指定单位和来源数据比例。因此，如果您的来源数据表示为毫（千），请在单位前面加上该 SI 比例字符。
+ **计数：<unit>** 自定义计数单位。
+ **货币：<unit>** 自定义货币单位。

您还可以在单位选择器中粘贴原生表情符号，然后将其选择为自定义单位。

### 字符串单位
<a name="v10-panels-standard-options-string-units"></a>

Grafana 有时在解析字符串并将其显示为数字时过于激进。要配置 Grafana 以显示原始字符串值，请创建一个字段覆盖，并添加一个带有**字符串**单位的单位属性。

### 缩放单位
<a name="v10-panels-standard-options-scale-units"></a>

默认情况下，Grafana 将根据值的大小自动缩放单位。例如，如果您的值为 0.14kW，Grafana 将显示为 140W；再比如 3000kW 将显示为 3MW。如果要禁用此行为，可以关闭**缩放单位**开关。

## 最小值
<a name="v10-panels-standard-options-min"></a>

这让您可以设置百分比阈值计算中使用的最小值。留空可自动计算最小值。

## 最大值
<a name="v10-panels-standard-options-max"></a>

这让您可以设置百分比阈值计算中使用的最大值。留空可自动计算最大值。

## 字段最小值/最大值
<a name="v10-panels-standard-options-fieldminmax"></a>

默认情况下，计算的最小值和最大值将基于所有序列和字段中的最小值和最大值。打开字段将 min/max 根据每个字段的最小值或最大值分别计算每个字段的最小值或最大值。

## 小数
<a name="v10-panels-standard-options-decimals"></a>

指定 Grafana 在渲染值中包含的小数位数。如果将此字段留空，Grafana 会根据值自动截断小数位数。例如，1.1234 将显示为 1.12，100.456 将显示为 100。

要显示所有小数，请将单位设置为**字符串**。

## 显示名称
<a name="v10-panels-standard-options-displayname"></a>

可设置所有字段的显示标题。可以在字段标题中使用[变量](v10-dash-variables.md)。

当显示多个统计数据、字段或序列时，此字段控制每个统计数据中的标题。您可以使用 **\$1\$1\$1\$1field.name\$1** 这样的表达式，仅在标题中使用序列名称或字段名称。

给定一个名为 `Temp`，标签为 `{"Loc"="PBI", "Sensor"="3"}` 的字段：


| 表达式语法 | 示例 | 渲染为 | 说明 | 
| --- | --- | --- | --- | 
| \$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 | 显示用逗号分隔的标签值（不含标签键）。 | 

如果在呈现特定字段的表达式后该值为空字符串，则使用默认的显示方法。

## 颜色方案
<a name="v10-panels-standard-options-color-scheme"></a>

颜色选项及其对可视化的影响取决于您正在使用的可视化效果。有些可视化有不同的颜色选项。

您可以指定单一颜色，也可以根据值选择连续（渐变）颜色方案。连续颜色使用相对于最小值和最大值的百分比来插值颜色。

选择以下调色板之一：


| 颜色模式 | 说明 | 
| --- | --- | 
| 单色 | 指定单一颜色，这在覆盖规则中很有用 | 
| 颜色阴影 | 选择单一颜色阴影，这在覆盖规则中很有用 | 
| 来自阈值 | 通知 Grafana 从匹配的阈值中获取颜色 | 
| 经典调色板 | Grafana 将通过序列索引在调色板中查找颜色来分配颜色。适用于图形、饼图和其他分类数据可视化 | 
| 经典调色板（按序列名称） | Grafana 将根据序列的名称指定颜色。当要可视化的序列名称取决于可用数据时很有用。 | 
| Green-Yellow-Red （按价值计算） | 连续颜色方案 | 
| Red-Yellow-Green （按价值计算） | 连续颜色方案 | 
| Blue-Yellow-Red （按价值计算） | 连续颜色方案 | 
| 黄色-红色（按值） | 连续颜色方案 | 
| 蓝色-紫色（按值） | 连续颜色方案 | 
| 黄色-蓝色（按值） | 连续颜色方案 | 
| 蓝色（按值） | 连续颜色方案（面板背景为蓝色） | 
| 红色（按值） | 连续颜色方案（面板背景为红色） | 
| 绿色（按值） | 连续颜色方案（面板背景为绿色） | 
| 紫色（按值） | 连续颜色方案（面板背景为紫色） | 

## 无值
<a name="v10-panels-standard-options-no-value"></a>

输入当字段值为空或 null 时 Grafana 应显示的内容。默认值为连字符（-）。

# 配置图例
<a name="v10-panels-configure-legend"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

面板包含一个图例，您可以使用该图例来解释可视化中显示的数据。每个图例选项都为可视化中显示的数据添加了上下文和清晰度。

以下可视化支持的图例：
+ [条形图](v10-panels-bar-chart.md)
+ [K 线图](v10-panels-candlestick.md)
+ [直方图](v10-panels-histogram.md)
+ [饼图](v10-panels-piechart.md)
+ [状态时间轴](v10-panels-state-timeline.md)
+ [状态历史记录](v10-panels-status-history.md)
+ [时间序列](v10-panels-time-series.md)
+ [趋势](v10-panels-trend.md)

[Geomap](v10-panels-geomap.md) 和[热图](v10-panels-heatmap.md)也有图例，但仅提供显示或不显示图例的选项，不支持其他图例选项。

## 图例选项
<a name="v10-panels-legend-options"></a>

您可以在面板编辑窗格的**图例**部分找到以下选项。

**注意**  
并非所有列出的选项都适用于所有带有图例的可视化。

**可见性**

设置是否显示图例。使用开关打开或关闭图例。

**Mode (模式)**

设置图例的显示格式。从中选择：
+ **列表**
+ **表**

将图例格式化为表时，也可能会显示有关图例的其他信息，例如关联值或图例在可视化中的位置。

**放置**

设置图例在可视化中的显示位置。从中选择：
+ **Bottom**
+ **Right**

**Width (宽度)**

如果将图例放置设置为**右**，则**宽度**选项将变为可用。将该字段留空，以便 Grafana 自动设置图例宽度，或者在字段中输入一个值。

**值**

您可以在图例中添加序列数据值或[计算](v10-panels-calculation-types.md)，为可视化添加更多上下文。您可以添加任意数量的值。应用更改后，您可以滚动图例以查看所有值。

## 更改序列颜色
<a name="v10-panels-legend-change-color"></a>

默认情况下，Grafana 会设置序列数据的颜色，但您可以通过面板图例进行更改。

**更改序列颜色**

1. 导航到要更新的面板。

1. 在图例中，选择与序列关联的颜色条。

1. 使用选取器或 RGB 值在**颜色**选项卡中选择预设颜色，或在**自定义**选项卡中设置自定义颜色。

1. 保存控制面板。

## 在可视化中隔离序列数据
<a name="v10-panels-legend-isolate"></a>

可视化通常在视觉上比较复杂，而且包含许多数据序列。您可以通过图例从可视化中删除序列数据来简化视图，从而隔离要查看的数据。在此过程中，Grafana 会在**覆盖**选项卡中自动创建新的覆盖。

**在可视化中隔离序列数据**

1. 导航到要更新的面板。

1. 在图例中，选择要隔离的序列的标签。

   系统将从视图中删除所有其他序列数据。

1. 要以增量方式将序列数据重新添加到孤立的序列中，请按 **Ctrl** 或 **Command** 键，然后选择要添加的序列的标签。

1. 要保存更改，使其显示在面板的所有查看器上，请保存控制面板。

要恢复到包含所有数据的默认视图，请单击任意序列标签两次。

## 对序列排序
<a name="v10-panels-legend-sort"></a>

当您将图例格式化为表并向其中添加值时，可以按这些值对表中的序列排序。

**对序列排序**

1. 导航到要更新的面板。

1. 将鼠标悬停在您要处理的面板的任何部分，以在面板的右上角显示菜单。

1. 从菜单上选择**编辑**。

1. 滚动至面板编辑窗格的**图例**部分。

1. 在**值**下，选择要显示的值或计算。

   图例现在显示值。

1. 在图例表中选择计算名称标题，按升序或降序对表中的值排序。

**注意**  
只有以下面板支持此功能：条形图、直方图、时间序列。

# 配置数据链接
<a name="v10-panels-configure-data-links"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

通过数据链接，可为链接提供更精细的上下文。您可以创建包含序列名称甚至光标下值的链接。例如，如果您的可视化显示四台服务器，则可以向其中一两台服务器添加数据链接。您也可以使用数据链接来链接面板。

根据可视化效果，可通过不同的方式访问链接本身。例如，对于时间序列可视化，您可以选择数据点或数据线。对于统计、仪表或条形仪表之类的大面积可视化，您可以选择可视化中的任意位置来打开上下文菜单。

如果可视化中只有一个数据链接，则选择可视化中的任意位置都会打开链接，而不是上下文菜单。

**支持的可视化**
+ 条形图
+ 条形仪表
+ K 线图
+ Canvas
+ 计量表
+ Geomap
+ 热图
+ 直方图
+ 饼图
+ Stat
+ 状态时间轴
+ 状态历史记录
+ 表
+ 时间序列
+ 趋势

## 数据链接变量
<a name="v10-panels-data-link-variables"></a>

您可以在数据链接中使用变量，将用户引导至具有保留数据筛选条件的详细控制面板。例如，您可以使用变量来指定标签、时间范围、序列和变量选择。

要查看可用变量列表，请在数据链接 **URL** 字段中输入 `$`。

您也可以在数据链接中使用模板变量 URLs，请参阅[变量](v10-dash-variables.md)。

### 时间范围面板变量
<a name="v10-panels-time-range-panel-variables"></a>

您可以使用这些变量在数据链接 URL 中包含当前时间范围。
+ `__url_time_range`：当前控制面板的时间范围（即 `?from=now-6h&to=now`）
+ `$__from` – 有关更多信息，请参阅[全局变量](v10-dash-variable-add.md#v10-dash-variable-add-global)。
+ `$__to` – 有关更多信息，请参阅[全局变量](v10-dash-variable-add.md#v10-dash-variable-add-global)。

### 序列变量
<a name="v10-panels-series-variables"></a>

特定于序列的变量在 `__series` 命名空间下可用：
+ `__series.name`：URL 的序列名称

### 字段变量
<a name="v10-panels-field-variables"></a>

特定于字段的变量在 `__field` 命名空间下可用：
+ `__field.name`：字段的名称
+ `__field.labels.<LABEL>`：URL 的标签值。如果您的标签包含点，请使用 `__field.labels["<LABEL>"]` 语法。

### 值变量
<a name="v10-panels-value-variables"></a>

特定于值的变量在 `__value` 命名空间下可用：
+ `__value.time`：URL 的值的时间戳（Unix 毫秒纪元）（即 `?time=1560268814105`）
+ `__value.raw`：原始值
+ `__value.numeric`：值的数字表示
+ `__value.text`：值的文本表示
+ `__value.calc`：如果值是计算结果，则为计算名称

在数据链接中使用特定于值的变量可以显示不同的结果，具体取决于工具提示模式的设置选项。

### 数据变量
<a name="v10-panels-data-variables"></a>

要访问其他字段的值，请使用：
+ `__data.fields[i]`：字段 `i` 的值（在同一行上）。
+ `__data.fields["NameOfField"]`：使用名称而不是索引的字段值。
+ `__data.fields[i].labels.cluster`：访问其他字段的标签。

### 模板变量
<a name="v10-panels-template-variables"></a>

在链接到其他使用模板变量的控制面板时，请为单击链接的用户选择变量值。

`${var-myvar:queryparam}`：其中 `var-myvar` 是模板变量的名称，该名称与您要使用的当前控制面板中的模板变量相匹配。


| 变量状态 | 创建 URL 的结果 | 
| --- | --- | 
| 选择一个值 | var-myvar=value1 | 
| 选择多个值 | var-myvar=value1&var-myvar=value2 | 
| 已选择 All | var-myvar=All | 

如果要将当前控制面板的所有变量添加到 URL，请使用 `${__all_variables}`。

## 添加数据链接
<a name="v10-panels-add-a-datalink"></a>

您可以向面板添加数据链接。

1. 导航到要向其添加数据链接的面板。

1. 将鼠标悬停在面板上，右上角会显示菜单图标。

1. 从菜单中选择**编辑**以打开面板编辑器。

1. 在**面板编辑**窗格中，向下滚动到**数据链接**部分并将其展开。

1. 选择**添加链接**。

1. 在打开的对话框中，输入**标题**。这是是链接的可读标签，显示在 UI 中。

1. 输入要链接的 **URL** 或变量。

   要添加数据链接变量，请选择 **URL** 字段，然后输入 `$` 或按 Ctrl\$1Space 或 Cmd\$1Space 以查看可用变量列表。

1. 如果要在新选项卡中打开链接，请选择**在新选项卡中打开**。

1. 选择**保存**以保存更改并关闭对话框。

1. 保存对控制面板的更改。

# 配置值映射
<a name="v10-panels-configure-value-mappings"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

除了字段覆盖外，值映射是一种方法，可用来更改数据在可视化中的显示方式。

数值映射可绕过面板编辑器[标准选项](v10-panels-configure-standard-options.md)中设置的单位格式，如显示的颜色或小数位数。当面板中存在值映射时，Grafana 会在面板编辑器的**值映射**部分显示其摘要。

**支持的可视化**
+ 条形图
+ 条形仪表
+ K 线图
+ Canvas
+ 计量表
+ Geomap
+ 直方图
+ 饼图
+ Stat
+ 状态时间轴
+ 状态历史记录
+ 表
+ 时间序列
+ 趋势

## 值映射的类型
<a name="v10-panels-value-mappings-types"></a>

Grafana 支持以下值映射类型：
+ **值**：将特定值映射到文本和颜色。例如，您可以配置一个值映射，使值 `10` 的所有实例都显示为 `Perfection!` 而不是数字。当您想要格式化单个值时，请使用**值**映射。
+ **范围**：将数值范围映射到文本和颜色。例如，如果某个值在某个范围内，则可以将范围值映射配置为显示 `Low` 或 `High` 而不是数字。当您想要格式化多个连续值时，请使用**范围**映射。
+ **正则表达式**：将正则表达式映射到文本和颜色。例如，如果值为 `www.example.com`，则可以配置正则表达式值映射，以便 Grafana 显示 `www` 并截断域。当您想要格式化正则表达式值的文本和颜色时，请使用**正则表达式**映射。
+ **特殊**：将特殊值（如 `Null`、`NaN`（非数字）和布尔值（如 `true` 和 `false`）映射到文本和颜色。例如，您可以配置特殊值映射，使 `null` 值显示为 `N/A`。当您要格式化不常用值、布尔值或空值时，请使用**特殊**映射。

## 添加值映射
<a name="v10-panels-value-mappings-add"></a>

您可以为面板添加值映射。

**添加值映射**

1. 导航到要更新的面板。

1. 将鼠标悬停在面板的任何部分，面板右上角会显示菜单。

1. 从菜单上选择**编辑**。

1. 在**值映射**部分，选择**添加值映射**。

1. 选择**添加新映射**，然后选择以下选项之一：
   + **值**：输入要匹配的单个值。
   + **范围**：输入要匹配的范围起始值和结束值。
   + **正则表达式**：输入要匹配的正则表达式模式。
   + **特殊**：选择要匹配的特殊值。

1. （可选）输入显示文本。

1. （可选）设置颜色。

1. 选择**更新**保存值映射。

添加映射后，**编辑值映射**按钮将取代**添加值映射**按钮。选择编辑按钮以添加或更新映射。

# 配置阈值
<a name="v10-panels-configure-thresholds"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

在控制面板中，阈值是您为指标设置的值或限制，当达到或超过指标时，阈值会直观地反映出来。阈值是您可以根据查询结果有条件地设置可视化样式和颜色的一种方法。

您可以使用阈值：
+ 为时间序列可视化中的网格线或网格区域着色。
+ 为统计可视化中的背景或值文本着色。
+ 在状态时间线中定义区域和区域颜色。
+ 为时间序列可视化中的线条着色。
+ 为仪表中的仪表和阈值标记着色。
+ 为 geomap 中的标记着色。
+ 为表中的单元格文本或背景着色。

**支持的可视化**
+ 条形图
+ 条形仪表
+ K 线图
+ Canvas
+ 计量表
+ Geomap
+ 直方图
+ Stat
+ 状态时间轴
+ 状态历史记录
+ 表
+ 时间序列
+ 趋势

## 默认阈值
<a name="v10-panels-thresholds-default"></a>

在支持阈值的可视化中，Grafana 具有以下默认阈值设置：
+ 80 = 红色
+ 基本 = 绿色
+ 模式 = 绝对
+ 显示阈值 = 关闭（对于某些可视化）

  有关更多信息，请参阅 [显示阈值](#v10-panels-thresholds-show)。

## 阈值选项
<a name="v10-panels-thresholds-options"></a>

您可以设置以下选项来进一步定义阈值的外观。

### 阈值
<a name="v10-panels-thresholds-value"></a>

此数字是触发阈值的值。您也可以在此字段中设置与阈值关联的颜色。

**基本**值表示负无穷大。默认设置为绿色，通常表示颜色正常。

### 阈值模式
<a name="v10-panels-thresholds-mode"></a>

有两种阈值模式：
+ **绝对**阈值由数字定义。例如，从 1 到 150 的刻度 80。
+ **百分比**阈值是相对于最小值或最大值定义的。例如，80%。

### 显示阈值
<a name="v10-panels-thresholds-show"></a>

**注意**  
只有条形图、K 线图、时间序列和趋势可视化支持此选项。

使用以下选项设置是否以及如何在可视化上显示阈值。
+ **关闭**：不显示阈值。
+ **为线条**：阈值在可视化中显示为水平线条。
+ **为线条（虚线）**：阈值显示为水平虚线。
+ **为填充区域**：阈值显示为水平区域。
+ **为填充区域和线条**：阈值显示为由线条分隔的水平区域。
+ **为填充区域和线条（虚线）**：阈值显示为由虚线分隔的水平区域。

## 添加阈值
<a name="v10-panels-thresholds-add"></a>

您可以根据需要向可视化添加任意数量的阈值。Grafana 会自动将阈值从最高到最低排序。

**添加阈值**

1. 导航到要更新的面板。

1. 将鼠标悬停在面板的任何部分，右上角就会显示菜单。

1. 从菜单中选择**编辑**。

1. 滚动到**阈值**部分，或在面板编辑窗格顶部的搜索栏中输入 `Thresholds`。

1. 选择 **\$1 添加阈值**。

1. 输入新的阈值，或使用字段右侧的向上和向下箭头逐步增加或减少该值。

1. 单击阈值左侧的彩色圆圈以打开颜色选取器，您可以在其中更新阈值颜色。

1. 在**阈值模式**下，选择**绝对值**或**百分比**。

1. 在**显示阈值**下，设置阈值的显示方式，或将其关闭。

要删除阈值，请导航到包含阈值的面板，然后选择要删除的阈值旁边的垃圾桶图标。

# 配置字段覆盖
<a name="v10-panels-configure-overrides"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

您可以通过覆盖自定义特定字段或序列的可视化设置。这是通过添加覆盖规则来实现的，该规则针对一组特定的字段，每个字段可以定义多个选项。

例如，您可以为所有包含文本 `bytes` 的字段设置单位，方法是使用**名称与正则表达式匹配的字段**匹配程序添加覆盖，然后将单位选项添加到覆盖规则。

## 示例 1：格式化温度
<a name="v10-panels-overrides-format-temperature"></a>

假设结果集是一个由两个字段组成的数据帧：`time` 和 `temperature`。


| 时间 | temperature | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45.0 | 
| 2020-01-02 03:05:00 | 47.0 | 
| 2020-01-02 03:06:00 | 48.0 | 

此结构的每个字段（列）都可以应用字段选项，从而改变其值的显示方式。例如，您可以将“单位”设置为“温度”>“摄氏度”，结果如下表所示：


| 时间 | temperature | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45.0°C | 
| 2020-01-02 03:05:00 | 47.0°C | 
| 2020-01-02 03:06:00 | 48.0°C | 

此外，不需要小数位，我们可以将其删除。您可以将小数从 **auto** 更改为零（**0**），从而得到以下表：


| 时间 | temperature | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45°C | 
| 2020-01-02 03:05:00 | 47°C | 
| 2020-01-02 03:06:00 | 48°C | 

## 示例 2：格式化温度和湿度
<a name="v10-panels-overrides-format-humidity"></a>

假设结果集是一个由四个字段组成的数据帧：`time`、`high temp`、`low temp` 和 `humidity`。


| 时间 | 高温 | 低温 | 湿度 | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45.0 | 30.0 | 67 | 
| 2020-01-02 03:05:00 | 47.0 | 34.0 | 68 | 
| 2020-01-02 03:06:00 | 48.0 | 31.0 | 68 | 

我们添加摄氏度单位并去掉小数位。这将生成下表：


| 时间 | 高温 | 低温 | 湿度 | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45°C | 30°C | 67°C | 
| 2020-01-02 03:05:00 | 47°C | 34°C | 68°C | 
| 2020-01-02 03:06:00 | 48°C | 31°C | 68°C | 

温度字段看起来不错，但现在必须更改湿度。我们可以通过对湿度字段应用字段选项覆盖并将单位更改为“杂项”>“百分比（0-100）”来解决此问题。


| 时间 | 高温 | 低温 | 湿度 | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45°C | 30°C | 67% | 
| 2020-01-02 03:05:00 | 47°C | 34°C | 68% | 
| 2020-01-02 03:06:00 | 48°C | 31°C | 68% | 

## 添加字段覆盖
<a name="v10-panels-overrides-add-a-field"></a>

字段覆盖规则可以自定义特定字段或序列的可视化设置。

**添加字段覆盖**

1. 编辑要添加覆盖的面板。

1. 在面板选项侧窗格中，选择窗格底部的**添加字段覆盖**。

1. 选择要应用覆盖规则的字段：
   + **带名称的字段**：从所有可用字段列表中选择一个字段。使用此选择器添加到规则中的属性仅应用于此单个字段。
   + **名称与正则表达式匹配的字段**：使用该选项来指定要用正则表达式覆盖的字段。使用此选择器向规则添加的属性将应用于字段名称与正则表达式匹配的所有字段。这将选择要覆盖的字段，但不会重命名字段；为此，请使用[通过正则表达式重命名](v10-panels-xform-functions.md)转换。
   + **带类型的字段**：使用该选项可以按类型选择字段，例如字符串、数值等。使用此选择器添加到规则中的属性将应用于与所选类型匹配的所有字段。
   + **查询返回的字段**：选择特定查询返回的所有字段，例如 A、B 或 C。使用此选择器添加到规则中的属性将应用于所选查询返回的所有字段。

1. 选择**添加覆盖属性**。

1. 选择要应用的字段选项。

1. 通过在字段中添加值来输入选项。要将选项恢复为默认值，请删除字段中的白色文本。

1. 通过选择**添加覆盖属性**继续向该字段添加覆盖，或者您可以选择**添加覆盖**，然后选择其他要添加覆盖的字段。

1. 完成后，选择**保存**将所有面板编辑保存到控制面板。

## 删除字段覆盖
<a name="v10-panels-overrides-delete-a-field"></a>

当您不再需要字段覆盖时，将其删除。删除覆盖时，值的外观默认为其原始格式。此更改会影响依赖受影响面板的控制面板和控制面板用户。

**删除字段覆盖**

1. 编辑包含要删除的覆盖的面板。

1. 在面板选项侧窗格中，向下滚动直到看到覆盖。

1. 选择要删除的覆盖，然后选择关联的垃圾桶图标。

## 查看字段覆盖
<a name="v10-panels-overrides-view"></a>

您可以在面板显示选项中查看字段覆盖。

1. 编辑包含要查看的覆盖的面板。

1. 在面板选项侧窗格中，向下滚动直到看到覆盖。

**注意**  
**全部**选项卡上显示的覆盖设置与**覆盖**选项卡上显示的设置相同。

## 编辑字段覆盖
<a name="v10-panels-overrides-edit-a-field"></a>

要更改覆盖设置时，编辑字段覆盖。更改会立即生效。

**编辑字段覆盖**

1. 编辑包含要编辑的覆盖的面板。

1. 在面板选项侧窗格中，向下滚动直到看到覆盖。

1. 找到要更改的覆盖。

1. 执行以下任一操作：
   + 编辑现有覆盖或字段选择参数的设置。
   + 选择属性旁边的 **X** 来删除现有的覆盖属性。
   + 选择**添加覆盖属性**来添加覆盖属性。

# Grafana 10 提供的可视化
<a name="v10-panels-viz"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

Grafana 提供了多种可视化来支持不同的用例。本文档的这一部分重点介绍了内置可视化、其选项和典型用法。

[时间序列](v10-panels-time-series.md) 面板是一种常见的入门面板，用于学习使用面板的基础知识。

**注意**  
如果您不确定要选择哪个可视化，Grafana 可以根据面板查询提供可视化建议。当您选择可视化时，Grafana 将显示应用该可视化效果的预览。
+ 图形和图表
  + [时间序列](v10-panels-time-series.md)为默认，也是主要的图形可视化。
  + [状态时间轴](v10-panels-state-timeline.md)表示一段时间内的状态变化。
  + [状态历史记录](v10-panels-status-history.md)表示一段时间内的周期性状态。
  + [条形图](v10-panels-bar-chart.md)显示任何分类数据。
  + [直方图](v10-panels-histogram.md)计算并在条形图中显示值分布。
  + [热图](v10-panels-heatmap.md)以二维形式可视化数据，通常用于表示现象的幅度。
  + [饼图](v10-panels-piechart.md)通常用于比例很重要的地方。
  + [K线图通常](v10-panels-candlestick.md)用于以变动为 price/data 重点的财务数据。
  + [仪表](v10-panels-gauge.md)是传统的圆形视觉效果，显示单个指标距阈值的距离。
  + [趋势](v10-panels-trend.md)用于具有连续数字 X（而非时间）的数据集。
  + [XY 图表](v10-panels-xychart.md)提供了一种在图形中可视化任意 x 和 y 值的方法。
+ 统计和数字
  + [统计](v10-panels-stat.md)表示大型统计数据和可选迷你图。
  + [条形仪表](v10-panels-bar-gauge.md)是水平或垂直条形仪表。
+ Misc (杂项)
  + [表](v10-panels-table.md)是主要且唯一的表可视化。
  + [日志](v10-panels-logs.md)是日志的主要可视化效果。
  + [节点图](v10-panels-node-graph.md)表示定向图形或网络。
  + [跟踪](v10-panels-traces.md)是跟踪的主要可视化效果。
  + [火焰图](v10-panels-flamegraph.md)是分析的主要可视化效果。
  + [Geomap](v10-panels-geomap.md) 用来可视化地理空间数据。
  + [数据网格](v10-panels-datagrid.md)让您可以创建和操作数据，充当其他面板的数据来源。
+ 小组件
  + [控制面板列表](v10-panels-dashboard-list.md)可列出控制面板。
  + [警报列表](v10-panels-alert-list.md)可列出警报。
  + [文本](v10-panels-text.md)可显示 markdown 和 html。
  + [新闻](v10-panels-news.md)可显示 RSS 源。

## 获取更多
<a name="v10-panels-getmore"></a>

您可以从 [使用插件目录查找插件](grafana-plugins.md#plugin-catalog) 安装面板插件来添加更多可视化类型。

## 示例
<a name="v10-panels-examples"></a>

在以下部分中，您可以找到可视化示例。

## 图表
<a name="v10-panels-ex-graphs"></a>

对于基于时间的折线图、面积图和条形图，我们建议使用默认的[时间序列](v10-panels-time-series.md)可视化。

![\[显示 Grafana 中时间序列可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/time_series_example.png)


对于分类数据，请使用[条形图](v10-panels-bar-chart.md)。

![\[显示 Grafana 中条形图可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/barchart_example.png)


## 大型数字和统计
<a name="v10-panels-ex-numbers"></a>

[统计](v10-panels-stat.md)可视化显示一个很大的统计值，并带有可选的图表迷你图。您可以使用阈值或色阶控制背景或值颜色。

![\[显示 Grafana 中统计可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/stat_panel_example.png)


## 计量表
<a name="v10-panels-ex-gauge"></a>

如果要显示与最小值和最大值相关的值，则有两个选项。首先是标准径向[仪表](v10-panels-gauge.md)：

![\[显示 Grafana 中仪表可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/gauge_example.png)


其次，Grafana 还具有水平或垂直[条形仪表](v10-panels-bar-gauge.md)，具有三种不同的显示模式。

![\[显示 Grafana 中仪表可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## 表
<a name="v10-panels-ex-table"></a>

要在表布局中显示数据，请使用[表](v10-panels-table.md)可视化。

![\[显示 Grafana 中表可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/table_example.png)


## 饼图
<a name="v10-panels-ex-piechart"></a>

要显示一个或多个查询中的缩减序列或序列中的值（因为其彼此相关），请使用[饼图](v10-panels-piechart.md)可视化。

![\[显示 Grafana 中饼图可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/pie_chart_example.png)


## 热图
<a name="v10-panels-ex-heatmaps"></a>

要显示一段时间内的值分布，请使用[热图](v10-panels-heatmap.md)可视化。

![\[显示 Grafana 中热图可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## 状态时间轴
<a name="v10-panels-ex-state"></a>

[状态时间轴](v10-panels-state-timeline.md)可显示一段时间内的离散状态变化。与时间序列一起使用时，使用阈值将数值转换为离散状态区域。

![\[显示 Grafana 中状态时间轴可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/state_timeline_example.png)


# 警报列表
<a name="v10-panels-alert-list"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

使用警报列表来显示警报。您可以将列表配置为显示当前状态。有关警报的更多信息，请参阅 [Grafana 10 版本中的警报](v10-alerts.md)。

使用这些设置来改进可视化结果。

## 选项
<a name="v10-panels-alert-list-options"></a>
+ **组模式**：选择**默认分组**以显示按警报规则分组的警报实例，或者选择**自定义分组**以按一组自定义标签对警报实例进行分组。
+ **最大项目数**：设置要列出的最大警报数。
+ **排序顺序**：选择显示警报的排序方式。
  + **按字母顺序（升序）**：按字母顺序排列
  + **按字母顺序（降序）**：按字母顺序倒序排列
  +  **重要性**：根据以下值，按重要性划分，其中 1 为最高：
    + `alerting` 或 `firing`：1
    + `no_data`：2
    + `pending`：3
    + `ok`：4
    + `paused` 或 `inactive`：5
  + **时间（升序）**：最新的活动警报实例优先。
  + **时间（降序）**：最早的活动警报实例优先。
+  **来自此控制面板的警报**：仅显示警报列表所在控制面板的警报。

## 筛选条件
<a name="v10-panels-alert-filter"></a>

通过这些选项，您可以将显示的警报限制为仅与您选择的查询、文件夹或标签匹配的警报：
+ **警报名称**：输入警报名称查询。
+ **警报实例标签**：使用标签查询筛选警报实例。例如 `{severity="critical", instance=~"cluster-us-.+"}`。
+ **文件夹**：选择一个文件夹。仅会显示所选文件夹中控制面板的警报。
+ **数据来源**：筛选来自所选数据来源的警报。

## 状态筛选条件
<a name="v10-panels-alert-state-filter"></a>

选择要在此面板中显示的警报状态。
+ 警报/触发
+ 待定
+ 无数据
+ Normal
+ 错误

# 注释列表
<a name="v10-panels-annotations"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

注释列表显示了可用于查看注释数据的可用注释列表。有多种选项可用于根据标签和当前控制面板筛选列表。

## 注释查询
<a name="v10-panels-annotations-query"></a>

以下选项可控制注释列表的来源查询。

**查询筛选条件**

使用查询筛选条件从组织中的所有控制面板或此面板所在的当前控制面板创建注释列表。具有以下选项：
+ 所有控制面板：列出当前组织中所有控制面板的注释。
+ 此控制面板：将列表限制为当前控制面板上的注释。

**时间范围**

使用时间范围选项来指定是否应将列表限制在当前时间范围内。具有以下选项：
+ 无：注释查询没有时间范围限制。
+ 此控制面板：将列表限制为注释列表面板可用的控制面板的时间范围内。

**标签**

使用标签选项按标签筛选注释。您可以添加多个标签以优化列表。

**注意**  
或者，将标签列表留空，然后选择作为面板本身结果一部分列出的标签来动态筛选。

**限制**

使用“限制”选项来限制返回的结果数量。

## 显示
<a name="v10-panels-annotations-display"></a>

这些选项可控制注释面板显示中包含的其他元数据。

**显示用户**

使用此选项显示或隐藏创建注释的用户。

**显示时间**

使用此选项显示或隐藏创建注释的时间。

**显示标签**

使用此选项显示或隐藏注释相关的标签。*注意*：您可以使用标签对可视化本身的注释列表进行实时筛选。

## 链接行为
<a name="v10-panels-annotations-links"></a>

**链接目标**

使用此选项选择如何查看带注释的数据。具有以下选项：
+ 面板：此选项可让您直接进入面板的全屏视图，其中包含相应的注释
+ 控制面板：此选项将注释聚焦于完整控制面板的上下文中

**之前的时间**

使用此选项设置注释之前的时间范围。使用持续时间字符串值，例如“1h”= 1 小时，“10m”= 10 分钟等。

**之后的时间**

使用此选项设置注释之后的时间范围。

# 条形图
<a name="v10-panels-bar-chart"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

条形图允许用图形表示分类数据。

![\[显示 Grafana 中条形图可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/barchart_example.png)


## 支持的数据格式
<a name="v10-panels-bar-chart-formats"></a>

仅支持一个数据框，且该数据框至少需要一个字符串字段（用作 X 轴或 Y 轴的类别）和一个或多个数值字段。以下是数据格式的示例：


| 浏览器 | 市场占有率 | 
| --- | --- | 
| Chrome | 50 | 
| Internet Explorer | 17.5 | 

如果您有多个数值字段，面板会显示分组条形图。

### 可视化时间序列或多个结果集
<a name="v10-panels-bar-chart-visualization"></a>

如果您有多个时间序列或表，则首先需要使用 join 或 reduce 转换将其连接。例如，如果您有多个时间序列，并想要比较其最新值和最大值，请添加 **Reduce** 转换，并在**计算**下指定**最大值**和**最新值**选项。

## 条形图选项
<a name="v10-panels-bar-chart-options"></a>

使用以下选项来优化可视化效果。

**方向**
+ **自动**：Grafana 根据面板尺寸决定条形图的方向。
+ **水平**：将 X 轴设为类别轴。
+ **垂直**：将 Y 轴设为类别轴。

**旋转 x 轴刻度标签**

 当图形为垂直方向时，此设置会旋转条形图下方的标签。当条形图标签较长且重叠时，此设置很有用。

**X 轴刻度标签最大长度**

设置条形图标签的最大长度。超过最大长度的标签会被截断（用省略号）。

**条形标签最小间距**

设置条形标签之间的最小间距。

**显示值**

控制值是显示在条形图的顶部还是左侧。
+ **自动**：如果有空间，则显示值。
+ **始终**：始终显示值。
+ **从不**：从不显示值。

**堆叠**

控制条形图堆叠。
+ **关闭**：条形图不会堆叠。
+ **正常**：条形图彼此堆叠。
+ **百分比**：条形图彼此堆叠，每个条形图的高度为堆叠总高度的百分比。

**组宽度**

控制组的宽度。
+ `0 = Minimum width`
+ `1 = Maximum width`

**条形图宽度**

控制条形图的宽度。
+ `0 = Minimum width`
+ `1 = Maximum width`

**条形图半径**

控制条形图的半径。
+ `0 = Minimum radius`
+ `0.5 = Maximum radius`

**悬停时突出显示整个区域**

控制将鼠标悬停在条形图上时，是否突出显示条形图的整个周围区域。

**线宽**

控制条形图的线宽。

**填充不透明度**

控制条形图的填充不透明度。

**渐变模式**

设置渐变填充的模式。填充渐变基于线条颜色。要更改颜色，请使用标准颜色方案字段选项。

渐变外观受**填充不透明度**设置的影响。
+ **无**：无渐变填充。这是默认设置。
+ **不透明度**：渐变的透明度是根据 y 轴上的值计算的。填充的不透明度随 Y 轴上的值增加而增加。
+ **色调**：渐变色是根据线条颜色的色调生成的。

**工具提示模式**

当您将光标悬停在可视化上时，Grafana 可显示工具提示。选择工具提示的行为方式。
+ **单个**：悬停工具提示仅显示一个序列，即您将鼠标悬停在可视化上面的序列。
+ **全部**：悬停工具提示显示可视化中的所有序列。Grafana 在工具提示的序列列表中以粗体突出显示您悬停在上面的序列。
+ **隐藏**：与可视化交互时不显示工具提示。

**注意**  
可使用覆盖从工具提示隐藏单个序列。

**文本大小**

输入一个值以更改条形图上文本的大小。

## 图例选项
<a name="v10-panels-bar-chart-legend"></a>

**图例模式**

使用这些设置可定义图例在可视化中的显示方式。有关更多信息，请参阅 [配置图例](v10-panels-configure-legend.md)。
+ **列表**：以列表形式显示图例。这是图例的默认显示模式。
+ **表**：以表的形式显示图例。
+ **隐藏**：隐藏图例。

**图例放置**

选择放置图例的位置。
+ **底部**：显示在图形下方。
+ **右**：显示在图形右侧。

**图例值**

选择要在图例中显示的序列数据值或标准计算。可以输入多个值。有关更多信息，请参阅 [配置图例](v10-panels-configure-legend.md)。

## 轴选项
<a name="v10-panels-bar-chart-axis"></a>

使用以下字段设置来优化轴的显示方式。除非您在正在编辑的字段选项框外部单击或按 Enter 键，否则某些字段选项不会影响可视化。

**放置**

设置 y 轴的放置。
+ **自动**：Grafana 会自动为序列分配 Y 轴。当有两个或多个具有不同单位的序列时，Grafana 将左轴分配给第一个单位，将右轴分配给下一个单位。
+ **左**：在左侧显示所有 Y 轴。
+ **右**：在右侧显示所有 Y 轴。
+ **隐藏**：隐藏所有 Y 轴。

要有选择地隐藏轴，请针对特定字段[添加字段覆盖](v10-panels-configure-overrides.md)。

**标签**

设置 Y 轴文本标签。如果有多个 Y 轴，可使用覆盖分配不同的标签。

**Width (宽度)**

设置轴的固定宽度。默认情况下，Grafana 会动态计算轴的宽度。

通过设置轴的宽度，具有不同轴类型的数据可以共享相同的显示比例。这样就可以更容易比较多个图形的数据，因为轴在视觉上不会相互移动或拉伸。

**软最小值和软最大值**

设置软最小值或软最大值选项，以更好地控制 Y 轴限制。默认情况下，Grafana 会根据数据集自动设置 Y 轴的范围。

软最小值或软最大值设置可以防止在数据大部分平缓的情况下，出现山峰状的突起，而从标准最小值和最大值字段选项派生的硬最小值或硬最大值，则可以通过剪裁超过定义点的尖峰，来防止间歇性尖峰压平有用的细节。

您可以设置标准 min/max 选项来定义 Y 轴的硬限制。有关更多信息，请参阅 [配置标准选项](v10-panels-configure-standard-options.md)。

**显示多个 y 轴**

在某些情况下，您可能希望显示多个 Y 轴。例如，如果您有一个数据集，显示一段时间内的温度和湿度，则可能需要为这两个序列显示两个具有不同单位的 y 轴。

您可以通过[添加字段覆盖](v10-panels-configure-overrides.md)来实现这一点。根据需要多次执行这些步骤，以添加任意数量的 y 轴。

# 条形仪表
<a name="v10-panels-bar-gauge"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

条形仪表可将每个字段归约为单个值，从而简化数据。您可以选择 Grafana 计算归约的方式。

此面板可以显示一个或多个条形仪表，具体取决于查询返回的序列、行或列的数量。

![\[显示 Grafana 中条形仪表可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## 值选项
<a name="v10-panels-bar-gauge-value"></a>

使用以下选项来优化可视化显示值的方式：

**Show (显式)**

选择 Grafana 显示数据的方式。

**计算**

显示基于所有行的计算值。
+ **计算**：选择一个 reducer 函数，Grafana 将使用该函数将多个字段归约为单个值。有关可用计算的列表，请参阅[计算类型](v10-panels-calculation-types.md)。
+ **字段**：选择面板中显示的字段。

**所有值**

为每行显示一个单独的统计数据。如果选择此选项，则还可以限制要显示的行数。
+ **限制**：要显示的最大行数。默认为 5000。
+ **字段**：选择面板中显示的字段。

## 条形仪表选项
<a name="v10-panels-bar-gauge-options"></a>

调整条形仪表的显示方式。

**方向**

选择堆叠方向。
+ **自动**：Grafana 会选择其认为最佳的方向。
+ **水平**：从左到右水平拉伸条形图。
+ **垂直**：从上到下垂直拉伸条形图。

**显示模式**

选择一种显示模式。
+ **渐变**：阈值级别定义梯度。
+ **复古 LCD**：将仪表分成点亮或不点亮的小单元格。
+ **基本**：基于匹配阈值的单色。

**值显示**

选择一种值显示模式。
+ **值颜色**：值颜色由值决定。
+ **文本颜色**：值颜色是默认的文本颜色。
+ **隐藏**：隐藏值。

**名称放置**

选择名称放置模式。

**注意**  
仅当条形仪表的方向为水平时，此选项才适用。当条形仪表处于垂直方向时，名称始终放在每个条形仪表的底部。
+ **自动**：Grafana 决定最佳位置。
+ **顶部**：名称位于每个条形仪表的顶部。
+ **左**：称位于每个条形仪表的左侧。

**显示未填充区域**

如果要将条形图的未填充区域渲染为深灰色，请选择此选项。不适用于复古 LCD 显示模式。

**条形图尺寸**

选择条形图尺寸模式。
+ **自动**：Grafana 决定最佳条形仪表尺寸。
+ **手动**：手动配置条形仪表尺寸。

**最小宽度**

当仪表垂直放置时，限制条形图列的最小宽度。

当数据量较大时，自动显示 x 轴滚动条。

**注意**  
此选项仅在条形图尺寸设置为手动时适用。

**最小高度**

当仪表处于水平方向时，限制条形图行的最小高度。

当数据量较大时，自动显示 y 轴滚动条。

**注意**  
此选项仅在条形图尺寸设置为手动时适用。

**最大高度**

当仪表处于水平方向时，限制条形图行的最大高度。

当数据量较大时，自动显示 y 轴滚动条。

**注意**  
此选项仅在条形图尺寸设置为手动时适用。

# K 线图
<a name="v10-panels-candlestick"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

通过 K 线图可视化，您可以可视化包含多个一致维度的数据（侧重于价格走势）。Kandlestick 面板包括 Open-High-Low-Close (OHLC) 模式，并支持基于时间序列数据的其他维度。

![\[显示 Grafana 中 K 线图可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/candlestick-panel-example.png)


K 线图可视化建立在 [时间序列](v10-panels-time-series.md) 的基础之上，包含许多常用的配置设置。

## Mode
<a name="v10-panels-candlestick-mode"></a>

您可以使用模式选项切换用于可视化的维度。
+ **K 线图**：将面板维度限制为 K 线图可视化使用的开盘、高点、低点和收盘维度。
+ **成交量**：将面板维度限制为成交量维度。
+ **二者**：是 K 线图面板的默认行为。包括 K 线图和成交量可视化。

## 蜡烛样式
<a name="v10-panels-candlestick-style"></a>
+ **K 线图**：默认的显示样式，可在开盘和收盘维度之间创建蜡烛样式的可视化效果。
+ **OHLC 条形图**：显示四个核心维度的开盘值、高点值、低点值和收盘值。

## 颜色策略
<a name="v10-panels-candlestick-color"></a>
+ **开盘以来**：默认行为。如果期间内价格变动为正值，该模式将使用*上涨*颜色。换句话说，如果收盘时的值大于或等于开盘时的值，则使用*上涨*颜色。
+ **上次收盘以来**：另一种显示方法，蜡烛的颜色取决于期间内的价格走势或价值变化。换句话说，如果开盘值大于收盘值，则使用*上涨*颜色。如果开盘值小于收盘值，则使用*下跌*颜色。*该选项还会触发空心 K 线图可视化模式*。空心表示周期内的变动为正值（收盘时的值高于开盘时的值），实心表示周期内的变动为负值（收盘时的值低于开盘时的值）。要了解更多信息，请参阅[差异说明](https://thetradingbible.com/how-to-read-hollow-candlesticks)。

## 上涨和下跌颜色
<a name="v10-panels-candlestick-updown"></a>

**上涨颜色**和**下跌颜色**选项用于选择价格上涨或下跌时使用的颜色。上述*颜色策略*将决定是使用周期内还是周期间的价格变动来选择 K 线图或 OHLC 条形图的颜色。

## 开盘、高点、低点、收盘
<a name="v10-panels-candlestick-ohlc"></a>

K 线图面板会尝试将字段映射到相应的维度。
+ **开盘**对应给定周期的起始值。
+ **高点**对应给定周期的最高值。
+ **低点**对应给定周期的最低值。
+ **收盘**对应给定周期的最终（结束）值。
+ **成交量**对应给定周期内的样本数（例如交易次数）

**注意**  
K 线图例不显示这些值。

要正确映射这些维度，数据中的查询结果表必须*至少*包含以下列。
+ `timestamp`
+ `open`
+ `high`
+ `low`
+ `close`

如果由于某种原因（例如，因为列名称不同），您的数据无法映射到这些维度，您可以使用面板编辑器中 **K 线图**选项下的**开盘值**、**高点值**、**低点值**和**收盘值**字段手动映射。

## 其他字段
<a name="v10-panels-candlestick-other"></a>

**其他字段**

K 线面板基于时间序列可视化。除了开盘值、高点值、低点值、收盘值和交易量之外，还可以可视化其他数据维度。**Include** 和 **Ignore** 选项允许面板使用 [时间序列](v10-panels-time-series.md) 中可用的相同样式和配置来可视化其他包含的数据，如简单移动平均线、布林线等。

# Canvas
<a name="v10-panels-canvas"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

画布将 Grafana 的强大功能与自定义元素的灵活性相结合。画布是可扩展的表单构建面板，允许在静态和动态布局中显式放置元素。这使您能够以标准 Grafana 面板无法实现的方式设计自定义可视化和叠加数据，所有这些都在 Grafana 的 UI 中完成。如果您使用过流行的 UI 和 Web 设计工具，那么设计画布面板会感觉非常熟悉。

## 元素
<a name="v10-panels-canvas-elements"></a>

您可以在画布上添加这些元素。通过添加多种不同类型的元素，您可以以任何其他可视化无法实现的方式自定义可视化。

**指标值**

指标值元素让您可以轻松选择要在画布上显示的数据。此元素具有独特的*编辑*模式，可通过上下文菜单**编辑**选项或双击面板来触发。在编辑模式下，您可以选择要显示的字段数据。

**文本**

文本元素使您能够轻松地向画布添加文本。该元素还支持编辑模式，可通过双击或上下文菜单中的编辑菜单选项触发。

**椭圆**

椭圆元素允许您在画布上添加一个基本的椭圆。椭圆元素可以显示文本（固定数据和字段数据），其背景颜色可以根据数据阈值进行更改。

**矩形**

通过矩形元素，您可以在画布上添加基本的矩形。矩形元素可以显示文本（固定数据和字段数据），其背景颜色可以根据数据阈值进行更改。

**图标**

通过图标元素，您可以将支持的图标添加到画布。可根据阈值或值映射来设置图标的颜色。

**服务器**

服务器元素让您可以轻松表示单个服务器、服务器堆栈、数据库或终端。服务器元素支持状态颜色、灯泡颜色和灯泡闪烁率，所有这些都可通过固定值或字段值来配置。

**Button**

您可以通过按钮元素在画布上添加基本按钮。按钮元素支持触发未经验证的基本 API 调用。API 设置可在按钮元素编辑器中找到。您也可以在 API 编辑器中传递模板变量。

**注意**  
只有在禁用内联编辑时，选择按钮才会触发 API 调用。请参阅[画布编辑](#v10-panels-canvas-editing)。

## Connections
<a name="v10-panels-canvas-connections"></a>

在构建画布时，您可以将元素连接在一起，以创建更复杂的可视化效果。您可以通过从一个元素的连接锚点拖动到另一个元素的连接锚点，来创建连接。您也可以创建与画布背景的连接。当您将鼠标悬停在元素上并打开内联编辑时，会显示连接锚点。要删除连接，请选择该连接，然后按 `Delete` 或 `Backspace`。

您可以根据固定值或字段值设置连接的大小和颜色。为此，请进入面板编辑模式，选择连接，然后在面板编辑器中修改连接的属性。

## 画布编辑
<a name="v10-panels-canvas-editing"></a>

**内联编辑器**

您可以在控制面板模式的上下文中内联编辑画布。

**平移和缩放**

您可以在画布上打开平移和缩放功能。这让您可以创建和浏览更复杂的设计。

**注意**  
Grafana Labs 目前提供平移和缩放预览版。支持有限，并且在正式发布之前可能会发生重大更改。

**上下文菜单**

通过上下文菜单，您可以快速高效地执行常见任务。支持的功能包括打开和关闭内联编辑器、复制元素、删除元素等。

右键单击面板（或等效操作）或给定画布元素会触发上下文菜单。

右键单击*面板*时，您可以设置背景图像，轻松地向画布添加元素。

右键单击*元素*时，您可以编辑、删除和复制该元素，或者修改元素的图层位置。

## 画布选项
<a name="v10-panels-canvas-options"></a>

**内联编辑**

内联编辑开关让您可以锁定或解锁画布面板。关闭后，画布面板将处于*锁定*状态，将元素冻结在原位并防止意外修改。

**数据链接**

画布支持[数据链接](v10-panels-configure-data-links.md)。您可以按照以下步骤为指标值元素创建数据链接，并在使用该字段名称的所有元素中显示。

**为元素创建数据链接**

1. 设置要绑定到字段值的元素。

1. 关闭内联编辑开关。

1. 为**带有名称的字段**创建覆盖，然后从列表中选择元素字段名称。

1. 选择 **\$1 添加覆盖属性**按钮。

1. 从列表中选择**数据链接 > 数据链接**。

1. 选择 **\$1 添加链接**，为数据链接添加标题和 URL。

1. 将鼠标悬停在元素上可显示数据链接工具提示。

1. 选择能够打开数据链接的元素。

如果多个元素使用相同的字段名称，而您又想控制哪些元素显示数据链接，可使用 [从计算添加字段](v10-panels-xform-functions.md#v10-panels-xform-funcs-add) 转换创建唯一字段名称。您在转换中创建的别名将显示为可与元素一起使用的字段。

# 控制面板列表
<a name="v10-panels-dashboard-list"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

控制面板列表可展示指向其他控制面板的动态链接。可将该列表配置为使用已加星标的控制面板、最近查看的控制面板、搜索查询和控制面板标签。

每次加载仪表板时，此面板都会查询仪表板列表，始终提供最多的 up-to-date结果。

**Options**

使用以下选项来优化可视化效果。
+ **包括当前时间范围**：选择此选项可将当前控制面板的时间范围传播到控制面板链接。当用户选择链接时，链接的控制面板将会打开，并显示已设置的指示时间范围。
+ **包括当前模板变量值**：选择此选项可在链接中包含当前用作查询参数的模板变量。当用户选择链接时，链接的控制面板中的任何匹配模板都将设置为列表中的值。有关更多信息，请参阅 [控制面板 URL 变量](v10-dash-dashboard-url-variables.md)。
+ **已加星标**：按字母顺序显示已加星标的控制面板。
+ **最近查看**：按字母顺序显示最近查看的控制面板。
+ **搜索**：按搜索查询或标签显示控制面板。您必须在**查询**或**标签**中至少输入一个值。对于**查询**和**标签**字段，支持变量插值，例如，`$my_var` 或 `${my_var}`。
+ **显示标题**：所选列表选择（已加星标、最近查看、搜索）显示为标题。
+ **最大项数**：设置每个部分列出的最大项数。例如，如果您保留默认值 10，并显示已加星标和最近查看的控制面板，则该面板将最多显示 20 个控制面板，每个部分有 10 个。

**搜索**

仅当选择**搜索**选项时，这些选项才适用。
+ **查询**：输入您要搜索的查询。查询不区分大小写，并接受部分值。
+ **文件夹**：选择要显示的控制面板文件夹。
+ **标签**：您可以在此输入要搜索的标签。现有标签不会在您键入时显示，*并且*区分大小写。

**注意**  
当出现多个标签和字符串时，控制面板列表将显示符合*所有*条件的标签和字符串。

# 数据网格
<a name="v10-panels-datagrid"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

**注意**  
Grafana Labs 目前提供数据网格可视化预览版。支持有限，并且在正式发布之前可能会发生重大更改。

数据网格可让您在 Grafana 中创建、编辑和微调数据。因此，该面板可充当控制面板内其他面板的数据来源。

![\[显示 Grafana 中数据网格可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/datagrid-panel-example.png)


通过此可视化，您可以操作从任何数据来源查询的数据，可以从空白面板开始，也可以从拖放的文件中提取数据。然后，您可以将面板用作简单的表格可视化，也可以修改数据，甚至将其完全删除，创建空白面板。

编辑数据集会将数据来源更改为使用内置的 **Grafana** 数据来源，替换旧的数据来源设置和相关查询，同时还会将当前数据集复制到控制面板模型中。

然后，您可以使用内置的**控制面板**数据来源提取数据网格数据，将面板用作其他面板的数据来源。这提供了交互式控制面板体验，您可以在其中修改数据并查看反映在其他面板中的更改。

有关 **Grafana** 和**控制面板**数据来源的更多信息，请参阅 [特殊数据来源](AMG-data-sources.md#AMG-data-sources-special)。

## 上下文菜单
<a name="v10-panels-datagrid-context"></a>

为了提供更简化的体验，数据网格有一个上下文菜单，可通过右键单击单元格、列标题或行选择器来访问该菜单。根据数据网格的状态，上下文菜单提供了不同的选项，其中包括以下选项。
+ 删除或清除所有行和列。
+ 删除所有现有数据（将数据网格渲染为空白）。
+ 触发搜索功能，允许在数据集中查找关键字。

删除行或列将从数据网格中删除数据，而清除行或列只会从单元格中删除数据，行或列保持不变。

**标题菜单**

您也可以选择标题标题旁边的下拉图标来访问标题菜单。在这里，您不仅可以删除或清除列，还可以重命名、冻结或转换列的字段类型。

## 选择序列
<a name="v10-panels-datagrid-selectseries"></a>

如果有多个序列，您可以使用面板选项中的**选择序列**下拉列表将数据网格设置为显示首选数据集。

## 使用数据网格
<a name="v10-panels-datagrid-using"></a>

数据网格提供了多种与数据交互的方式。您可以编辑、移动、清除和删除行和列；使用内置搜索功能查找特定数据；转换字段类型或冻结特定列的水平滚动。

**添加数据**

您可以通过创建新的列或行向数据网格添加数据。

**添加新列**

1. 在现有面板中，选择表标题中最后一列后面的 **\$1** 按钮。

1. 为新列添加名称。

1. 选择字段外部的任意位置或按 `Enter` 键保存列。

现在，您可以在每个单元格中添加数据。

要添加新行，请选择最后一行后面的 **\$1** 按钮。该按钮位于最后一行之后的每个单元格中，选择该按钮会触发创建新行，同时还会激活您选择的单元格。

**编辑数据**

您可以根据需要移动列和行。

**移动列**

1. 按住需要移动的列的标题。

1. 将列拖到所需位置。

1. 释放列以完成移动。

要移动行，请从位于网格最左侧的数字列中选择并按住行选择器，然后将其拖动到所需位置。释放行以完成移动。

**选择多个单元格**

您可以选择多个单元格，方法是选择单个单元格，然后拖动到其他单元格。此选择可用于从选定单元格中复制数据或使用 `Delete` 键将其删除。

**删除或清除多行或多列**

要删除或清除多行，可执行以下操作。

**删除或清除多行或多列**

1. 将鼠标悬停在数字列（网格中第一列的左侧）上可显示行复选框。

1. 选中要使用的行的复选框。要选择多个连续行，请按住 `Shift` 键，同时单击第一行和最后一行。要选择不连续的行，请按住 `Ctrl`（或 `Cmd`）键，同时单击所需的行。

1. 右键单击（或等效操作）以访问上下文菜单。

1. 选择**删除行**或**清除行**。

单击列标题，同样的规则也适用于列。

要删除所有行，请使用数据网格左上角的**全选**复选框。这将选择所有行，并允许使用上下文菜单将其删除。

# 火焰图
<a name="v10-panels-flamegraph"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

火焰图允许可视化分析数据。使用此可视化效果，可以将配置文件表示为火焰图和/或表。

![\[显示 Grafana 中火焰图可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/flamegraph-panel-example.png)


## 火焰图模式
<a name="v10-panels-flamegraph-mode"></a>

火焰图利用了分析数据的层次性。这种图形将数据压缩成一种格式，让您轻松查看哪些代码路径消耗了最多的系统资源，如 CPU 时间、分配的对象或测量内存时的空间。火焰图中的每个块代表堆栈中的一个函数调用，宽度代表其值。

灰色部分是一组表示相对较小的值的函数，出于性能原因，折叠在一起形成一个部分。

您可以将鼠标悬停在特定函数上以查看工具提示，其中显示有关该函数的其他数据，例如函数的值、占总值的百分比以及函数的样本数。

**下拉操作**

您可以单击某个函数，以显示包含其他操作的下拉菜单：
+ **焦点块**：当您选择**焦点块**时，数据块或函数将设置为火焰图宽度的 100%，并且所有子函数都会显示，其宽度相对于父函数的宽度更新。这使得更容易向下钻取到火焰图的较小部分。
+ **复制函数名称**：当您选择**复制函数名称**时，将复制该块所代表的函数的全名。
+ **三明治视图**：三明治视图允许显示点击函数的上下文。该视图在顶部显示函数的所有调用放，在底部显示所有被调用方。这显示了函数的聚合上下文，因此如果该函数存在于火焰图中的多个位置，则所有上下文都显示并聚合在三明治视图中。

**状态栏**

 状态栏显示有关火焰图和当前应用修改的元数据，例如图形的哪个部分处于焦点或三明治视图中显示什么函数。单击状态栏中的 **X** 以删除修改。

## 工具栏
<a name="v10-panels-flamegraph-toolbar"></a>

**搜索**

您可以使用搜索字段查找具有特定名称的函数。火焰图中与搜索匹配的所有函数都将保持彩色，而其余函数将灰显。

**颜色方案选取器**

您可以根据函数的值或软件包名称切换着色函数，以便直观地将同一软件包中的函数联系在一起。

**文本对齐**

将文本向左或向右对齐，以便在函数名称不适合块时显示函数名称中更重要的部分。

**可视化选取器**

您可以选择仅显示火焰图和/或仅显示表。

## 顶部表模式
<a name="v10-panels-flamegraph-toptablemode"></a>

顶部表以表格式显示了配置文件中的函数。该表有三列：符号、自身和总计。默认情况下，该表按自身时间排序，但也可以通过单击列标题按总时间或符号名称重新排序。如果给定函数出现在配置文件中的多个位置，则每行表示该函数的聚合值。

每行左侧还有操作按钮。第一个按钮搜索函数名称，第二个按钮显示函数的三明治视图。

## 数据 API
<a name="v10-panels-flamegraph-dataapi"></a>

为了渲染火焰图，必须使用[嵌套集模型](https://wikipedia.org/wiki/Nested_set_model)格式化数据帧数据。

嵌套集模型可确保火焰图中的每个项目仅通过其嵌套级别作为整数值、元数据及其在数据帧中的顺序编码。这意味着项目的顺序很重要，必须正确。排序是对火焰图中项目的深度优先遍历，可重新创建图形，而无需像在子数组中那样在数据帧中使用可变长度值。

必填字段：


| 字段名称 | Type | 说明 | 
| --- | --- | --- | 
| level | 数字 | 项目的嵌套级别。换句话说，这个项目和火焰图的顶部项目之间有多少项目。 | 
| 值 | 数字 | 项目的绝对值或累积值。这相当于图形中项目的宽度。 | 
| label | 字符串 | 为特定项目显示的标签。 | 
| self | 数字 | 自身值，通常是项目的累积值减去其直接子项目的累积值之和。 | 

# 计量表
<a name="v10-panels-gauge"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

仪表是单值可视化，可为每个序列、列或行重复仪表。

![\[显示 Grafana 中仪表可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/gauge_example.png)


## 值选项
<a name="v10-panels-gauge-value"></a>

使用以下选项来优化可视化显示值的方式：

**Show (显式)**

选择 Grafana 显示数据的方式。

*计算*

显示基于所有行的计算值。
+ **计算**：选择一个 reducer 函数，Grafana 将使用该函数将多个字段归约为单个值。有关可用计算的列表，请参阅 [计算类型](v10-panels-calculation-types.md)。
+ **字段**：选择面板中显示的字段。

*所有值*

为每行显示一个单独的统计数据。如果选择此选项，则还可以限制要显示的行数。
+ **限制**：要显示的最大行数。默认为 5000。
+ **字段**：选择面板中显示的字段。

## 计量表
<a name="v10-panels-gauge-gauge"></a>

调整仪表的显示方式。

**方向**

选择堆叠方向。
+ **自动**：仪表按行和列显示。
+ **水平**：仪表从上到下显示。
+ **垂直**：仪表从左到右显示。

**显示阈值标签**

控制是否显示阈值。

**显示阈值标记**

控制是否在内部仪表值范围之外显示阈值范围。

**仪表尺寸**

选择仪表尺寸模式
+ **自动**：Grafana 决定最佳仪表尺寸。
+ **手动**：手动配置仪表尺寸。

**最小宽度**

设置垂直方向仪表的最小宽度。

如果设置了最小宽度，当数据量较大时，会自动显示 x 轴滚动条。

**注意**  
此选项仅在仪表尺寸设置为手动时适用。

**最小高度**

设置水平方向仪表的最小高度。

如果设置了最小高度，当数据量较大时，会自动显示 y 轴滚动条。

**注意**  
此选项仅在仪表尺寸设置为手动时适用。

**中性**

设置填充每个仪表的起始值。

## 文本大小
<a name="v10-panels-gauge-textsize"></a>

调整仪表文本的大小。
+ **标题**：输入仪表标题大小的数值。
+ **值**：输入仪表值大小的数值。

# Geomap
<a name="v10-panels-geomap"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

Geomap 让您可以使用地理空间数据，查看和自定义世界地图。通过配置各种叠加样式和地图视图设置，您可以轻松聚焦于数据中基于位置的重要特征。

**注意**  
您可以在提供的底图图层之上添加自己的地理空间数据。 AWS底图图层必须全部来自。[https://tiles.maps.search-services.aws.a2z.com](https://tiles.maps.search-services.aws.a2z.com)

![\[显示 Grafana 中 geomap 可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-panel-example.png)


## 地图视图
<a name="v10-panels-geomap-view"></a>

地图视图控制控制面板加载时地图的初始视图。

**初始视图**

初始视图配置首次加载 GeoMap 面板时面板的呈现方式。
+ **视图**设置面板首次加载时地图的中心。
  + **适应数据**根据地图图层的数据范围适应地图视图，并在数据发生变化时更新。
    + **数据**选项允许根据*所有图层*、单个*图层*或所选图层的*最后一个值*来选择范围。
    + 如果适应来自单个*图层*或图层*最后一个值*的数据，则可以选择**图层**。
    + **填充**以超出数据范围的相对百分比设置填充（仅在查看*最后一个值*时不可用）。
    + **最大缩放**设置适应数据时的最大缩放级别。
  + **坐标**根据以下因素设置地图视图：
    + **纬度**
    + **经度**
  + 还提供了默认视图，包括：
    + **（0°, 0°）**
    + **北美洲**
    + **南美洲**
    + **欧洲**
    + **非洲**
    + **西亚**
    + **南亚**
    + **东南亚**
    + **东亚**
    + **澳大利亚**
    + **大洋洲**
+ **缩放**设置初始缩放级别。

## 地图图层
<a name="v10-panels-geomap-layers"></a>

Geomap 支持显示多个图层。每个图层决定了如何基于基础地图，实现地理空间数据的可视化。

**类型**

Geomap 可视化中有三种地图层类型可供选择。
+ [标记图层](#v10-panels-geomap-markers) 在每个数据点渲染一个标记。
+ [热图图层](#v10-panels-geomap-heatmap) 可视化数据的热图。
+ [GeoJSON 图层](#v10-panels-geomap-geojson) 渲染 GeoJSON 文件中的静态数据。
+ [夜间/白天图层（Alpha）](#v10-panels-geomap-nightday) 渲染夜间或白天区域。
+ [路由图层（预览）](#v10-panels-geomap-route) 将数据点渲染为路径。
+ [照片图层（预览）](#v10-panels-geomap-photos) 在每个数据点渲染一张照片。
+ [网络图层（预览）](#v10-panels-geomap-network) 根据数据可视化网络图。

还有两种实验性（或 alpha）图层类型。
+ **最后一个点的图标（alpha）**在最后一个数据点渲染一个图标。
+ **动态 GeoJSON（alpha）**根据查询结果设置 GeoJSON 文件的样式。

**注意**  
在公共预览中标记为*预览*或 *alpha* 的图层。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

**图层控件**

图层控件允许您创建图层、更改图层名称、重新排序和删除图层。
+ **添加图层**可为 geomap 创建附加的可配置数据图层。添加图层时，系统会提示您选择图层类型。在面板配置过程中，您可以随时更改图层类型。
+ 通过图层控件，您可以重命名、删除和重新排序面板上的图层。
  + **编辑图层名称**（铅笔图标）可重命名图层。
  + **垃圾桶**可删除图层。
  + **重新排序**（六个 dots/grab 手柄）允许您更改图层顺序。较高图层的数据将显示在较低图层的数据之上。拖放时，可视化将更新图层顺序，以帮助简化图层顺序的选择。

您可以向单个 geomap 面板添加多层数据，以创建丰富、详细的可视化效果。

**位置**

Geomap 需要一个地理数据来源。这些数据来自数据库查询，数据有四种映射选项。
+ **自动**可自动搜索位置数据。当您的查询基于以下数据字段名称之一时，请使用此选项。
  + *地理哈希*：`geohash`
  + *纬度*：`latitude`、`lat`
  + *经度*：`longitude`、`lng`、`lon`
  + *查找*：`lookup`
+ **坐标**指定查询包含坐标数据。系统会提示您从数据库查询中选择纬度和经度的数值数据字段。
+ **地理哈希**指定您的查询包含地理哈希数据。系统会提示您从数据库查询中为地理哈希选择字符串数据字段。
+ **查找**指定查询包含需要映射为地理位置的名称数据。系统将提示您从数据库查询和地名录中选择查找字段。地名录是用于将查询到的数据映射到地理点的目录。

## 标记图层
<a name="v10-panels-geomap-markers"></a>

标记图层允许您将数据点显示为不同的标记形状，如圆形、方形、三角形、星形等。

标记有许多自定义选项。
+ **大小**可配置标记的大小。默认值为 `Fixed size`，无论数据如何，所有标记的大小都相同；但还有一个选项可以根据与所选字段对应的数据来调整标记的大小。必须设置 `Min` 和 `Max` 标记大小，以便标记图层可以在此范围内缩放。
+ **符号**允许您选择符号、图标或图形，以帮助为数据提供额外的可视化上下文。从 Grafana 中包含的资源中选择，例如简单符号或 Unicon 库。您也可以指定包含图像资源的 URL。图像必须是可缩放向量图形（SVG）。
+ **符号垂直对齐**可配置符号相对于数据点的垂直对齐方式。请注意，首先围绕数据点应用符号的旋转角度，然后相对于符号的旋转应用垂直对齐。
+ **符号水平对齐**可配置符号相对于数据点的水平对齐方式。请注意，首先围绕数据点应用符号的旋转角度，然后相对于符号的旋转应用水平对齐。
+ **颜色**可配置标记的颜色。默认 `Fixed color` 将所有标记设置为特定颜色。还可以根据选定的字段数据点值和**标准选项**部分设置的颜色方案来设置条件颜色。
+ **填充不透明度**可配置每个标记的透明度。
+ **旋转角度**可配置每个标记的旋转角度。默认为**固定值**，这将使所有标记旋转到相同的角度，无论数据如何；但还有一个选项可以根据与所选字段对应的数据来设置标记的旋转。
+ **文本标签**可为每个标记配置文本标签。
+ **显示图例**允许切换图层的图例。
+ **显示工具提示**允许切换图层的工具提示。

## 热图图层
<a name="v10-panels-geomap-heatmap"></a>

热图图层将各种数据点聚类，以直观显示不同密度的位置。

![\[显示在 Grafana 中使用 geomap 可视化热图示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-heatmap-example.png)


添加热图图层：

选择数据图层下的下拉菜单并选择 `Heatmap`。

与 `Markers` 类似，系统会提示您使用各种选项来确定要可视化的数据点以及可视化的方式。
+ **权重值**用于配置热图集群的强度。**固定值**使所有数据点的权重值保持恒定。该值范围应为 0-1。与标记类似，下拉列表中还有一个备选选项，可以根据数据值自动缩放权重值。
+ **半径**用于配置热图集群的大小。
+ **模糊**用于配置每个集群的模糊程度。
+ **不透明度**可配置每个集群的不透明度。
+ **显示工具提示**允许切换图层的工具提示。

## GeoJSON 图层
<a name="v10-panels-geomap-geojson"></a>

通过 GeoJSON 图层，可从文件系统中选择并加载静态 GeoJSON 文件。
+ **GeoJSON URL** 提供了 Grafana 附带的 GeoJSON 文件供您选择。
+ **默认样式**控制当上述规则不匹配时要应用的样式。
  + **颜色**可配置默认样式的颜色
  + **不透明度**可配置默认的不透明度
+ **样式规则**根据特征属性应用样式
  + **规则**允许您从 GeoJSON 文件中选择*特征*、*条件*和*值*来定义规则。垃圾桶图标可用于删除当前规则。
  + **颜色**可为当前规则配置样式的颜色
  + **不透明度**可配置当前规则的透明度级别。
+ **添加样式规则**可创建其他样式规则。
+ **显示工具提示**允许切换图层的工具提示。

## 夜间/白天图层（Alpha）
<a name="v10-panels-geomap-nightday"></a>

夜间/白天图层根据当前时间范围显示夜间和白天区域。

![\[显示在 Grafana 中使用 geomap 可视化夜间/白天图层示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-day-night-example.png)


**Options**
+ **显示**从面板时间范围切换时间来源。
+ **夜间区域颜色**选择夜间区域的颜色。
+ **显示太阳**切换太阳图标。
+ **不透明度**从 0（透明）到 1（不透明）。
+ **显示工具提示**允许切换图层的工具提示。

**注意**  
有关更多信息，请参阅 [ OpenLayers -的扩展 DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)。

## 路由图层（预览）
<a name="v10-panels-geomap-route"></a>

路由图层将数据点渲染为路径。

**注意**  
路径图层当前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

![\[显示在 Grafana 中使用 geomap 可视化路由图层示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-route-layer-example.png)


**Options**
+ **大小**设置路由粗细。默认为固定值。选择字段数据后，您可以设置字段数据可以缩放的最小值和最大值范围。
+ **颜色**设置路由颜色。默认设置为固定颜色，也可以将颜色与字段数据绑定。
+ **填充不透明度**可配置路由的不透明度。
+ **文本标签**可为每个路由配置文本标签。
+ **箭头**可配置箭头样式，使其按数据顺序沿路由显示。
  + **无**
  + **正向**
  + **反向**
+ **显示工具提示**允许切换图层的工具提示。

**注意**  
有关更多信息，请参阅 [ OpenLayers -流线样式的扩展](http://viglino.github.io/ol-ext/examples/style/map.style.gpxline.html)。

## 照片图层（预览）
<a name="v10-panels-geomap-photos"></a>

照片图层在每个数据点渲染一张照片。

**注意**  
照片图层当前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

**Options**
+ **图像来源字段**允许选择一个字符串字段，其中包含 Base64 编码的二进制图像数据（`data:image/png;base64,...`）。
+ **类型**可设置图像周围的框架样式。从中选择：
  + **Square**
  + **Circle**
  + **锚定**
  + **对开**
+ **裁剪**切换（裁剪图像以适合尺寸）。
+ **阴影**切换图像背后的方框阴影。
+ **边框**设置图像周围的边框大小。
+ **边框颜色**设置图像周围的边框颜色。
+ **半径**设置图像的整体大小（像素）。
+ **显示工具提示**允许切换图层的工具提示。

**注意**  
有关更多信息，请参阅 [ OpenLayers -图像照片样式的扩展程序](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)。

## 网络图层（预览）
<a name="v10-panels-geomap-network"></a>

网络图层渲染网络图。该图层支持节点图可视化所支持的相同数据格式，并在节点数据中添加了地理空间数据。地理空间数据用于在地图上定位和渲染节点。

**注意**  
网络图层当前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

![\[显示 Grafana 中 geomap 网络可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-network-layer-example.png)


**注意**  
网络图层当前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

**Options**
+ **箭头**设置每条边的箭头显示方向，向前表示从来源到目标。从中选择：
  + **无**
  + **正向**
  + **反向**
  + **二者**
+ **显示图例**允许切换图层的图例。图例仅支持节点数据。
+ **显示工具提示**允许切换图层的工具提示。

**节点样式**
+ **大小**可配置节点的大小。默认为**固定大小**，这将使所有节点大小相同，无论数据如何；但还有一个选项可以根据与所选字段对应的数据来调整节点大小。必须设置**最小**和**最大**节点大小，以便节点可以在此范围内缩放。
+ **颜色**可配置节点的颜色。默认为**固定颜色**，将所有节点设置为特定颜色。还可以根据选定的字段数据点值和**标准选项**部分设置的颜色方案来设置条件颜色。
+ **符号**允许您选择符号、图标或图形，以帮助为数据提供额外的可视化上下文。从 Grafana 中包含的资源中选择，例如简单符号或 Unicon 库。您也可以指定包含图像资源的 URL。图像必须是可缩放向量图形（SVG）。
+ **填充不透明度**可配置每个节点的透明度。
+ **旋转角度**可配置每个节点的旋转角度。默认为**固定值**，这将使所有节点旋转到相同的角度，无论数据如何；但还有一个选项可以根据与所选字段对应的数据来设置节点的旋转。
+ **文本标签**可为每个节点配置文本标签。

**边样式**
+ **大小**可配置边的线宽。默认为**固定大小**，这将使所有边线宽度相同，无论数据如何；但还有一个选项可以根据与所选字段对应的数据来调整边的大小。必须设置**最小**和**最大**边大小，以使边可以在此范围内缩放。
+ **颜色**可配置边的颜色。默认为**固定颜色**，将所有边设置为特定颜色。还可以根据选定的字段数据点值和**标准选项**部分设置的颜色方案来设置条件颜色。
+ **填充不透明度**可配置每个边的透明度。
+ **文本标签**可为每个边配置文本标签。

## CARTO 图层
<a name="v10-panels-geomap-carto"></a>

Amazon Managed Grafana 不支持 CARTO 图层。

## XYZ 切片图层
<a name="v10-panels-geomap-xyz"></a>

Amazon Managed Grafana 不支持 XYZ 切片图层。

## Open Street Map 图层
<a name="v10-panels-geomap-osm"></a>

Amazon Managed Grafana 不支持 Open Street Map 图层（默认的基础地图除外）。

## ArcGIS 图层
<a name="v10-panels-geomap-arcgis"></a>

Amazon Managed Grafana 不支持 ArcGIS 图层。

## 地图控件
<a name="v10-panels-geomap-controls"></a>

地图控件部分包含各种地图信息和工具叠加选项。

**Zoom**

缩放控件选项。

*显示缩放控件*

在左上角显示缩放控件。

*鼠标滚轮缩放*

使用鼠标滚轮进行放大或缩小来打开或关闭。

**显示属性**

显示地图上底图图层的属性。

**显示刻度**

在左下角显示刻度信息。

**注意**  
以 [m]/[km] 为单位显示。

**显示测量工具**

在右上角显示测量工具。仅当此控件打开时，才会显示测量值。
+ **单击**开始测量
+ **继续单击**继续测量
+ **双击**结束测量

**注意**  
更改测量类型或单位后，先前的测量值将从地图上删除。  
如果控件关闭后又重新打开，则会显示最新的测量值。  
单击并拖动测量值可以对其进行修改。

*长度*

获取几何形状的球面长度。该长度是坐标之间的大圆距离之和。对于多部分几何形状，长度是每个部分的长度之和。假设几何形状位于“EPSG:3857”中。

您可以选择以下长度测量单位：
+ **公制（m/km）**
+ **英尺（ft）**
+ **英里（mi）**
+ **海里（nmi）**

*领域*

获取几何形状的球面面积。计算此面积时，假设多边形的边是球体上大圆的线段。假设几何形状位于“EPSG:3857”中。

您可以选择以下面积测量单位：
+ **平方米（m²）**
+ **平方千米（km²）**
+ **平方英尺（ft²）**
+ **平方英里（mi²）**
+ **英亩（acre）**
+ **公顷（ha）**

**显示调试**

在地图右上角显示调试信息。这对于调试或验证数据来源很有用。
+ **缩放**显示地图的当前缩放级别。
+ **中心**显示地图中心的当前**经度**和**纬度**。

**Tooltip**
+ **无**仅当单击数据点时才显示工具提示。
+ **详细信息**当指针悬停在数据点上时显示工具提示。

# 热图
<a name="v10-panels-heatmap"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

通过热图面板可视化，您可以查看随时间变化的直方图。有关直方图的更多信息，请参阅 [直方图和热图简介](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)。

![\[显示 Grafana 中热图可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## 根据数据计算
<a name="v10-panels-heatmap-calculate"></a>

此设置决定数据是已计算的热图（来自数据来源/转换器），还是在面板中计算的热图。

**X 桶**

此设置决定如何将 X 轴拆分为桶。可在**大小**输入中指定时间间隔。例如，时间范围为 `1h` 会使 X 轴上的单元格宽度为 1 小时。

**Y 桶**

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

**Y 桶刻度**

从以下 Y 轴值刻度中选择一个：
+ **线性**：线性刻度。
+ **log（底数 2）**：底数为 2 的对数刻度。
+ **log（底数 10）**：底数为 10 的对数刻度。
+ **symlog**：symlog 刻度。

## Y 轴
<a name="v10-panels-heatmap-y-axes"></a>

定义 Y 轴的显示方式

**放置**
+ **左**：在左侧
+ **右**：在右侧
+ **隐藏**：隐藏

**单位**

单位配置

**小数**

此设置决定十进制配置。

**最小/最大值**

此设置配置轴范围。

**反向**

选中后，轴将按相反顺序显示。

**显示多个 y 轴**

在某些情况下，您可能希望显示多个 Y 轴。例如，如果您有一个数据集，显示一段时间内的温度和湿度，则可能需要为这两个序列显示两个具有不同单位的 y 轴。

您可以通过[添加字段覆盖](v10-panels-configure-overrides.md)来实现这一点。根据需要多次执行这些步骤，以添加任意数量的 y 轴。

## 颜色
<a name="v10-panels-heatmap-colors"></a>

色谱控制值计数（在每个桶中）和分配给每个桶的颜色之间的映射。色谱上最左侧的颜色表示最小计数，最右侧的颜色表示最大计数。使用浅色主题时，某些颜色方案会自动反转。

您也可以将颜色模式更改为“不透明度”。在这种情况下，颜色不会改变，但不透明度会随桶数的变化而变化
+ **Mode (模式)**
  + **方案**：用单元格颜色表示的桶值。
    + **方案**：如果模式为**方案**，则选择颜色方案。
  + **不透明度**：由单元格不透明度表示的桶值。不透明单元格表示最大值。
    + **颜色**：单元格基色。
    + **刻度**：将桶值映射到不透明度的刻度。
      + **线性**：线性刻度。桶值以线性方式映射到不透明度。
      + **sqrt**：幂刻度。以 `value ^ k` 计算的单元格不透明度，其中 `k` 是配置的**指数**值。如果指数小于 `1`，则会得到一个对数刻度。如果指数大于 `1`，则会得到一个指数刻度。如果是 `1`，则刻度将与线性相同。
    + **指数**：指数值，大于 `0`。

**从值开始/结束颜色**

默认情况下，Grafana 根据最小和最大桶值计算单元格颜色。可使用最小值和最大值覆盖这些值。将桶值视为 Z 轴，将最小值和最大值分别视为 Z-Min 和 Z-Max。
+ **开始**：用于单元格颜色计算的最小值。如果桶值小于最小值，则将其映射到“最小”颜色。序列最小值为默认值。
+ **结束**：用于单元格颜色计算的最大值。如果桶值大于最大值，则将其映射到“最大”颜色。序列最大值为默认值。

## 单元格显示
<a name="v10-panels-heatmap-cell"></a>

使用这些设置来改进可视化结果。

## 其他显示选项
<a name="v10-panels-heatmap-options"></a>

**Tooltip**
+ **显示工具提示**：显示热图工具提示。
+ **显示直方图**：在工具提示上显示 Y 轴直方图。直方图表示特定时间戳的桶值的分布。
+ **显示色阶**：在工具提示上显示色阶。色阶表示桶值和颜色之间的映射。

**图例**

选择是否要在可视化上显示热图图例。

**样本**

设置用于显示样本数据的颜色。

# 直方图
<a name="v10-panels-histogram"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

直方图可视化计算值的分布并将其显示为条形图。Y 轴和每个条形的高度代表落入每个括号中的值的数量，而 X 轴代表值范围。

![\[显示 Grafana 中直方图可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/histogram-example.png)


## 支持的格式
<a name="v10-panels-histogram-formats"></a>

直方图可视化支持时间序列和任何带有一个或多个数值字段的表结果。

## 显示选项
<a name="v10-panels-histogram-options"></a>

使用以下选项来优化可视化效果。

**桶大小**

桶的大小。将此字段留空，以自动调整桶大小（约为全量程的 10%）。

**桶偏移**

第一个桶不应该从零开始。非零偏移会移动聚合窗口。例如，大小为 5（0–5、5–10、10–15）且默认偏移量为 0 的桶将变为 2–7、7–12、12–17，偏移量为 2；在这种情况下，0、5 或 10 的偏移量实际上没有任何作用。通常，此选项将与明确定义的桶大小一起使用，而不是与自动桶大小一起使用。要使此设置生效，偏移量应大于 0 且小于桶大小；超出此范围的值将与该范围内的值具有相同的效果。

**组合序列**

这会将所有序列和字段合并为一个组合的直方图。

**线宽**

控制条形图的线宽。

**填充不透明度**

控制条形图的填充不透明度。

**渐变模式**

设置渐变填充的模式。填充渐变基于线条颜色。要更改颜色，请使用标准颜色方案字段选项。渐变外观受**填充不透明度**设置的影响。
+  **无**：无渐变填充，这是默认设置。
+  **不透明度**：渐变的透明度是根据 Y 轴上的值计算的。填充的不透明度随 Y 轴上的值增加而增加。
+  **色调**：渐变色是根据线条颜色的色调生成的。

## 图例选项
<a name="v10-panels-histogram-legend"></a>

启用图例选项后，可以显示值映射或阈值括号。要在图例中显示值映射，请务必将标准选项下的“颜色方案”选项设置为“单色”或“经典”调色板。要查看图例中的阈值括号，请将“颜色方案”设置为“来自阈值”。有关图例的更多信息，请参阅[配置图例](v10-panels-configure-legend.md)。

**图例模式**

使用这些设置可定义图例在可视化中的显示方式。
+  **列表**：以列表形式显示图例。这是图例的默认显示模式。
+  **表**：以表的形式显示图例。
+  **隐藏**：隐藏图例。

**图例放置**

选择放置图例的位置。
+  **底部**：显示在图形下方。
+  **右**：显示在图形右侧。

**图例值**

选择要在图例中显示的标准计算。可以输入多个值。有关更多信息，请参阅 [计算类型](v10-panels-calculation-types.md)。

**图例计算**

选择要在图例中显示的计算。可以选择多个值。

# 日志
<a name="v10-panels-logs"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

日志面板可视化显示来自支持日志的数据来源（例如 Elastic、Influx 和 Loki）的日志行。通常，您可以使用图形面板旁边的此面板来显示相关进程的日志输出。

日志面板显示在**查询**选项卡上输入的查询结果。多个查询的结果按时间合并和排序。如果数据来源返回的行数超过了可以显示的行数，则可以在面板内滚动。

要限制渲染的行数，可以使用**查询选项**中的**最大数据点**设置。如果未设置，则数据来源通常会强制使用默认限制。

## 日志级别
<a name="v10-panels-logs-level"></a>

对于指定了**级别**标签的日志，我们会使用标签值来确定日志级别，并相应地更新颜色。如果日志未指定级别标签，则会尝试查明其内容是否与任何受支持的表达式匹配（有关更多信息，请参阅下文）。日志级别始终由第一个匹配项决定。如果 Grafana 无法确定日志级别，则会使用**未知的**日志级别对其可视化。有关更多信息，请参阅 [日志级别](v10-explore-logs.md#v10-explore-log-level)。

## 日志详细信息
<a name="v10-panels-logs-details"></a>

每个日志行都有一个可扩展区域，其中带有标签和检测到的字段，以实现更可靠的交互。每个字段或标签有一个统计图标，以显示与所有显示的日志相关的统计信息。

**数据链接**

通过数据链接，您可以将日志消息的任何部分转换为内部或外部链接。创建的链接在**日志详细信息**视图的**链接**部分以按钮的形式显示。

**显示选项**

使用以下设置来优化可视化效果：
+ **时间**：显示或隐藏时间列。这是与数据来源报告的日志行关联的时间戳。
+ **唯一标签**：显示或隐藏唯一标签列，该列仅显示非常见标签。
+ **常用标签**：显示或隐藏常用标签
+ **换行**：切换换行符。
+ **Prettify JSON**：将其设置为 `true` 可打印所有 JSON 日志。此设置不会影响 JSON 以外的任何格式的日志。
+ **启用日志详细信息**：切换选项以查看每个日志行的日志详细信息视图。默认设置为 `true`。
+ **顺序**：按时间降序或升序显示结果。默认为**降序**，首先显示最新的日志。设置为**升序**可首先显示最旧的日志行。

# 新闻
<a name="v10-panels-news"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

新闻可视化将显示 RSS 源。默认情况下，其中会显示来自 Grafana Labs 博客的文章，用户可以通过输入不同的 RSS 源 URL 来更改此设置。

在**显示**部分输入 RSS 的 URL。此可视化类型不接受任何其他查询，用户不应预期能够使用此可视化以任何方式处理或查询 RSS 源数据。

**注意**  
RSS 源由 Grafana 前端加载，无需代理。因此，只有配置了相应 [CORS 标头](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)的 RSS 源才会加载。如果尝试显示的 RSS 源无法加载，请考虑重新托管 RSS 源或创建自己的代理。

# 节点图
<a name="v10-panels-node-graph"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

节点图能够可视化定向图形或网络。这些图形使用定向力布局来有效定位节点，有助于显示复杂的基础设施图、层次结构或运行图。

## 数据要求
<a name="v10-panels-node-graph-requirements"></a>

节点图需要数据的特定形状才能显示其节点和边。并非每个数据来源或查询都可以在此图形中可视化。如果您想以数据来源开发人员的身份使用，请参阅有关数据 API 的部分。

节点图由*节点*和*边*组成。
+ *节点*显示为圆形。从应用程序的角度来看，节点可能代表应用程序、服务或其他任何相关的内容。
+ *边*显示为一条连接两个节点的线。连接可能是请求、运算或两个节点之间的某种其他关系。

节点和边都可以具有关联的元数据或统计数据。数据来源定义了显示哪些信息和值，因此不同的数据来源可以显示不同类型的值，也可以不显示某些值。

## Nodes
<a name="v10-panels-node-graph-nodes"></a>

通常，节点在节点内部显示两个统计值，在节点正下方显示两个标识符，通常是名称和类型。节点还可以在节点周围用彩色圆圈显示另一组数值，不同颜色的部分代表不同的数值，这些数值相加应为 1。例如，您可以用圆圈的红色部分表示误差百分比。

其他详细信息可以显示在上下文菜单中，该菜单会在您选择节点时显示。上下文菜单中还可以有其他链接，这些链接可以指向 Grafana 工作区的其他部分或任何外部链接。

**注意**  
节点图只能显示 1500 个节点。如果超过此限制，则右上角会显示一条警告，某些节点会被隐藏。您可以单击图形中的**隐藏节点**标记，展开图形的隐藏部分。

## Edges
<a name="v10-panels-node-graph-edges"></a>

当您将鼠标悬停在边上时，边也可以显示统计数据。与节点类似，您也可以选择边以打开包含其他详细信息和链接的上下文菜单。

支持此可视化的第一个 AWS X-Ray 数据源是其服务地图功能的数据源。有关更多信息，请参阅 [Connect 连接到 AWS X-Ray 数据源](x-ray-data-source.md)。

## 浏览节点图
<a name="v10-panels-node-graph-navigation"></a>

**平移**

通过选择任何节点或边的外部并拖动指针，可以在节点图内平移。

**放大或缩小**

您可以使用节点图左上角的按钮进行缩放，也可以使用鼠标滚轮或其他带有 `Ctrl`（或 `Cmd`）键的滚动输入。

**探索隐藏节点**

为了保持合理的性能，在给定时间显示的节点数量是有限的。超出此限制的节点隐藏在可选择的标记后面，这些标记显示连接到该边的隐藏节点的大致数量。您可以选择标记来围绕该节点展开图形。

**网格视图**

您可以切换到网格视图，以便更好地了解图形中最有趣的节点。网格视图显示网格中没有边的节点，可以按节点内部显示的统计数据或节点的彩色边框表示的统计数据进行排序。

要对节点进行排序，请选择图例中的统计数据。统计数据名称旁边的标记（`˄` 或 `˅`）显示当前用于排序和排序方向的统计数据。

选择节点，然后选择**在图形布局中显示**选项，切换回图形布局，将焦点放在所选节点上，以在整个图形的上下文中显示该节点。

## 数据 API
<a name="v10-panels-node-graph-data-api"></a>

这种可视化需要从数据来源返回特定形状的数据，以便正确显示。

节点图至少需要一个描述图形边缘的数据帧。默认情况下，节点图将根据此数据帧计算节点和任何统计数据。（可选）如果需要显示更多特定于节点的元数据，则可以发送描述节点的第二个数据帧。您必须在两个数据帧上设置 `frame.meta.preferredVisualisationType = 'nodeGraph'`，或将其分别命名为 `nodes` 和 `edges`，这样才能渲染节点图。

**结构中的边数据**

必填字段：


| 字段名称 | Type | 说明 | 
| --- | --- | --- | 
| id | 字符串 | 边的唯一标识符。 | 
| source | 字符串 | 来源节点 ID。 | 
| target | 字符串 | 目标 ID。 | 

可选字段：


| 字段名称 | Type | 说明 | 
| --- | --- | --- | 
| mainstat | 字符串/数字 | 将鼠标悬停在边上方时，第一个统计数据显示在叠加层中。可以是按原样显示值的字符串，也可以是数字。如果是数字，则还会显示与该字段关联的任何单位。 | 
| secondarystat | 字符串/数字 | 与 MainStat 相同，但显示在其正下方。 | 
| detail\$1\$1\$1 | 字符串/数字 | 单击边时，任何前缀为 `detail__` 的字段都将显示在上下文菜单的标题中。将 `config.displayName` 用于更易读的标签。 | 

**结构中的节点数据**

必填字段：


| 字段名称 | Type | 说明 | 
| --- | --- | --- | 
| id | 字符串 | 节点的唯一标识符。边在其来源和目标字段中引用此 ID。 | 

可选字段：


| 字段名称 | Type | 说明 | 
| --- | --- | --- | 
| 删除实例快照 | 字符串 | 节点正下方可见的节点名称。 | 
| subtitle | 字符串 | 标题下显示的附加名称、类型或其他标识符。 | 
| mainstat | 字符串/数字 | 第一个统计数据显示在节点中。可以是按原样显示值的字符串，也可以是数字。如果是数字，则还会显示与该字段关联的任何单位。  | 
| secondarystat | 字符串/数字 | 与 MainStat 相同，但显示在节点中的下方。 | 
| arc\$1\$1\$1 | 数字 | 任何前缀为 `arc__` 的字段都将用于在节点周围创建彩色圆圈。这些字段中的所有值加起来应为 1。您可以使用 `config.color.fixedColor` 指定颜色。 | 
| detail\$1\$1\$1 | 字符串/数字 | 单击节点时，任何前缀为 `detail__` 的字段都将显示在上下文菜单的标题中。将 `config.displayName` 用于更易读的标签。 | 
| color | 字符串/数字 | 可用于指定单一颜色，而不是使用 `arc__` 字段来指定颜色部分。可以是字符串（必须是可接受的 HTML 颜色字符串），也可以是数字，在这种情况下，行为取决于 `field.config.color.mode` 设置。例如，用来创建由字段值控制的渐变颜色。 | 
| icon | 字符串 | 要在节点内显示的图标名称，而不是默认统计信息。只允许使用 Grafana 内置图标（在[此处](https://developers.grafana.com/ui/latest/index.html?path=/story/docs-overview-icon--icons-overview)查看可用图标）。 | 
| nodeRadius | 数字 | 半径值（像素）。用于管理节点大小。 | 
| highlighted | 布尔值 | 设置是否应突出显示节点。例如，通过突出显示几个节点和边来表示图形中的特定路径 默认值为 `false`。 | 

# 饼图
<a name="v10-panels-piechart"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

![\[显示 Grafana 中饼图可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/pie_chart_example.png)


饼图将来自一个或多个查询的简化序列或序列中的值（这些值彼此相关）显示为饼图的切片。切片的弧长、面积和中心角都与切片值成正比，因为它与所有值的总和相关。如果您想以美观的形式快速比较一小组值，最好使用这种类型的图表。

## 值选项
<a name="v10-panels-piechart-value"></a>

使用以下选项优化可视化中的值。

**Show (显式)**

选择要显示的信息量。
+ **计算**：将每个值归约为每个序列的单个值。
+ **所有值**：显示单个序列中的每个值。

**计算**

选择**计算**后，选择计算以归约每个序列。有关可用计算的信息，请参阅[计算类型](v10-panels-calculation-types.md)。

**限制**

显示单个序列中的每个值时，这会限制显示的值数量。

**字段**

至少选择一个要在可视化中显示的字段。列表中提供了每个字段名称，也可以选择以下选项之一：
+ **数值字段**：所有包含数值的字段。
+ **所有字段**：所有未由转换删除的字段。
+ **时间**：所有带有时间值的字段。

## 饼图选项
<a name="v10-panels-piechart-options"></a>

使用以下选项来优化可视化效果。

**饼图类型**

选择饼图的显示样式。可以是以下任一项：
+ **饼图**：标准饼图
+ **甜甜圈**：中间有洞的饼图

**标签**

选择要在饼图上显示的标签。您可以选择多个标签。
+ **名称**：序列或字段名称。
+ **百分比**：占整体的百分比。
+ **值**：原始数值。

默认情况下，标签在图表正文上显示为白色。您可以选择深颜色的图表，使其更加明显。较长的名称或数字可能会被截断。

**工具提示模式**

当您将光标悬停在可视化上时，Grafana 可显示工具提示。选择工具提示的行为方式。
+ **单个**：悬停工具提示仅显示一个序列，即您将鼠标悬停在可视化上面的序列。
+ **全部**：悬停工具提示显示可视化中的所有序列。Grafana 在工具提示的序列列表中以粗体突出显示您悬停在上面的序列。
+ **隐藏**：与可视化交互时不显示工具提示。

使用覆盖从工具提示隐藏单个序列。

## 图例选项
<a name="v10-panels-piechart-legend"></a>

使用这些设置可定义图例在可视化中的显示方式。有关图例的更多信息，请参阅[配置图例](v10-panels-configure-legend.md)。

**图例可见性**

使用**可见性**开关显示或隐藏图例。

**图例模式**

设置图例的显示模式。
+ **列表**：以列表形式显示图例。这是图例的默认显示模式。
+ **表**：以表的形式显示图例。

**图例放置**

选择显示图例的位置。
+ **底部**：显示在图形下方。
+ **右**：显示在图形右侧。

**图例值**

选择要在图例中显示的值。可以选择多个值。
+ **百分比**：占整体的百分比。
+ **值**：原始数值。

有关图例的更多信息，请参阅[配置图例](v10-panels-configure-legend.md)。

# Stat
<a name="v10-panels-stat"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

统计显示一个很大的统计值，并带有可选的图表迷你图。您可以使用阈值或覆盖来控制背景或值颜色。

![\[显示 Grafana 中统计可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/stat_panel_example.png)


默认情况下，统计将显示以下内容之一：
+ 仅单个序列或字段的值。
+ 多个序列或字段的值和名称。

您可以使用**文本模式**来控制是否显示文本。

## 自动布局调整
<a name="v10-panels-stat-automatic-adjust"></a>

面板会根据控制面板中的可用宽度和高度自动调整布局。如果面板变得太小，将会自动隐藏图形（迷你图）。

## 值选项
<a name="v10-panels-stat-value"></a>

使用以下选项来优化可视化显示值的方式：

**Show (显式)**

选择 Grafana 显示数据的方式。
+ **计算**

  显示基于所有行的计算值。
  + **计算**：选择一个 reducer 函数，Grafana 将使用该函数将多个字段归约为单个值。有关可用计算的列表，请参阅[标准计算](v10-panels-calculation-types.md)。
  + **字段**：选择要在可视化中显示的字段。
+ **所有值**

  为每行显示一个单独的统计数据。如果选择此选项，则还可以限制要显示的行数。
  + **限制**：要显示的最大行数。默认为 5000。
  + **字段**：选择要在可视化中显示的字段。

## 统计样式
<a name="v10-panels-stat-styles"></a>

设置可视化的样式。

**方向**

选择堆叠方向。
+ **自动**：Grafana 会选择其认为最佳的方向。
+ **水平**：从左到右水平拉伸条形图。
+ **垂直**：从上到下垂直拉伸条形图。

**文本模式**

您可以使用文本模式选项来控制可视化呈现的文本。如果值并不重要，重要的是名称和颜色，则将**文本模式**更改为**名称**。该值仍用于确定颜色，并显示在工具提示中。
+ **自动**：如果数据包含多个序列或字段，则同时显示名称和值。
+ **值**：仅显示值，不显示名称。名称显示在悬停工具提示中。
+ **值和名称**：始终显示值和名称。
+ **名称**：显示名称而不是值。值显示在悬停工具提示中。
+ **无**：不显示任何内容（空）。名称和值显示在悬停工具提示中。

**宽布局**

设置是否启用宽布局。默认情况下，将启用宽布局。
+ **开启**：宽布局已开启。
+ **关闭**：宽布局已关闭。

**注意**  
仅当**文本模式**设置为**值和名称**时，此选项才适用。开启宽版面时，如果面板足够宽 side-by-side，则值和名称将显示在右边。关闭宽布局后，该值始终呈现在名称下方。

**颜色模式**

选择一种颜色模式。
+ **无**：不对值应用任何颜色。
+ **值**：仅为值和图形区域着色。
+ **背景渐变**：将颜色应用于值、图形区域和背景，并略带背景渐变。
+ **背景纯色**：将颜色应用于值、图形区域和背景，并带有纯色背景色。

**图形模式**

选择图形和迷你图模式。
+ **无**：隐藏图形并仅显示值。
+ **面积**：在值下方显示面积图。这要求您的查询返回时间列。

**文本对齐方式**

选择对齐模式。
+ **自动**：如果仅显示单个值（不重复），则该值居中。如果显示多个序列或多行，则该值为左对齐。
+ **中心**：统计值居中。

**显示百分比变化**

设置是否显示百分比变化。默认不显示。

**注意**  
当**值选项**下的**显示**设置为**所有值**时，此选项不适用。

## 文本大小
<a name="v10-panels-stat-textsize"></a>

调整仪表文本的大小。
+ **标题**：输入仪表标题大小的数值。
+ **值**：输入仪表值大小的数值。

# 状态时间轴
<a name="v10-panels-state-timeline"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

状态时间轴可显示一段时间内的离散状态变化。每个字段或序列都渲染为其唯一的水平段。状态区域可以用值或不用值渲染。此面板适用于字符串或布尔状态，但也可以与时间序列一起使用。与时间序列一起使用时，使用阈值将数值转换为离散状态区域。

![\[显示 Grafana 中状态时间轴可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/state_timeline_example.png)


## 状态时间轴选项
<a name="v10-panels-state-timeline-options"></a>

使用以下选项来优化可视化效果：

**合并相等的连续值**

控制 Grafana 是否合并相邻的相同值。

**显示值**

控制是否在状态区域内渲染数值。如果有足够的空间，**Auto** 将渲染值。

**对齐值**

控制状态区域内的值对齐。

**行高**

控制行间的间距。1 = 无间距，0.5 = 50% 间距。

**线宽**

控制状态区域的线宽。

**填充不透明度**

控制状态区域的不透明度。

**连接 null 值**

选择 null 值（数据中的间隙）在图形上的显示方式。可将 null 值连接起来形成一条连续的线，也可以设置一个阈值，如果超过该阈值，数据间隙将不再连接。
+ **从不**：数据中存在间隙的时间序列数据点从不连接。
+ **始终**：数据中存在间隙的时间序列数据点始终连接。
+ **阈值**：指定一个阈值，如果超过该阈值，数据间隙将不再连接。当数据中连接的间隙大小已知或在已知范围内时，这种方法会很有用，超出此范围的间隙不应再连接。

**断开值连接**

选择是否设置一个阈值，如果超过该阈值，应断开数据中的值连接。
+ **从不**：数据中的时间序列数据点从不断开连接。
+ **阈值**：指定一个阈值，如果超过该阈值，数据中的值将断开连接。当数据中所需的值具有已知的大小或在已知范围内时，这种方法会很有用，超出此范围的值不应再连接。

## 值映射
<a name="v10-panels-state-timeline-valuemap"></a>

要为布尔值或字符串值分配颜色，请使用 [配置值映射](v10-panels-configure-value-mappings.md)。

## 带阈值的时间序列数据
<a name="v10-panels-state-timeline-threshold"></a>

该可视化也可以用于时间序列数据。在这种情况下，使用阈值将时间序列转换为离散的彩色状态区域。

## 图例选项
<a name="v10-panels-state-timeline-legend"></a>

启用图例选项后，可以显示值映射或阈值括号。要在图例中显示值映射，请务必将“标准”选项下的**颜色方案**选项设置为**单色**或**经典调色板**。要查看图例中的阈值括号，请将**颜色方案**设置为**来自阈值**。

**图例模式**

使用这些设置可定义图例在可视化中的显示方式。有关图例的更多信息，请参阅[配置图例](v10-panels-configure-legend.md)。
+ **列表**：以列表形式显示图例。这是默认模式。
+ **表**：以表的形式显示图例。
+ **隐藏**：隐藏图例。

**图例放置**

选择显示图例的位置。
+ **底部**：显示在图形下方。
+ **右**：显示在图形右侧。

**图例值**

选择要在图例中显示的[标准计算](v10-panels-calculation-types.md)。可以输入多个值。

# 状态历史记录
<a name="v10-panels-status-history"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

状态历史记录显示一段时间内的周期性状态。每个字段或序列都渲染为水平行。然后渲染框并围绕每个值居中。

## 支持的数据
<a name="v10-panels-status-history-supporteddata"></a>

状态历史适用于字符串、布尔值和数值字段或时间序列。时间字段为必填项。您可以使用值映射为字符串着色，或为数字范围赋予文本值。

## 显示选项
<a name="v10-panels-status-history-options"></a>

使用这些选项来优化可视化效果。

**显示值**

控制值是否在值框内渲染。如果有足够的空间，**Auto** 将渲染值。

**列宽**

控制框的宽度。1 = 最大间距，0 = 最小间距。

**线宽**

控制状态区域的线宽。

**填充不透明度**

控制状态区域的填充不透明度。

## 值映射
<a name="v10-panels-status-history-valuemap"></a>

要为布尔值或字符串值分配颜色，请使用 [配置值映射](v10-panels-configure-value-mappings.md)。

## 带阈值的时间序列数据
<a name="v10-panels-status-history-threshold"></a>

该面板也可以用于时间序列数据。在这种情况下，使用阈值为框着色。也可以使用渐变配色方案为值着色。

## 图例选项
<a name="v10-panels-status-history-legend"></a>

启用图例选项后，可以显示值映射或阈值括号。要在图例中显示值映射，请务必将“标准”选项下的**颜色方案**选项设置为**单色**或**经典调色板**。要查看图例中的阈值括号，请将**颜色方案**设置为**来自阈值**。

**图例模式**

使用这些设置可定义图例在可视化中的显示方式。有关图例的更多信息，请参阅[配置图例](v10-panels-configure-legend.md)。
+ **列表**：以列表形式显示图例。这是默认模式。
+ **表**：以表的形式显示图例。
+ **隐藏**：隐藏图例。

**图例放置**

选择显示图例的位置。
+ **底部**：显示在图形下方。
+ **右**：显示在图形右侧。

**图例值**

选择要在图例中显示的[标准计算](v10-panels-calculation-types.md)。可以输入多个值。

# 表
<a name="v10-panels-table"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

表非常灵活，支持时间序列、表、注释和原始 JSON 数据的多种模式。此可视化还提供日期格式、值格式和着色选项。

![\[显示 Grafana 中表可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/table_example.png)


**注意**  
表不支持注释和警报。

## 对列排序
<a name="v10-panels-table-sort"></a>

选择列标题，将排序顺序从默认降序改为升序。每次选择列时，排序顺序都会变为循环中的下一个选项。选择其他列时按住 `shift` 键可以对多列排序。

## 表选项
<a name="v10-panels-table-options"></a>

**显示标题**

显示或隐藏从数据来源导入的列名称。

## 列宽
<a name="v10-panels-table-width"></a>

默认情况下，Grafana 会根据表大小和最小列宽自动计算列宽。此字段选项可以覆盖设置，并以像素为单位定义所有列的宽度。

例如，如果输入 `100`，则所有列的宽度都将设置为 100 像素（退出字段时会发生更改）。

## 最小列宽
<a name="v10-panels-table-min"></a>

默认情况下，表列的最小宽度为 150 像素。该字段选项可以覆盖默认值，并以像素为单位定义表面板新的最小列宽。

例如，如果将最小值设置为 `75`，则所有列的宽度都将缩放至不小于 75 像素。

对于小屏幕设备（如智能手机或平板电脑），您可以将默认 `150` 像素值减小为 `50`，以便在控制面板中正确渲染表面板。

## 列对齐方式
<a name="v10-panels-table-alignment"></a>

选择 Grafana 对齐单元格内容的方式。
+ 自动（默认）
+ 靠左对齐
+ 居中对齐
+ 靠右对齐

## 单元格类型
<a name="v10-panels-table-cell-type"></a>

默认情况下，Grafana 会自动选择显示设置。您可以选择以下选项之一来覆盖设置，为所有字段设置默认值。对于某些单元格类型，还可提供其他配置。

**注意**  
如果您在**字段**选项卡中进行设置，该类型将应用于所有字段，包括时间字段。您可以在**覆盖**选项卡中进行设置，以将更改应用于一个或多个字段。

**颜色文本**

如果设置了阈值，则字段文本将以相应的阈值颜色显示。

**彩色背景（渐变或纯色）**

如果设置了阈值，则字段背景将以相应的阈值颜色显示。

**计量表**

单元格可以显示为图形仪表，具有几种不同的表示类型。
+ *基本*：基本模式将显示一个简单的仪表，其阈值水平定义了仪表的颜色。
+ *渐变*：阈值水平定义渐变。
+ *LCD*：将仪表分成点亮或不点亮的小单元格。

此外，可将仪表旁边显示的标签设置为按值着色、匹配主题文本颜色或隐藏。
+ **值颜色**
+ **文本颜色**
+ **隐藏**

**JSON 视图**

显示格式化为代码的值。如果值是对象，则允许浏览 JSON 对象的 JSON 视图在悬停时显示。

**迷你图**

显示渲染为迷你图的值。需要进行[时间序列到表](v10-panels-xform-functions.md#v10-panels-xform-funcs-series)的数据转换。

## 单元格值检查
<a name="v10-panels-table-cell-value"></a>

从表单元格启用值检查。原始值显示在模态窗口中。

**注意**  
仅当单元格显示模式设置为自动、彩色文本、彩色背景或 JSON 视图时，单元格值检查才可用。

## 列筛选器
<a name="v10-panels-table-col-filter"></a>

您可以暂时更改列数据的显示方式。例如，您可以按从高到低的顺序排列值，或者隐藏特定的值。有关更多信息，请参阅[筛选表列](#v10-panels-table-filter)。

## 分页
<a name="v10-panels-table-pagination"></a>

使用此选项启用或禁用分页。这是一个前端选项，不影响查询。启用后，页面大小会自动调整为表的高度。

## 筛选表列
<a name="v10-panels-table-filter"></a>

如果打开**列筛选器**，可以筛选表选项。

**打开列筛选**

1. 在 Grafana 中，导航到表控制面板，其中包含要筛选的列。

1. 在要筛选的表面板上，打开面板编辑器。

1. 选择**字段**选项卡。

1. 在**表**选项中，打开**列筛选器**选项。

每个列标题旁边都会显示一个筛选器（漏斗）图标。

**筛选列值**

要筛选列值，请选择列标题旁边的筛选器（漏斗）图标。Grafana 会显示该列的筛选选项。

选中要显示的值旁边的复选框。在顶部的搜索字段中输入文本，在显示屏中显示这些值，这样您就可以从中选择，而不用滚动来查找。

从多个运算符中选择以显示列值：
+ **包含**：匹配正则表达式模式（默认为运算符）。
+ **表达式**：计算布尔表达式。字符 `$` 表示表达式中的列值（例如，`$ >= 10 ≈& $ <= 12`）。
+ **比较运算符**：您可以使用典型的比较运算符：`=`、`!=`、`<`、`<=`、`>` 和 `>=`。

选中**确定**和**取消**按钮上方的复选框，在筛选器中添加或删除所有显示的值。

**清除列筛选条件**

应用筛选条件的列在标题旁边会显示一个蓝色的漏斗。

要删除筛选条件，请选择蓝色漏斗图标，然后选择**清除筛选条件**。

## 表脚注
<a name="v10-panels-table-footer"></a>

您可以使用表脚注来显示字段的[计算](v10-panels-calculation-types.md)。

启用表脚注后，您可以选择**计算**，然后选择要计算的**字段**。

如果未选择字段，系统会将计算应用于所有数值字段。

**计算行数**

如果要显示数据集中的行数，而不是所选字段中的值数，请选择**计数**计算并启用**计算行数**。

# 文本
<a name="v10-panels-text"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

文本可视化使您能够直接在控制面板中包含文本或 HTML。可将其用于添加上下文信息和描述或嵌入复杂的 HTML。

**Mode (模式)**

**模式**决定了嵌入内容的显示方式。具有以下选项：
+ **Markdown**：此选项将内容格式化为 markdown。
+ **HTML**：此设置将内容渲染为经过清理的 HTML。
+ **代码**：此设置在只读代码编辑器中渲染内容。选择适当的语言，对嵌入文本应用语法突出显示。

**变量**

内容中的变量将展开以供显示。

# 时间序列
<a name="v10-panels-time-series"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

![\[显示 Grafana 中时间序列可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/time_series_example.png)


时间序列可视化是将时间序列数据可视化为图形的默认和主要方式。可将序列渲染为直线、点或条形。其用途广泛，几乎可以显示任何时间序列数据。

**注意**  
您可以将图形面板可视化迁移到时间序列可视化。若要迁移，请在**面板**选项卡上，选择**时间序列可视化**。Grafana 会传输所有适用的设置。

**Topics**
+ [工具提示选项](v10-time-series-panel-tooltip.md)
+ [图例选项](v10-time-series-panel-legend.md)
+ [图形样式](v10-time-series-graph.md)
+ [轴选项](v10-time-series-axis.md)
+ [颜色选项](v10-time-series-color.md)

# 工具提示选项
<a name="v10-time-series-panel-tooltip"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

工具提示选项控制将鼠标悬停在图形中的数据点上时显示的信息叠加。

**工具提示模式**
+ **单个**：悬停工具提示仅显示一个序列，即您将鼠标悬停在上面的序列。
+ **全部**：悬停工具提示显示可视化中的所有序列。Grafana 在工具提示的序列列表中以粗体突出显示您悬停在上面的序列。
+ **隐藏**：与可视化交互时不显示工具提示。

# 图例选项
<a name="v10-time-series-panel-legend"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

图例选项控制显示在图形下方或右侧的序列名称和统计数据。

**图例模式**

使用这些设置可定义图例在可视化中的显示方式。有关图例的更多信息，请参阅 [配置图例](v10-panels-configure-legend.md)。
+ **列表**：以列表形式显示图例。这是图例的默认显示模式。
+ **表**：以表的形式显示图例。
+ **隐藏**：隐藏图例。

**图例放置**

选择显示图例的位置。
+ **底部**：显示在图形下方。
+ **右**：显示在图形右侧。

**图例值**

选择要在图例中显示的[标准计算](v10-panels-calculation-types.md)。可以有多个。

# 图形样式
<a name="v10-time-series-graph"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

可使用此选项定义如何显示时间序列数据。您可以使用覆盖在同一个图形中组合多种样式。
+ **线**：在图形上将时间序列显示为一条线。
+ **条形图**：将时间序列显示为图形上的一系列条形图，每个条形图对应一个数据点。
+ **点**：将时间序列显示为图形上的一系列点，每个点对应一个数据点。

## 条形图对齐
<a name="v10-time-series-graph-bar"></a>

设置条形图相对于数据点的位置（该点将绘制在图形上）。由于条形图具有宽度，可将其放置在点的前面、后面或居中。适用的选项包括：
+ ![\[An image showing a bar graph aligned before a point.\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/bar-alignment-before.png) **前**：条形图绘制在点之前。该点放置在条形图的尾角。
+ ![\[An image showing a bar graph aligned around a point.\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/bar-alignment-center.png) **居中**：条形图围绕该点绘制。该点放置在条形图的中央。这是默认值。
+ ![\[An image showing a bar graph aligned after a point.\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/bar-alignment-after.png) **后**：条形图绘制在点之后。该点放置在条形图的前角。

## 线宽
<a name="v10-time-series-graph-linewidth"></a>

线宽是一个滑块，用于控制系列线条的粗细或条形图的轮廓。

## 填充不透明度
<a name="v10-time-series-graph-fill"></a>

设置填充颜色的不透明度。例如，填充用于显示折线图中线条下方的区域，或用作条形图中条形的颜色。

## 渐变模式
<a name="v10-time-series-graph-gradient"></a>

渐变模式指定渐变填充，该填充基于序列颜色。要更改颜色，请使用标准颜色方案字段选项。有关更多信息，请参阅 [颜色方案](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme)。

渐变模式选项包括：
+ **无**：无渐变填充。这是默认设置。
+ **不透明度**：一种不透明度渐变，其中填充的不透明度随着 Y 轴值的增加而增加。
+ **色调**：一种基于序列色调的微渐变。
+ **方案**：由您的颜色方案定义的颜色渐变。该设置用于填充区域和线条。有关更多信息，请参阅 [颜色选项](v10-time-series-color.md)。

渐变外观受**填充不透明度**设置的影响。

## 显示点
<a name="v10-time-series-graph-showpoints"></a>

您可以使用以下选项将可视化配置为向线条或条形图添加点。
+ **自动**：Grafana 根据数据的密度决定是否显示点。当密度较低时，
+ **始终**：无论数据密度如何，都会显示点。
+ **从不**：不显示点。

## 点大小
<a name="v10-time-series-graph-pointsize"></a>

设置点的大小，直径从 1 到 40 像素不等。

## 线插值
<a name="v10-time-series-graph-interpolation"></a>

选择 Grafana 插入序列线的方式。

![\[显示 Grafana 中在点之间绘制线条的不同方式的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/line-interpolation.png)


选项包括：
+ **线性**：点由直线连接。
+ **平滑**：点由曲线连接，曲线可平滑点之间的过渡。
+ **前一步**：线条显示为点之间的步长。点在步结束时渲染。
+ **后一步**：线条显示为点之间的步长。点在步开始时渲染。

## 线型
<a name="v10-time-series-graph-linestyle"></a>

设置线条样式。要更改颜色，请使用标准颜色方案字段选项。

线条样式的选择有：
+ **实线**：显示实线。这是默认设置。
+ **虚线**：显示虚线。选择此选项时，会出现一个列表，供您选择虚线的长度和间隙（长度、间隙）。默认情况下，虚线间距设置为 10。
+ **点**：显示虚线。选择此选项时，会出现一个列表，供您选择点间距的间隙长度。默认情况下，点间距设置为 10。

## 连接 null 值
<a name="v10-time-series-graph-null"></a>

选择 null 值（数据中的间隙）在图形上的显示方式。可将 null 值连接起来形成一条连续的线，也可以设置一个阈值，如果超过该阈值，数据间隙将不再连接。

连接 null 值的选项有：
+ **从不**：数据中存在间隙的时间序列数据点从不连接。
+ **始终**：数据中存在间隙的时间序列数据点始终连接。
+ **阈值**：指定一个阈值，如果超过该阈值，数据间隙将不再连接。当数据中连接的间隙大小已知或在已知范围内时，这种方法会很有用，超出此范围的间隙不应再连接。

## 断开值连接
<a name="v10-time-series-graph-disconnect"></a>

选择是否在数据中的值之间添加间隔，以使这些值之间的间隔超过指定的阈值。

断开值连接的选项有：
+ **从不**：时间序列数据点从不断开连接。
+ **阈值**：指定一个阈值，如果超过该阈值，数据中的值将断开连接。当数据中所需的值具有已知的大小或在已知范围内时，这种方法会很有用，超出此范围的值不应再连接。

## 堆栈序列
<a name="v10-time-series-graph-stack"></a>

*堆叠*允许 Grafana 相互叠加显示序列。在可视化中使用堆叠时要小心，因为很容易创建误导性图形。要了解为什么堆叠可能不是最佳方法的更多信息，请参阅[堆叠问题](https://www.data-to-viz.com/caveat/stacking.html)。

堆叠的选项有：
+ **关闭**：关闭序列堆叠。
+ **正常**：将序列堆叠在一起。
+ **100%**：按百分比堆叠，其中所有序列相加为 100%。

**分组堆叠序列**

您可以覆盖堆叠行为以分组堆叠序列。有关创建覆盖的更多信息，请参阅 [配置字段覆盖](v10-panels-configure-overrides.md)。

**分组堆叠序列**

1. 编辑面板并选择**覆盖**。

1. 为**堆栈系列**选项创建字段覆盖。

1. 在堆叠模式下，选择**正常**。

1. 为您希望序列显示在其中的堆叠组命名。

   堆叠组名称选项仅在您创建覆盖时可用。

## 填充至下方
<a name="v10-time-series-graph-fillbelow"></a>

**填充至下方**选项填充两个序列之间的区域。此选项仅以序列或字段覆盖形式提供。

使用此选项，您可以填充两个序列之间的区域，而不是从序列线向下填充到 0。例如，如果您有两个名为 *Max* 和 *Min* 的序列，您可以选择 *Max* 序列并将其覆盖，以**填充至下方** *Min* 序列。这将仅填充两条序列线之间的区域。

# 轴选项
<a name="v10-time-series-axis"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

轴类别下的选项会更改 x 和 y 轴的渲染方式。某些选项只有在您编辑的字段选项框外部单击后才会生效。也可以按 `Enter` 键。

## 时区
<a name="v10-time-series-axis-timezone"></a>

设置要沿 x 轴显示的所需时区。

## 放置
<a name="v10-time-series-axis-placement"></a>

设置 Y 轴的放置。选项包括：
+ **自动**：自动为序列分配 y 轴。当有两个或多个具有不同单位的序列时，Grafana 将左轴分配给第一个单位，将右轴分配给下一个单位。
+ **左**：在左侧显示所有 y 轴。
+ **右**：在右侧显示所有 y 轴。
+ **隐藏**：隐藏所有轴。

要有选择地隐藏轴，请针对特定字段[添加字段覆盖](v10-panels-configure-overrides.md)。

## 标签
<a name="v10-time-series-axis-label"></a>

设置 y 轴文本标签。如果有多个 y 轴，可使用覆盖分配不同的标签。

## 宽度
<a name="v10-time-series-axis-width"></a>

设置轴的固定宽度。默认情况下，Grafana 会动态计算轴的宽度。

通过设置轴的宽度，具有不同轴类型的数据可以共享相同的显示比例。此设置让您更容易比较多个图形的数据，因为轴在视觉上不会相互错位或拉伸。

## 显示网格线
<a name="v10-time-series-axis-gridlines"></a>

设置轴网格线的可见性。
+ **自动**：根据数据的密度自动显示网格线。
+ **开**：始终显示网格线。
+ **关**：从不显示网格线。

## 颜色
<a name="v10-time-series-axis-color"></a>

设置轴的颜色
+ **文本**：根据主题文本颜色设置颜色。
+ **序列**：根据序列颜色设置颜色。

## 显示边框
<a name="v10-time-series-axis-border"></a>

设置轴边框的可见性。

## 比例尺
<a name="v10-time-series-axis-scale"></a>

设置 y 轴刻度。
+ **线性**：将刻度分成相等的部分。
+ **对数**：使用对数刻度。选择此选项时，会出现一个列表，供您选择二进制（以 2 为基数）或通用（以 10 为基数）对数刻度。
+ **Symlog**：使用对称的对数刻度。选择此选项时，会出现一个列表，供您选择二进制（以 2 为基数）或通用（以 10 为基数）对数刻度。线性阈值选项允许您设置刻度从线性变为对数的阈值。

## 居中零点
<a name="v10-time-series-axis-centered"></a>

将 y 轴设置为居中零点。

## 软最小值和软最大值
<a name="v10-time-series-axis-softminmax"></a>

设置**软最小值**或**软最大值**选项，以更好地控制 y 轴限制。默认情况下，Grafana 会根据数据集自动设置 y 轴的范围。

软最小值和软最大值设置可防止数据中的微小变化在基本平坦时被放大。相比之下，硬最小值和最大值有助于通过将间歇性尖峰剪过特定点来防止掩盖数据中的有用细节。

要定义 y 轴的硬限制，请设置标准 min/max 选项。有关更多信息，请参阅[配置标准选项](v10-panels-configure-standard-options.md)。

## 转换
<a name="v10-time-series-axis-transform"></a>

使用此选项可转换序列值，而不会影响工具提示、上下文菜单或图例中显示的值。您有两个转换选项：
+ **负 Y 转换**：将结果翻转为 Y 轴上的负值。
+ **常量**：将第一个值显示为常量线。

**注意**  
转换选项只能作为覆盖选项使用。

## 显示多个 y 轴
<a name="v10-time-series-axis-multiple"></a>

在某些情况下，您希望显示多个 y 轴。例如，如果您有一个数据集，显示一段时间内的温度和湿度，则可能需要为这两个序列显示两个具有不同单位的 y 轴。

要显示多个 y 轴，请[添加字段覆盖](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field)。根据需要多次执行这些步骤，以添加任意数量的 y 轴。

# 颜色选项
<a name="v10-time-series-color"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

默认情况下，图形使用标准[颜色方案](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme)选项来指定序列颜色。您也可以通过选择图例序列颜色图标，使用图例打开颜色选取器。以这种方式设置颜色会自动创建覆盖规则，为特定序列设置特定颜色。

以下是可用于覆盖序列颜色默认值的其他选项。

## 经典调色板
<a name="v10-time-series-color-classic"></a>

最常见的设置是使用**经典调色板**绘制图形。此方案根据每个字段或序列的顺序自动为其分配颜色。如果查询中字段的顺序发生变化，颜色也会发生变化。您可以使用覆盖规则手动配置特定字段的颜色。

## 单色
<a name="v10-time-series-color-single"></a>

使用此模式指定颜色。您还可以选择图例中每个序列旁边的彩色线条图标来打开颜色选取器。这将自动创建一个新的覆盖，将颜色方案设置为单色和选定颜色。

## 按值颜色方案
<a name="v10-time-series-color-byvalue"></a>

如果您选择按值配色方案，例如**从阈值（按值）**或 **Green-Yellow-Red （按值）**，则会出现 “**按系列着色**” 选项。此选项控制使用哪个值（最后一个、最小值、最大值）为序列指定颜色。

## 方案渐变模式
<a name="v10-time-series-color-gradient"></a>

位于**图形样式**下方的**渐变模式**选项有一个名为 **Scheme** 的模式。启用 **Scheme** 时，线条或条形图会收到根据选定**方案**定义的渐变颜色。

**来自阈值**

如果将**颜色方案**设置为**来自阈值（按值）**，将**渐变模式**设置为**方案**，则线条或条形图颜色在超出定义的阈值时会发生变化。您只会看到在方案中选择的具体颜色。

**渐变颜色方案**

使用渐变颜色方案而*不*将**渐变模式**设置为**方案**，这意味着当序列中的值在设置的阈值之间移动时，所选颜色将在所选颜色之间形成渐变。

# 跟踪
<a name="v10-panels-traces"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

跟踪可视化使您可以在请求遍历基础设施中的服务时跟踪请求。跟踪可视化在图中显示跟踪数据，以便您轻松解释这些数据。

有关跟踪及其使用方法的更多信息，请参阅以下文档：
+ [Explore 中的跟踪](v10-explore-tracing.md)
+ [Tempo 数据来源](tempo-data-source.md)
+ *Grafana Labs Tempo 文档*中的[开始使用 Tempo](https://grafana.com/docs/tempo/latest/getting-started/)。

## 添加带有跟踪可视化效果的面板
<a name="v10-panels-traces-add"></a>

一旦 Grafana 堆栈中有可用的跟踪数据，就可以将跟踪面板添加到 Grafana 控制面板。

使用控制面板变量 `traceID`，可以创建查询以显示给定跟踪 ID 的特定跟踪。有关控制面板变量的更多信息，请参阅[变量文档](v10-dash-variables.md)。

**先决条件**

在开始之前，您需要：
+ Amazon Managed Grafana 工作区。
+ 连接到工作区的 [Tempo 数据来源](tempo-data-source.md)。

要在控制面板中查看和分析跟踪数据，您需要将跟踪可视化添加到控制面板，并使用面板编辑器定义查询。查询决定了可视化中显示的数据。有关面板编辑器的更多信息，请参阅[面板编辑器文档](v10-panels-editor-overview.md)。

此过程使用仪表板变量和模板来允许您输入跟踪 IDs ，然后可以将其可视化。您将使用名为 `traceId` 的变量，将其添加为模板查询。

**添加跟踪可视化查询**

1. 在您的工作区中，创建一个新控制面板或转到要在其中添加跟踪可视化效果的现有控制面板。

1. 从新控制面板中选择**添加可视化**或在现有控制面板上选择**添加面板**。

1. 选择相应的跟踪数据来源。

1. 在面板编辑器的右上角，选择**可视化**选项卡，然后选择**跟踪**。

1. 在**面板选项**下，输入跟踪面板的**标题**。有关面板编辑器的更多信息，请参阅 [配置面板选项](v10-panels-configure-panel-options.md)。

1. 在查询编辑器中，选择 **TraceQL** 查询类型选项卡。

1.  在 TraceQL 查询字段中输入 `${traceId}` 以创建控制面板变量。此变量用作模板查询。

1. 在面板编辑器中选择**应用**，将面板添加到控制面板。

1. 转到控制面板**设置**，添加一个名为 `traceId`，变量类型为**自定义**的新变量，为其添加标签（如果需要）。选择**应用**将变量添加到控制面板。

1. 对用于跟踪面板的数据来源使用有效的跟踪 ID，并在控制面板变量中编辑 ID，验证面板是否正常工作。

## 添加带有表可视化效果的 TraceQL
<a name="v10-panels-traces-traceql"></a>

虽然您可以向仪表板添加跟踪可视化，但必须手动将跟踪添加 IDs 为仪表板变量很麻烦。相反，能够使用 TraceQL 查询来搜索特定类型的跟踪，然后从匹配结果中选择适当的跟踪效果更好。

**先决条件**

此过程假定您已完成上述过程。

**添加带有表可视化效果的 TraceQL**

1. 在添加跟踪可视化的同一控制面板中，选择**添加面板**以添加新的可视化面板。

1. 选择在上一节中使用的同一跟踪数据来源。

1. 在面板编辑器的右上角，选择**可视化**选项卡，然后选择**表**。

1. 在查询编辑器中，选择 **TraceQL** 选项卡。

1. 在**面板选项**下，输入跟踪面板的**标题**。

1. 添加适当的 TraceQL 查询，搜索要在控制面板中可视化的跟踪。例如，这是一个来自名为的服务器的简单静态查询*my-server*。

   ```
   { .service.name = "my-server" && .http.status_code=500 }
   ```

   您可以将 TraceQL 查询编写为模板查询，以利用其他控制面板变量（如果存在）。这样，您就可以基于这些变量创建动态查询。

当查询返回结果时，结果将渲染在面板的表中。

跟踪可视化中的结果包括指向渲染跟踪的 **Explore** 页面的链接。您可以在表中添加指向跟踪的其他链接，这些跟踪在选中时填充 `traceId` 控制面板变量，以便在同一控制面板中可视化跟踪。

要在面板中创建一组数据链接，请按以下步骤操作。

**使用变量向跟踪添加其他链接**

1. 在右侧菜单中的**数据链接**下，选择**添加链接**。

1. 为数据链接添加**标题**。

1. 在渲染整个控制面板时，查看浏览器的地址栏来查找控制面板的路径。由于这是指向同一 Grafana 堆栈中控制面板的链接，因此只需要提供控制面板的路径。

   例如，如果您的路径是：

   ```
   https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1
   ```

   那么控制面板的路径是：

   ```
   /d/1234abcd5/my-dashboard?orgId=1
   ```

1. 在 **URL** 字段中，对包含两个面板的控制面板进行自引用。此自引用使用表中选定跟踪的值来填充控制面板变量。使用上一步中控制面板的路径，然后使用 TraceQL 表中的选定结果填写 `traceId` 的值。跟踪 ID 是使用返回结果中的 `traceID` 数据字段公开的，因此将其用作控制面板变量的值。例如：

   ```
   /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
   ```

1. 选择**保存**以保存数据链接。

1. 从面板编辑器中选择**应用**，将面板应用于控制面板。

1. 保存控制面板。

现在，您应该可以在表可视化中看到匹配的跟踪列表。选择 **TraceID** 或 **SpanID** 字段时，您可以选择打开 **Explore** 页面以可视化跟踪或点击数据链接，选择任何其他字段（例如 `Start time`、`Name` 或 `Duration`）以自动点击数据链接，填写 `traceId` 控制面板变量，然后在跟踪面板中显示相关追踪。

# 趋势
<a name="v10-panels-trend"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

趋势可视化应用于具有连续数字 X（而非时间）的数据集。一些示例包括函数图、 rpm/torque 曲线、供需关系以及赛道上的海拔或心率图（以 x 为起点的距离或持续时间）。

趋势可视化支持[时间序列可视化](v10-panels-time-series.md)中可用的所有视觉样式和选项，但以下情况除外：
+ 无注释或时间区域
+ 无共享光标（或十字准线）
+ 无多时区 x 轴
+ 无法通过拖动选择来更改控制面板的时间范围

**X 字段选择**

使用此选项选择包含递增数值的字段。

 例如，您可以表示发动机功率和扭矩与速度的关系，其中速度绘制在 x 轴上，功率和扭矩绘制在 y 轴上。

# XY 图表
<a name="v10-panels-xychart"></a>

XY 图表提供了一种在图形中可视化任意 x 和 y 值的方法，以便轻松显示两个变量之间的关系。XY 图表通常用于创建散点图。您也可以使用它们来创建气泡图，其中字段值决定了每个气泡的大小。

![\[显示 Grafana 中 XY 图表可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/xy-chart-example.png)


## 支持的数据格式
<a name="v10-panels-xychart-formats"></a>

您可以在 XY 图表中使用任何类型的表数据，其中至少有两个数值字段。这种类型的可视化不需要时间数据。

## 面板选项
<a name="v10-panels-xychart-paneloptions"></a>

在面板编辑器窗格的**面板选项**部分，您可以设置面板标题和描述等基本选项。您还可以在此部分配置重复面板。有关更多信息，请参阅 [配置面板选项](v10-panels-configure-panel-options.md)。

## XY 图表选项
<a name="v10-panels-xychart-options"></a>

**序列映射**

设置序列数据在图表中的映射方式。
+ **自动**：从所有可用数据帧（或数据集）自动生成序列。您可以筛选以仅选择一个帧。
+ **手动**：通过从可用数据帧中进行选择来显式定义序列。

根据序列映射选择，**帧**、**X 字段**和 **Y 字段**选项会有所不同。自动和手动序列映射部分描述了这些不同的选项。

**自动序列映射选项**

当您选择**自动**作为序列映射模式时，以下选项已预先配置，但您也可以自己定义。
+ **帧**：默认情况下，XY 图表显示所有数据帧。您可以筛选以仅选择一个帧。
+ **X 字段**：选择 X 代表哪个字段。默认情况下，这是每个数据帧中的第一个数字字段。
+ **Y 字段**：设置 X 字段后，默认情况下，数据帧中剩余的所有数字字段都被指定为 Y 字段。您可以使用此选项显式选择要用于 Y 的字段。

  图表序列由 Y 字段生成。要更改 XY 图表中的序列，请覆盖 Y 字段。您在“大小”字段或“颜色”字段中使用的任何字段都不会生成序列。

  您也可以使用覆盖来单独排除 Y 字段。为此，请为要删除的每个 Y 字段添加具有以下属性的覆盖：
  + 覆盖类型：**带名称的字段**
  + 覆盖属性：**序列 > 隐藏在区域中**
  + 区域：**Viz**

**手动序列映射选项**

选择**手动**作为序列模式时，可以添加、编辑和删除序列。要管理序列，请选择**序列**字段。要重命名序列，请选择序列名称。

在**手动**模式下，必须设置以下选项：
+ **帧**：选择数据帧或数据集。您可以根据需要添加任意数量的帧。
+ **X 字段**：选择 X 代表哪个字段。
+ **Y 字段**：选择 Y 代表哪个字段。

**大小字段**

使用此选项可设置哪个字段的值控制图表中点的大小。该值相对于数据帧中所有值的最小值和最大值。

选择此选项后，您可以设置最小和最大点大小选项。

**颜色字段**

使用此选项可设置哪个字段的值控制图表中点的颜色。要使用**标准选项**下的颜色值选项，必须设置此字段。

通常，当图表中只显示一个序列时，会使用此选项。

**Show (显式)**

设置值在可视化中的表示方式。
+ **点**：将值显示为点。选择此选项后，还会显示点大小选项。
+ **线**：在值之间添加一条线。选择此选项时，还会显示线条样式和线宽选项。
+ **二者**：同时显示点和线。

**点大小**

设置图表中所有点的大小，直径从 1 到 100 像素不等。默认大小为 5 像素。您可以设置覆盖以按序列（Y 字段）设置像素大小。

**最小/最大点大小**

设置**大小字段**选项后，使用这些选项来控制最小或最大点大小。您可以为特定序列覆盖这些选项。

**线型**

设置线条样式。要更改颜色，请使用标准颜色方案字段选项。
+ **实线**：显示实线。这是默认设置。
+ **虚线**：显示虚线。选择此选项时，将显示一个下拉列表，您可以在其中选择虚线的长度和间隙设置。默认情况下，长度和间隙设置为 `10, 10`。
+ **点**：显示虚线。选择此选项时，将显示一个下拉列表，您可以在其中选择点间距。默认情况下，点间距设置为 `0, 10`（第一个数字代表点长，且始终为零）。

**线宽**

设置线条的宽度（像素）。

## 工具提示选项
<a name="v10-panels-xychart-tooltipoptions"></a>

工具提示选项控制将鼠标悬停在图形中的数据点上时显示的信息叠加。

**工具提示模式**
+ **单个**：悬停工具提示仅显示一个序列，即您将鼠标悬停在上面的序列。
+ **隐藏**：与可视化交互时不显示工具提示。

使用覆盖从工具提示隐藏单个序列。

**最大高度**

设置工具提示框的最大高度。默认为 600 像素。

## 图例选项
<a name="v10-panels-xychart-legendoptions"></a>

图例选项控制显示在图形下方或右侧的序列名称和统计数据。有关图例的更多信息，请参阅 [配置图例](v10-panels-configure-legend.md)。

**可见性**

切换开关以打开或关闭图例。

**Mode (模式)**

使用这些设置可定义图例在可视化中的显示方式。
+ **列表**：以列表形式显示图例。这是图例的默认显示模式。
+ **表**：以表的形式显示图例。

**放置**

选择显示图例的位置。
+ **底部**：显示在图形下方。
+ **右**：显示在图形右侧。

**值**

选择要在图例中显示的[标准计算](v10-panels-calculation-types.md)。可以有多个。

**Width (宽度)**

控制图例放置在可视化右侧时的宽度。只有将图例放置设置为**右**时，才会显示此选项。

## 轴选项
<a name="v10-panels-xychart-axis"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

轴类别下的选项会更改 x 和 y 轴的渲染方式。某些选项只有在您编辑的字段选项框外部单击后才会生效。也可以按 `Enter` 键。

**放置（y 轴）**

设置 Y 轴的放置。选项包括：
+ **自动**：自动为序列分配 y 轴。当有两个或多个具有不同单位的序列时，Grafana 将左轴分配给第一个单位，将右轴分配给下一个单位。
+ **左**：在左侧显示所有 y 轴。
+ **右**：在右侧显示所有 y 轴。
+ **隐藏**：隐藏所有轴。

要有选择地隐藏轴，请针对特定字段[添加字段覆盖](v10-panels-configure-overrides.md)。

**标签**

设置 y 轴文本标签。如果有多个 y 轴，可使用覆盖分配不同的标签。

**Width (宽度)**

设置轴的固定宽度。默认情况下，Grafana 会动态计算轴的宽度。

通过设置轴的宽度，具有不同轴类型的数据可以共享相同的显示比例。此设置让您更容易比较多个图形的数据，因为轴在视觉上不会相互错位或拉伸。

**显示网格线**

设置轴网格线的可见性。
+ **自动**：根据数据的密度自动显示网格线。
+ **开**：始终显示网格线。
+ **关**：从不显示网格线。

**Color (颜色)**

设置轴的颜色
+ **文本**：根据主题文本颜色设置颜色。
+ **序列**：根据序列颜色设置颜色。

**显示边框**

设置轴边框的可见性。

**Scale**

设置 y 轴刻度。
+ **线性**：将刻度分成相等的部分。
+ **对数**：使用对数刻度。选择此选项时，会出现一个列表，供您选择二进制（以 2 为基数）或通用（以 10 为基数）对数刻度。
+ **Symlog**：使用对称的对数刻度。选择此选项时，会出现一个列表，供您选择二进制（以 2 为基数）或通用（以 10 为基数）对数刻度。线性阈值选项允许您设置刻度从线性变为对数的阈值。

*居中零点*

将 y 轴设置为居中零点。

**软最小值和软最大值**

设置**软最小值**或**软最大值**选项，以更好地控制 y 轴限制。默认情况下，Grafana 会根据数据集自动设置 y 轴的范围。

软最小值和软最大值设置可防止数据中的微小变化在基本平坦时被放大。相比之下，硬最小值和最大值有助于通过将间歇性尖峰剪过特定点来防止掩盖数据中的有用细节。

要定义 y 轴的硬限制，请设置标准 min/max 选项。有关更多信息，请参阅[配置标准选项](v10-panels-configure-standard-options.md)。

**转换**

使用此选项可转换序列值，而不会影响工具提示、上下文菜单或图例中显示的值。您有两个转换选项：
+ **负 Y 转换**：将结果翻转为 Y 轴上的负值。
+ **常量**：将第一个值显示为常量线。

**注意**  
转换选项只能作为覆盖选项使用。

**显示多个 y 轴**

在某些情况下，您希望显示多个 y 轴。例如，如果您有一个数据集，显示一段时间内的温度和湿度，则可能需要为这两个序列显示两个具有不同单位的 y 轴。

要显示多个 y 轴，请[添加字段覆盖](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field)。根据需要多次执行这些步骤，以添加任意数量的 y 轴。

## 标准选项
<a name="v10-panels-xychart-standard"></a>

面板编辑器中的**标准选项**可以让您更改字段数据在可视化中的显示方式。设置标准选项后，更改会应用于所有字段或序列。有关对字段显示的更精细控制，请参阅 [配置字段覆盖](v10-panels-configure-overrides.md)。

您可以自定义以下标准选项：
+ **字段最小值/最大值**：启用**字段最小值/最大值**，让 Grafana 根据字段的最小值或最大值单独计算每个字段的最小值或最大值。
+ **颜色方案**：为整个可视化设置一种或多种颜色。

有关更多信息，请参阅 [配置标准选项](v10-panels-configure-standard-options.md)。

## 数据链接
<a name="v10-panels-xychart-datalinks"></a>

数据链接让您可以链接到其他面板、控制面板和外部资源，同时保持来源面板的上下文。您可以创建包含序列名称甚至光标下值的链接。

对于每个数据链接，请设置以下选项：
+ **标题**
+ **URL**
+ **在新选项卡中打开**

有关更多信息，请参阅 [配置数据链接](v10-panels-configure-data-links.md)。

## 字段覆盖
<a name="v10-panels-xychart-fieldoverrides"></a>

您可以通过覆盖自定义特定字段或序列的可视化设置。添加覆盖规则时，您可以针对一组特定的字段，并为这些字段的显示方式定义多个选项。

请选择以下覆盖选项之一：
+ **带名称的字段**：从所有可用字段列表中选择一个字段。
+ **名称与正则表达式匹配的字段**：使用该选项来指定要用正则表达式覆盖的字段。
+ **带类型的字段**：使用该选项可以按类型选择字段，例如字符串、数值或时间。
+ **查询返回的字段**：选择特定查询返回的所有字段。
+ **带值的字段**：选择定义的 reducer 条件返回的所有字段，例如**最小值**、**最大值**、**计数**或**总计**。

有关更多信息，请参阅 [配置字段覆盖](v10-panels-configure-overrides.md)。