

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

# 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)。