

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

# 面板
<a name="Grafana-panels"></a>

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

该面板是 Grafana 服务器中的基本可视化构建块。面板是一个或多个查询的可视表示，但少数特殊用途面板除外。查询显示一段时间内的数据。所显示数据的范围从温度波动到当前服务器状态，再到日志或警报列表。

每个面板都有一个特定于面板中所选数据来源的查询编辑器。查询编辑器允许您提取可视化效果以显示在面板上。



要显示数据，您的工作区中必须至少有一个数据来源。有关数据来源的详细信息，请参阅 [连接到数据来源](AMG-data-sources.md)。

每个面板都有各种各样的样式和格式选项。可以拖动面板、将其重新排列和调整其大小。

**Topics**
+ [添加面板](add-a-panel-to-a-dashboard.md)
+ [删除面板](Deleting-a-panel.md)
+ [查询](panel-queries.md)
+ [已记录查询](recorded-queries.md)
+ [转换](panel-transformations.md)
+ [字段选项和覆盖](field-options-overrides.md)
+ [面板编辑器](AMG-panel-editor.md)
+ [库面板](AMG-library-panel.md)
+ [可视化](AMG-visualizations.md)

# 添加面板
<a name="add-a-panel-to-a-dashboard"></a>

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

 您可以使用面板，以可视化形式显示数据。本主题将引导您完成构建面板的基本步骤。

**要将面板添加到控制面板**

1.  选择要向其中添加面板的控制面板。

1.  选择**添加面板**图标。

1.  选择**添加新面板**。

    Grafana 工作区会创建一个空的图表面板，并在其中选择您的默认数据来源。

1.  我们建议您为面板添加有用的标题和描述（虽然这不是必需操作）。您可以选择使用在任一字段中定义的变量，但不能使用全局变量。有关更多信息，请参阅 [模板和变量](templates-and-variables.md)。
   + **面板标题**：在此字段中输入的文本将显示在面板编辑器和控制面板中面板的顶部。
   + **描述**：在此字段输入的文本将显示在面板左上角的工具提示中。请为面板和要显示的数据编写描述。

1. 为面板编写查询。要显示可视化结果，每个面板至少需要一个查询。您可以在面板编辑器的**查询**选项卡上编写查询。有关更多信息，请参阅 [查询](panel-queries.md)。

   1. 选择一个数据来源。在**查询**选项卡的第一行，选择下拉列表，查看所有可用的数据来源。此列表包括您添加的所有数据来源。有关数据来源的详细信息，请参阅 [连接到数据来源](AMG-data-sources.md)。

   1. 使用数据来源的查询语言编写或构造查询。选项会有所不同。有关具体指南，请参阅特定数据来源的文档。

1.  在**面板**选项卡的**可视化**部分，选择一种可视化类型。Grafana 工作区将显示应用了该可视化类型的查询结果预览。

1. 我们建议您在选择**保存**之前，添加备注来描述您的更改。如果您需要将控制面板恢复到以前的版本，注释会很有帮助。

1.  要保存控制面板，请在屏幕右上角选择**保存**。

# 删除面板
<a name="Deleting-a-panel"></a>

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

要删除 Grafana 中的面板，请完成以下步骤：
+  选择面板标题旁边的下拉列表并选择**移除面板**。

或者
+ 将指针悬停在面板上，然后使用键盘快捷键序列 "p r"。

# 查询
<a name="panel-queries"></a>

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

 Grafana 工作区面板使用*查询*与数据来源进行通信，以获取用于可视化的数据。查询是用数据来源使用的查询语言编写的问题。如果查询格式正确，则数据来源会做出响应。在面板数据来源选项中，您可以调整向数据来源发送查询的频率以及收集的数据点数量。

 Grafana 工作区每个面板最多支持 26 个查询。

## 查询编辑器
<a name="query-editors"></a>

 查询编辑器是帮助您编写查询的表单。根据您的数据来源，查询编辑器可能会提供自动完成功能、指标名称或变量建议。

 由于查询语言之间的差异，数据来源的查询编辑器可能看起来有所不同。

## 查询语法
<a name="query-syntax"></a>

 数据来源有不同的查询语言和语法来请求数据。以下是两个查询示例。

 **PostgreSQL** 

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

 **PromQL** 

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

 有关为数据来源编写查询的详细信息，请参阅该数据来源的文档。[连接到数据来源](AMG-data-sources.md) 中列出了数据来源。

## 查询选项卡 UI
<a name="query-tab-ui"></a>

 **查询**选项卡由以下元素组成：
+  数据来源选择器 
+  查询选项 
+  查询检查器按钮 
+  查询编辑器列表 

### 数据来源选择器
<a name="data-source-selector"></a>

 数据来源选择器是一个下拉列表。选择它可选择已添加的数据来源。创建面板时，Amazon Managed Grafana 会自动选择您的默认数据来源。有关数据来源的详细信息，请参阅 [连接到数据来源](AMG-data-sources.md)。

 除了您在 Grafana 工作区中配置的数据来源外，还有三个特殊的数据来源可用。
+ **TestDataDB** — 生成随机游走数据的内置数据源。Grafana 数据来源对于测试可视化和运行实验非常有用。
+  **混合**：用于在同一面板中查询多个数据来源的数据来源。选择此数据来源后，您可以为添加的每个新查询选择一个数据来源。
  +  第一个查询将使用在您选择**混合**之前选择的数据来源。
  +  您不能将现有查询更改为使用混合数据来源。
+ **控制面板**：用于在同一控制面板中使用来自其他面板的结果集的数据来源。

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

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

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

 可以使用以下面板中的数据来源查询选项：
+  **最大数据点数**：如果数据来源支持该选项，则为返回的每个序列设置最大数据点数。如果查询返回的数据点数超过了最大数据点设置，则数据来源会合并这些数据点（通过按平均值或最大值或其他函数将它们聚合在一起来减少返回的数据点数）。

   限制点数的主要原因有两个：性能和让线变得平滑。默认值为图表的宽度（或像素数），这样可以避免数据点数超过图形面板所能显示的数量。

   对于流式处理数据，最大数据点值用于滚动缓冲区。（流式处理是一种持续的数据流，而缓冲是将数据流分成块的一种方式）。
+  **最小间隔**：为自动计算的间隔设置最小限制，通常是最小抓取间隔。如果每 15 秒保存一次数据点，则无需将间隔设置为小于该间隔。另一个用例是将其设置为比抓取间隔更高的最小值，以获得更粗粒度、运行更良好的查询。
+  **间隔**：按时间对数据点进行聚合或分组时可以使用的时间范围。

   Amazon Managed Grafana 会自动计算适当的间隔，该间隔可用作模板化查询中的变量。变量要么以秒为单位：`$__interval`；要么以毫秒为单位：`$__interval_ms`。它通常用于聚合函数，例如 `sum` 或 `average`。例如，这是一个使用间隔变量 `rate(http_requests_total[$__interval])` 的 Prometheus 查询。

   此自动间隔是根据图形的宽度计算的。如果用户缩小很多，则间隔会变大，从而获得更粗粒度的聚合。如果用户放大，则间隔会缩短，从而获得更细粒度的聚合。

   有关更多信息，请参阅 [全局变量](variables-types.md#global-variables)。
+  **相对时间**：覆盖各个面板的相对时间范围，使它们与控制面板右上角控制面板时间选择器中所选择的时间不同。这使您能够在同一个控制面板上显示不同时间段或日期的指标。
+  **时间移位**：提供另一种方法来覆盖各个面板的时间范围。此功能仅适用于相对时间范围，您可以调整时间范围。

   例如，您可以将面板的时间范围移至比控制面板时间选择器早 2 小时。有关更多信息，请参阅 [时间范围控件](dashboard-time-range-controls.md)。
+  **缓存超时**：（仅当此字段在您的数据来源中可用时，您才能看到它。） 如果您的时间序列存储具有查询缓存，则覆盖默认的缓存超时。它被指定为以秒为单位的数值。

### 查询检查器按钮
<a name="query-inspector-button"></a>

 您可以选择**查询检查器**来打开面板检查器的**查询**选项卡。在**查询**选项卡上，您可以看到面板发送的查询请求以及响应。

 选择**刷新**可查看此面板向服务器发送的请求的全文。

**注意**  
 在查询检查器返回结果之前，您需要至少添加一个查询。

 有关面板检查器的详细信息，请参阅 [检查面板](inspect-a-panel.md)。

### 查询编辑器列表
<a name="query-editor-list"></a>

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

## 在面板之间共享查询结果
<a name="share-query-results-between-panels"></a>

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

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

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

**要与另一个面板共享数据来源查询**

1.  创建控制面板。有关更多信息，请参阅 [创建控制面板](getting-started-grafanaui.md#create-a-dashboard)。

1.  添加面板。有关更多信息，请参阅 [添加面板](add-a-panel-to-a-dashboard.md)。

1.  将标题更改为 **Source panel**。您将使用此面板作为其他面板的来源。定义要共享的一个或多个查询。如果您目前没有可用的数据来源，则可以使用 **Grafana** 数据来源，它会返回一个可用于测试的随机时间序列。

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

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

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

 要转到定义查询的面板，请选择该查询。

# 已记录查询
<a name="recorded-queries"></a>

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

您可以通过使用已记录查询按设定的间隔拍摄数据点的快照，从而查看一段时间内的趋势。这可以让您深入了解历史趋势。

对于不返回时间序列的插件，绘制历史数据可能会很有用。例如，您可能想通过查询**ServiceNow**来查看请求响应时间的历史记录，但它只能返回当前 point-in-time指标。

## 已记录查询是如何运作的
<a name="how-recorded-queries-work"></a>

已记录查询仅适用于后端数据来源插件。有关详细信息，请参阅[后端数据来源插件](https://grafana.com/tutorials/build-a-data-source-backend-plugin/)。您可以记录三种类型的查询：
+ 单行和列：返回单行和单列的查询。
+ 行计数：返回有意义的行计数的查询。
+ 表达式：任意表达式。要了解有关创建和使用表达式的更多信息，请参阅 [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)。

创建或启用已记录查询后，它会立即创建快照并继续按设定的时间间隔创建快照。当已记录查询被禁用、删除或 Grafana 未运行时，该查询会停止拍摄快照。通过运行已记录查询并将每个结果转发到启用了远程写入功能的 Prometheus 实例，在后端收集数据点。

**注意**  
必须先配置 Prometheus 数据来源并将其与远程写入目标相关联，然后才能使用已记录查询。

## 创建已记录查询
<a name="create-a-recorded-query"></a>

要创建已记录查询，请完成以下步骤：

1. 在编辑面板中查找或创建要在控制面板上记录的查询。该查询只能返回一行和一列。如果返回的结果更多，您仍然可以使用*计数*选项记录返回的结果数。查询的数据来源必须是后端数据来源。表达式可用于聚合来自时间序列查询的数据。要了解有关创建和使用表达式的更多信息，请参阅[表达式](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)。

1. 选择位于查询编辑器中的**记录查询**菜单。

1. 输入已记录查询信息。除非另有说明，否则所有字段均为必填字段。
   + 名称：已记录查询的名称。
   + 描述：（可选）描述您希望已记录查询在已记录查询列表中的显示方式。
   + 间隔：拍摄快照的时间间隔。该间隔从您创建已记录查询时开始，如果您暂停或删除已记录查询，则间隔停止。有关暂停和删除已记录查询的更多信息，请参阅[管理已记录查询](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries)。
   + 范围：查询的相对时间范围。如果您选择的范围为 30m，间隔为 1h，则查询将在过去 30 分钟内每小时拍摄一次快照。
   + 对查询结果计数：如果您想对查询返回的行数进行计数，请启用此选项。如果此选项处于关闭状态，则您的查询必须返回一行，其中包含一个值。

1. 选择测试已记录查询按钮，测试您的已记录查询。

1. 选择**开始记录查询**。

## 添加已记录查询
<a name="Adding-a-recorded-query"></a>

您可以将现有的已记录查询添加到控制面板中的面板。对于您添加的每个已记录查询，都会创建一个 Prometheus 查询：`generated_recorded_query_name{id="generated_id", name="recorded query name"}`。从 Prometheus 创建的查询会返回所有已记录查询中收集的快照。

1. 在控制面板中导航到要在其中添加已记录查询的面板。

1. 选择 **\$1 已记录查询**菜单。

1. 如果要按数据来源筛选已记录查询，请从“按数据来源筛选”下拉菜单中选择一个数据来源。

1. 在已记录查询上选择**添加**菜单，将其添加到面板中。

在将已记录查询添加到面板后，面板数据来源将变为 `-- Mixed --`。您的已记录查询由 `Prometheus` 查询表示，其中名称标签与已记录查询名称相匹配。要了解有关 Prometheus 数据来源的更多信息，请参阅 [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/)。

如果在添加已记录查询后，出现了包含 `-- Mixed --` 数据来源而不是 Prometheus 数据来源的查询，则可能意味着没有为已记录查询设置 `Prometheus ` 远程写入目标。要设置远程写入点，请参阅[远程写入目标](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target)。

## 使用已记录查询
<a name="using-a-recorded-query"></a>

要使用已记录查询，请创建一个查询并将其添加到控制面板中。之后，可以在**已记录查询**选项卡的**首选项**中对其进行管理。

## 管理已记录查询
<a name="managing-recorded-queries"></a>

可以从“首选项”的“已记录查询”选项卡中暂停或激活已记录查询，也可以删除已记录查询。删除已记录查询会将其从 Grafana 中移除，但在 Prometheus 中收集的信息仍然存在。在恢复已记录查询之前，暂停已记录查询将不再收集新的数据点。

## 远程写入目标
<a name="remote_write_target"></a>

远程写入目标是写入已记录查询数据点的 **Prometheus** 数据来源。您需要启用了远程写入功能的 Prometheus，而且您需要为该 Prometheus 创建一个数据来源。

要编辑远程写入目标，请在**首选项**的**已记录查询**选项卡的控制台菜单中选择**编辑远程写入目标**。选择已启用远程写入功能 **Prometheus** 数据来源，然后输入远程写入路径。

# 转换
<a name="panel-transformations"></a>

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

在结果集传递到可视化之前，转换会对其进行处理。您可以在 Amazon Managed Grafana 面板编辑器的**转换**选项卡中访问转换。

您可以使用转换来重命名字段，将单独的时间序列联接在一起，跨查询进行数学运算等。如果您的控制面板很大，或者查询量很大，那么能够将查询结果从一个面板复用到另一个面板可以带来巨大的性能提升。

**注意**  
转换有时会导致无法对数据绘图。发生这种情况时，Amazon Managed Grafana 会显示有关可视化的建议。选择建议以切换到表可视化。这通常可以帮助您更好地了解转换对您的数据执行了哪些操作。

Amazon Managed Grafana 按照屏幕上列出的顺序应用转换。每次转换都会创建一个新的结果集，该结果集将传递给管道中的下一个转换。

该顺序可以对结果的显示效果产生巨大影响。例如，如果您使用减少转换将一列的所有结果压缩为单个值，则只能对该单个值应用转换。

**先决条件**

在应用转换之前，必须满足以下所有条件：
+ 您已输入查询并从数据来源返回数据。有关查询的详细信息，请参阅[查询](panel-queries.md)。
+ 您应用了支持查询的可视化，例如以下可视化之一：
  + 条形仪表
  + 计量表
  + 图表
  + 热图
  + 日志
  + Stat
  + 表

## 应用转换
<a name="apply-a-transformation"></a>

 可以在面板编辑器底部窗格的**转换**选项卡（位于**查询**选项卡旁边）进行转换。

**要应用转换**

1.  在要添加转换的面板上，选择面板标题，然后选择**编辑**。

1.  选择 **Transform (转换)** 选项卡。

1.  选择一个转换。

    在出现的转换行中，您可以配置转换选项。

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

 如果您遇到问题，请选择调试图标来[调试您的转换](#debug-transformations)。

 要移除转换，请选择垃圾桶图标。

## 转换类型和选项
<a name="transformation-types-and-options"></a>

 Grafana 工作区包括以下转换。

**Topics**
+ [Reduce](#reduce)
+ [合并](#merge)
+ [按名称筛选](#filter-by-name)
+ [按查询筛选数据](#filter-data-by-query)
+ [整理字段](#organize-fields)
+ [按字段联接（外部联接）](#join-by-field-outer-join)
+ [从计算添加字段](#add-field-from-calculation)
+ [标签到字段](#labels-to-fields)
+ [分组依据](#sort-by)
+ [分组依据](#group-by)
+ [序列到行](#series-to-rows)
+ [按值筛选数据](#filter-data-by-value)
+ [调试转换](#debug-transformations)

### Reduce
<a name="reduce"></a>

 如果要将结果简化为一个值，请应用**减少**转换。减少基本上移除了时间部分。如果可视化为表，则会将一列较少为一行（值）。

 在**计算**字段中，输入一种或多种计算类型。选择以查看计算选项的列表。有关可用计算的信息，请参阅 [计算列表](list-of-calculations.md)。

在您选择了至少一个计算后，Amazon Managed Grafana 会使用您选择的计算显示一个值。如果选择多个计算，则显示多个值。

### 合并
<a name="merge"></a>

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

 在以下示例中，两个查询返回表数据。在应用转换之前，数据会被可视化为两个单独的表。

查询 A


|  时间  |  任务  |  正常运行时间  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  节点  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  123001233  | 

查询 B


|  时间  |  任务  |  错误  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  节点  |  15  | 
|  2020-07-07 11:24:20  |  postgre  |  5  | 

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


|  时间  |  任务  |  错误  |  正常运行时间  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  节点  |  15  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  5  |  123001233  | 

### 按名称筛选
<a name="filter-by-name"></a>

 使用此转换可以移除部分查询结果。

 Amazon Managed Grafana 显示**标识符**字段，后面是您的查询返回的字段。

 您可以通过以下两种方式之一应用筛选器：
+  输入正则表达式。
+  选择一个字段以切换对该字段的筛选。筛选后的字段显示为深灰色文本，未筛选的字段包含白色文本。

### 按查询筛选数据
<a name="filter-data-by-query"></a>

 如果您想要隐藏一个或多个查询，请在包含多个查询的面板中使用此转换。

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

### 整理字段
<a name="organize-fields"></a>

 使用此转换可以重命名、重新排序或隐藏查询返回的字段。

**注意**  
 此转换仅适用于具有单个查询的面板。如果您的面板有多个查询，则必须应用**按字段联接（外部联接）**转换或移除多余的查询。

 Amazon Managed Grafana 会显示查询返回的字段列表。您可以进行以下任意更改：
+  通过将光标悬停在字段上来更改字段顺序。光标变成一只手，然后您可以将该字段拖到新的位置。
+  通过选择字段名称旁边的眼睛图标隐藏或显示字段。
+  通过在**重命名**框中键入新名称来重命名字段。

### 按字段联接（外部联接）
<a name="join-by-field-outer-join"></a>

 使用此转换可以按字段联接结果集中的多个时间序列。

 如果要合并查询以便能够计算字段的结果，则此转换非常有用。

### 从计算添加字段
<a name="add-field-from-calculation"></a>

 使用此转换可以添加一个根据其他两个字段计算得出的新字段。每次转换都允许您添加一个新字段。
+  **模式**：选择一种模式：
  +  **减少行**：对选定字段的每一行分别应用所选计算。
  +  **二元选项**：对两个选定字段的单行中的值应用基本的数学运算（`sum`、`multiply` 等等）。
+  **字段名称**：选择要在新字段的计算中使用的字段名称。
+  **计算**：选择在 Amazon Managed Grafana 创建新字段时使用的计算。选择该字段以查看计算选项列表。有关可用计算的信息，请参阅 [计算列表](list-of-calculations.md)。
+  **别名**：（可选）输入新字段的名称。如果将此项保留为空，则将对该字段命名以与计算匹配。
+  **替换所有字段**：（可选）如果您想在可视化中隐藏所有其他字段并仅显示经过计算字段，请使用此选项。

### 标签到字段
<a name="labels-to-fields"></a>

**注意**  
 要应用此转换，您的查询需要返回带标签的字段。

 当您选择此转换时，Amazon Managed Grafana 会自动将所有带标签的数据转换为字段。

 例如，假设有一个查询结果包含两个时间序列。

 1：标签 Server=Server A、Datacenter=EU 2：标签 Server=Server B、Datacenter=EU 

 该转换会生成以下表。


|  时间  |  服务器  |  Datacenter  |  值  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  Server A  |  EU  |  1  | 
|  2020-07-07 11:34:20  |  Server B  |  EU  |  2  | 

 **值字段名称**；如果您选择 `Server` 作为**值字段名称**，则 `Server` 标签的每个值都将获得一个字段。


|  时间  |  Datacenter  |  Server A  |  Server B  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  EU  |  1  |  2  | 

### 分组依据
<a name="sort-by"></a>

此转换按已配置的字段对每个帧进行排序。选中 `reverse` 后，将按相反的顺序返回值。

### 分组依据
<a name="group-by"></a>

 此转换按指定的字段（列）值对数据进行分组，并处理每个组的计算。可用的计算与减少转换的计算相同。

 以下是原始数据的示例：


|  时间  |  Server ID  |  CPU 温度  |  服务器状态  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  server 1  |  80  |  关闭  | 
|  2020-07-07 11:34:20  |  server 3  |  62  |  OK  | 
|  2020-07-07 10:32:20  |  server 2  |  90  |  过载  | 
|  2020-07-07 10:31:22  |  server 3  |  55  |  正常  | 
|  2020-07-07 09:30:57  |  server 3  |  62  |  Rebooting  | 
|  2020-07-07 09:30:05  |  server 2  |  88  |  OK  | 
|  2020-07-07 09:28:06  |  server 1  |  80  |  OK  | 
|  2020-07-07 09:25:05  |  server 2  |  88  |  OK  | 
|  2020-07-07 09:23:07  |  server 1  |  86  |  OK  | 

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


|  时间  |  Server ID  |  CPU 温度  |  服务器状态  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  server 1  |  80  |  关闭  | 
|  2020-07-07 09:28:06  |  server 1  |  80  |  OK  | 
|  2020-07-07 09:23:07  |  server 1  |  86  |  OK  | 

```
2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting
```

包含相同 `Server ID` 值的所有行将分组在一起。

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


|  Server ID  |  CPU 温度（平均值）  | 
| --- | --- | 
|  server 1  |  82  | 
|  server 2  |  88.6  | 
|  server 3  |  59.6  | 

您可以添加多个计算。例如，您可以使用以下计算。
+  对于字段 `Time`，您可以计算*上次*值，以了解每台服务器上一个数据点的接收时间。
+  对于字段 `Server Status`，您可以计算*上次*值以了解每台服务器上一次的状态值。
+  对于字段 `Temperature`，您还可以计算*上次*值以了解每台服务器的最新监控温度。

 分组依据转换会产生以下结果。


|  Server ID  |  CPU 温度（平均值）  |  CPU 温度（上个值）  |  时间（上个值）  |  服务器状态（上个值）  | 
| --- | --- | --- | --- | --- | 
|  server 1  |  82  |  80  |  2020-07-07 11:34:20  |  关闭  | 
|  server 2  |  88.6  |  90  |  2020-07-07 10:32:20  |  过载  | 
|  server 3  |  59.6  |  62  |  2020-07-07 11:34:20  |  OK  | 

使用此转换，您可以从时间序列中提取一些关键信息，并以便捷的方式显示这些信息。

### 序列到行
<a name="series-to-rows"></a>

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

此转换的结果将包含三列：`Time`、`Metric` 和 `Value`。添加该 `Metric` 列是为了让您可以看到该指标来自哪个查询。通过在来源查询上定义 `Label` 来自定义此值。

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

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

 应用 `Series to rows` 转换会产生以下结果。


|  时间  |  指标  |  值  | 
| --- | --- | --- | 
|  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="filter-data-by-value"></a>

此转换允许您直接在 Grafana 工作区中筛选数据，并从查询结果中移除一些数据点。您可以选择包含或排除与您定义的一个或多个条件相匹配的数据。这些条件将应用于选定的字段。

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

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

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

您可以向筛选器添加多个条件。当您有多个条件时，可以选择是否要对与添加的所有或任何条件匹配的行应用包含或排除操作。

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

### 调试转换
<a name="debug-transformations"></a>

要查看转换的输入和输出结果集，请选择转换行右侧的调试图标。

 Amazon Managed Grafana 在转换行下方显示转换调试视图。

# 字段选项和覆盖
<a name="field-options-overrides"></a>

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

 本节介绍了 Amazon Managed Grafana 中的字段选项和字段覆盖以及如何使用它们。

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

 字段选项允许您更改数据在可视化中的显示方式。您应用的选项和覆盖不会更改数据，它们会改变 Amazon Managed Grafana 显示数据的方式。

## 字段选项
<a name="field-options-overview"></a>

 可以在面板编辑器的**字段**选项卡上找到*字段选项*（标准和自定义）。在此选项卡上所做的更改适用于所有字段（即序列和列）。例如，如果将单位更改为百分比，则所有带有数值的字段都将以百分比显示。要了解如何应用字段选项，请参阅[配置所有字段](#configure-all-fields)。

## 字段覆盖
<a name="field-overrides-overview"></a>

 可以在面板编辑器的**覆盖**选项卡上添加*字段覆盖*。您可以在此处添加与**字段**选项卡上相同的选项，但它们仅适用于特定字段。了解如何在 [配置特定字段](#configure-specific-fields) 中应用覆盖。

## 可用的字段选项和覆盖
<a name="available-field-options-and-overrides"></a>

 字段选项类型在字段选项和字段覆盖中都很常见。唯一的区别是更改将应用于所有字段（应用于**字段**选项卡）还是应用于字段的子集（应用于**覆盖**选项卡）。
+  [标准字段选项](#standard-field-options) 适用于所有允许转换的面板可视化。
+  [表字段选项](table-panel.md#table-field-options) 仅应用于表面板可视化。

### 配置所有字段
<a name="configure-all-fields"></a>

 要更改所有字段显示数据的方式，可以更改**字段**选项卡上的选项。然后，在**覆盖**选项卡上，您可以覆盖特定字段的字段选项。有关更多信息，请参阅 [配置特定字段](#configure-specific-fields)。

 例如，您可以通过更改**小数**选项来更改所有字段中显示的小数位数。有关选项的详细信息，请参阅 [标准字段选项](#standard-field-options) 和 [表字段选项](table-panel.md#table-field-options)。

#### 更改字段选项
<a name="change-a-field-option"></a>

 您可以根据需要更改任意数量的选项。

**要更改字段选项**

1.  选择要编辑的面板，选择面板标题，然后选择**编辑**。

1.  选择**字段**选项卡。

1.  找到要更改的选项。您可以定义以下内容：
   +  [标准字段选项](#standard-field-options)，适用于所有允许转换的面板可视化。
   +  [表字段选项](table-panel.md#table-field-options)，仅适用于表面板可视化。

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

1.  完成对控制面板的编辑后，选择**保存**。

#### 字段选项示例
<a name="field-option-example"></a>

 假设结果集是由两个字段组成的数据帧：时间和温度。


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

### 配置特定字段
<a name="configure-specific-fields"></a>

 您可以使用覆盖，更改一个或多个字段的设置。覆盖的字段选项与特定可视化中可用的字段选项完全相同。唯一的区别是您可以选择将它们应用于哪些字段。

 例如，您可以通过更改类型与**数值**匹配的**字段**的**小数**选项来更改所有数值字段或列中显示的小数位数。有关选项的更多信息，请参阅[标准字段选项](#standard-field-options)（适用于所有允许转换的面板可视化），以及[表字段选项](table-panel.md#table-field-options)（适用于表面板可视化）。

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

 您可以根据需要覆盖任意数量的字段选项。

**添加字段覆盖**

1.  选择要编辑的面板，选择面板标题，然后选择**编辑**。

1.  选择**覆盖**选项卡。

1.  选择**为以下对象添加覆盖**。

1.  选择要对其应用覆盖规则的字段。
   +  **带名称的字段**：使用该选项从所有可用字段的列表中选择一个字段。使用此选择器添加到规则中的属性仅应用于此单个字段。
   +  **名称与正则表达式匹配的字段**：使用该选项来指定要用正则表达式覆盖的字段。使用此选择器向规则添加的属性将应用于字段名称与正则表达式匹配的所有字段。
   +  **带类型的字段**：使用该选项可以按类型选择字段，例如字符串、数值等。使用此选择器添加到规则中的属性将应用于与所选类型匹配的所有字段。

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

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

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

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

1.  完成后，选择**保存**。

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

1.  选择包含待删除覆盖的“覆盖”选项卡。

1.  选择覆盖旁边的垃圾桶图标。

#### 字段覆盖示例
<a name="field-override-example"></a>

假设我们的结果集是一个由四个字段组成的数据帧：时间、高温、低温和湿度。


|  时间  |  高温  |  低温  |  湿度  | 
| --- | --- | --- | --- | 
|  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  | 

 让我们应用 [字段选项示例](#field-option-example) 中的字段选项来应用摄氏度单位并去掉小数位。这将产生以下表。


|  时间  |  高温  |  低温  |  湿度  | 
| --- | --- | --- | --- | 
|  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="standard-field-options"></a>

 本节介绍可用的字段选项。它们按字母顺序列出。

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

 除非您在正在编辑的字段选项框之外进行选择或按 Enter，否则大多数字段选项不会影响可视化。

 有关应用这些选项的详细信息，请参阅以下章节：
+  [配置所有字段](#configure-all-fields) 
+  [配置特定字段](#configure-specific-fields) 

#### 小数
<a name="decimals"></a>

 此选项设置呈现值时要包含的小数位数。留空，让 Amazon Managed Grafana 使用数据来源提供的小数位数。

 要更改此设置，请在字段中输入一个数字。

#### 数据链接
<a name="data-links-overview"></a>

 此选项控制值或可视化链接到的 URL。有关更多信息和说明，请参阅 [数据链接](data-links.md)。

#### 显示名称
<a name="display-name"></a>

 此选项设置所有字段的显示标题。可以在字段标题中使用变量。有关模板化和模板变量的更多信息，请参阅 [模板和变量](templates-and-variables.md)。

 当显示多个统计数据、字段或序列时，此字段控制每个统计数据中的标题。您可以使用诸如 `${__field.name}` 的表达式以仅在标题中使用序列名称或字段名称。

 假设有一个名为 Temp 的字段，标签为 \$1"Loc"="PBI", "Sensor"="3"\$1 


|  表达式语法  |  示例  |  渲染为  |  说明  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName\$1  |  与语法相同  |  Temp \$1Loc="PBI", Sensor="3"\$1  |  在 \$1\$1 中显示字段名称和标签（如果存在）。如果响应中只有一个标签键，那么对于标签部分，Amazon Managed 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="max"></a>

 此选项设置百分比阈值计算中使用的最大值。要根据所有序列和字段进行自动计算，请将此设置留空。

#### 最小值
<a name="min"></a>

 此选项设置百分比阈值计算中使用的最小值。要根据所有序列和字段进行自动计算，请将此设置留空。

#### 无值
<a name="no-value"></a>

 输入字段值为空或空值时 Amazon Managed Grafana 应显示的内容。

#### 单位
<a name="unit"></a>

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

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

 您也可以使用单位下拉列表来指定自定义单位、自定义前缀或后缀以及 date/time 格式。

 要选择自定义单位，请输入单位并选择下拉列表中的最后一个 `Custom: xxx` 选项。
+  `suffix:<suffix>` 表示应跟在值后面的自定义单位。
+  `time:<format>`用于自定义 date/time 格式；例如，`time:YYYY-MM-DD`。有关格式语法和选项，请参阅[显示](https://momentjs.com/docs/#/displaying/)。
+  `si:<base scale><unit characters>` 表示自定义 SI 单位；例如 `si: mF`。此选项稍微高级一点，因为您可以同时指定单位和来源数据比例。例如，如果您的来源数据表示为毫（千）单位，请在单位前面加上该 SI 比例字符。
+  `count:<unit>` 表示自定义计数单位。
+  `currency:<unit>` 表示自定义货币单位。

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

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

 Amazon Managed Grafana 有时可以解析字符串并将其显示为数字。要让 Amazon Managed Grafana 显示原始字符串，请创建一个字段覆盖并添加带有 `string` 单位的单位属性。

#### 颜色方案
<a name="color-scheme"></a>

 字段颜色选项定义了 Amazon Managed Grafana 如何为序列或字段着色。这里有多种工作方式不同的模式，它们的效用在很大程度上取决于当前选择的可视化效果。

 连续颜色模式使用相对于最小值和最大值的值百分比来插值颜色。
+  **单色**：使用颜色选择器设置的特定颜色。这在覆盖规则中最有用。
+  **来自阈值**：从匹配阈值派生的颜色。这对于计量表、统计数据和表可视化非常有用。

##### 按序列着色
<a name="color-by-series"></a>

 Amazon Managed Grafana 包含按序列定义颜色的配色方案。例如，这对于图形和饼图很有用。

##### 按值着色
<a name="color-by-value"></a>

 Amazon Managed Grafana 还包括连续（渐变）颜色方案。这对于为单个值着色的可视化非常有用；例如，统计面板和表面板。

#### Thresholds
<a name="thresholds-overview"></a>

 您可以使用阈值根据值更改字段的颜色。有关更多信息和说明，请参阅 [Thresholds](thresholds.md)。

#### 值映射
<a name="value-mapping"></a>

 您可以使用此选项来设置将字段值或值范围转换为显式文本的规则。您可以添加多个值映射。
+  **映射类型**：选择一个选项。
  +  **值**：输入值。如果字段值大于或等于该值，则显示**文本**。
  +  **从**和**至**：输入范围。如果字段值介于或等于该范围内的值，则会显示**文本**。
+  **文本**：字段中条件得到满足时显示的文本。此字段接受变量。

# 面板编辑器
<a name="AMG-panel-editor"></a>

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

 本主题介绍 Amazon Managed Grafana 面板编辑器的各个部分，并包含可查找更多信息的链接。

## 打开面板编辑器
<a name="open-the-panel-editor"></a>

 访问面板编辑器（也称为**编辑面板**屏幕、*编辑模式*或*面板编辑模式*）的方法有多种。
+  选择屏幕顶部的**添加面板**图标，然后选择**添加新面板**。新面板将在面板编辑器中打开。有关如何添加面板的更多信息，请参阅 [添加面板](add-a-panel-to-a-dashboard.md)。
+  选择现有面板的标题，然后选择**编辑**。面板将以编辑模式打开。
+  选择现有面板上的任意位置，然后按键盘上的 **e** 键。面板将以编辑模式打开。

## 调整面板编辑器分区的大小
<a name="resize-panel-editor-sections"></a>

 拖动可调整面板编辑器各分区的大小。如果侧窗格变得太窄，**面板**、**字段**和**覆盖**选项卡将变为下拉列表。

## 面板编辑器的各个部分
<a name="parts-of-the-panel-editor"></a>

 本节介绍面板编辑器屏幕的各个部分，以及与每个部分相关的字段、选项或任务的信息。

### 标题
<a name="header"></a>

 标题部分列出了面板所在控制面板的名称，以及一些控制面板命令。您也可以选择**返回**箭头，返回控制面板。

 在标题的右侧，有以下选项：
+  **控制面板设置（齿轮）图标**：选择该选项，可访问控制面板设置。
+  **丢弃**：选择该选项，将丢弃自上次保存控制面板之后，对面板所做的所有更改。
+  **保存**：选择该选项，将保存控制面板，包括在面板编辑器中所做的所有更改。
+  **应用**：选择该选项，将应用所做的更改，然后关闭面板编辑器，返回控制面板。还需要保存控制面板，以持久保留所应用的更改。

### 可视化预览
<a name="visualization-preview"></a>

 可视化预览部分包含查看选项、时间范围控件、可视化预览以及（如果适用）面板标题、坐标轴和图例。
+  **填充**：可视化预览会填充预览部分的可用空间。如果更改侧窗格的宽度或底部窗格的高度，可视化预览会适应并填充任何可用空间。
+  **适配**：可视化预览会填充可用空间，但保留面板的纵横比。
+  **精确**：可视化预览的大小与控制面板上的大小完全一致。如果可用空间不足，可视化大小会缩减，同时保留纵横比。
+  **时间范围控件**：有关更多信息，请参阅 [时间范围控件](dashboard-time-range-controls.md)。

### 数据部分（底部窗格）
<a name="data-section-bottom-pane"></a>

 数据部分包含用于输入查询、转换数据和创建警报规则（如适用）的选项卡。
+  **查询选项卡**：选择您的数据来源，并在此处输入查询。有关更多信息，请参阅 [查询](panel-queries.md)。
+  **转换选项卡**：应用数据转换。有关更多信息，请参阅 [转换](panel-transformations.md)。
+  **警报选项卡**：编写警报规则。有关更多信息，请参阅 [Grafana Alerting](alerts-overview.md)。

### 面板和字段选项（侧窗格）
<a name="panel-and-field-options-side-pane"></a>

 此部分包含的选项卡可用于控制数据可视化方式的几乎所有方面。并非所有选项卡都适用于每种可视化类型。

 这些选项卡的功能在以下主题中有记录：
+  [添加面板](add-a-panel-to-a-dashboard.md) 
+  [可视化](AMG-visualizations.md) 
+  [字段选项和覆盖](field-options-overrides.md) 
+  [面板链接](panel-links.md) 和 [数据链接](data-links.md)，可帮助您将可视化与其他资源关联起来 

# 库面板
<a name="AMG-library-panel"></a>

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

 库面板使用户能够创建可重复使用的面板，对库面板的一个实例所做的任何更改都会反映在每个控制面板上，并影响使用该面板的所有其他实例。这些面板可以保存在与控制面板相同的文件夹中，并简化面板在多个控制面板间的重复使用。

## 创建库面板
<a name="library-panel-create"></a>

**注意**  
创建库面板时，来源控制面板上的面板也将转换为库面板。转换面板后，您需要保存原始控制面板。

**创建库面板**

1. 像平常一样创建面板。您也可以使用现有面板。

1. 选择面板的标题并选择**编辑**。

1. 在面板显示选项侧的窗格中，选择向下箭头选项，对可视化进行更改。

1. 选择**库面板**，然后选择**创建新库面板**。

1. 输入库面板的名称，然后选择文件夹将其保存。

1. 选择**创建库面板**，然后保存控制面板。

您也可以使用任何面板的**共享**选项来创建库面板。

创建之后，您可以使用任何包含该库面板的控制面板来修改库面板。保存库面板更改后，库面板的所有实例都将反映这些修改。

## 添加库面板
<a name="library-panel-add"></a>

**向控制面板添加库面板**

1. 将鼠标悬停在左侧菜单中的 \$1 选项上，然后选择**创建**。

1. 选择**从面板库添加面板**。

1. 筛选库面板列表，找到想要的面板。

1. 选择该面板并将其添加到控制面板。

## 断开库面板的关联
<a name="library-panel-unlink"></a>

如果您要修改控制面板上的库面板，但不希望影响库面板的所有其他实例，您可以断开库面板的关联。

**要从控制面板断开库面板的关联**

1. 将鼠标悬停在左侧菜单的**控制面板**上，然后选择**库面板**。

1. 选择库面板。您将看到一个列表，列出所有使用该库面板的控制面板。

1. 选择要断开关联并更新的面板。

1. 选择面板的标题并选择**编辑**。

1. 选择**断开关联**。

## 删除库面板
<a name="library-panel-delete"></a>

在删除库面板之前，请确认该面板已不再在任何控制面板上使用。

**删除库面板**

1. 将鼠标悬停在左侧菜单的**控制面板**上，然后选择**库面板**。

1. 选择库面板。您将看到一个列表，列出所有使用该库面板的控制面板。

1. 选择要删除的面板。

1. 选择面板名称旁边的删除图标。

## 面板编辑器的各个部分
<a name="parts-of-the-panel-editor"></a>

 本节介绍面板编辑器屏幕的各个部分，以及与每个部分相关的字段、选项或任务的信息。

### 标题
<a name="header"></a>

 标题部分列出了面板所在控制面板的名称，以及一些控制面板命令。您也可以选择**返回**箭头，返回控制面板。

 在标题的右侧，有以下选项：
+  **控制面板设置（齿轮）图标**：选择该选项，可访问控制面板设置。
+  **丢弃**：选择该选项，将丢弃自上次保存控制面板之后，对面板所做的所有更改。
+  **保存**：选择该选项，将保存控制面板，包括在面板编辑器中所做的所有更改。
+  **应用**：选择该选项，将应用所做的更改，然后关闭面板编辑器，返回控制面板。还需要保存控制面板，以持久保留所应用的更改。

### 可视化预览
<a name="visualization-preview"></a>

 可视化预览部分包含查看选项、时间范围控件、可视化预览以及（如果适用）面板标题、坐标轴和图例。
+  **填充**：可视化预览会填充预览部分的可用空间。如果更改侧窗格的宽度或底部窗格的高度，可视化预览会适应并填充任何可用空间。
+  **适配**：可视化预览会填充可用空间，但保留面板的纵横比。
+  **精确**：可视化预览的大小与控制面板上的大小完全一致。如果可用空间不足，可视化大小会缩减，同时保留纵横比。
+  **时间范围控件**：有关更多信息，请参阅 [时间范围控件](dashboard-time-range-controls.md)。

### 数据部分（底部窗格）
<a name="data-section-bottom-pane"></a>

 数据部分包含用于输入查询、转换数据和创建警报规则（如适用）的选项卡。
+  **查询选项卡**：选择您的数据来源，并在此处输入查询。有关更多信息，请参阅 [查询](panel-queries.md)。
+  **转换选项卡**：应用数据转换。有关更多信息，请参阅 [转换](panel-transformations.md)。
+  **警报选项卡**：编写警报规则。有关更多信息，请参阅 [Grafana Alerting](alerts-overview.md)。

### 面板和字段选项（侧窗格）
<a name="panel-and-field-options-side-pane"></a>

 此部分包含的选项卡可用于控制数据可视化方式的几乎所有方面。并非所有选项卡都适用于每种可视化类型。

 这些选项卡的功能在以下主题中有记录：
+  [添加面板](add-a-panel-to-a-dashboard.md) 
+  [可视化](AMG-visualizations.md) 
+  [字段选项和覆盖](field-options-overrides.md) 
+  [面板链接](panel-links.md) 和 [数据链接](data-links.md)，可帮助您将可视化与其他资源关联起来 

# 可视化
<a name="AMG-visualizations"></a>

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

Amazon Managed Grafana 提供各种可视化功能，以适应不同的应用场景。以下各节列出了 Amazon Managed Grafana 中可用的可视化及其显示设置。

**Topics**
+ [警报列表面板](alert-list-panel.md)
+ [条形图面板](bar-chart-panel.md)
+ [条形仪表面板](alert-panel-bar-gauge-panel.md)
+ [时钟面板](clock-panel.md)
+ [控制面板列表面板](dashboard-list-panel.md)
+ [仪表面板](gauge-panel.md)
+ [Geomap 面板](AMG-Geomap.md)
+ [图形面板](graph-panel.md)
+ [热图](visualization-heatmap.md)
+ [直方图面板](histogram-panel.md)
+ [日志面板](logs-panel.md)
+ [新闻面板](news-panel.md)
+ [节点图形面板（测试版）](node-graph-panel.md)
+ [饼图面板](pie-chart-panel.md)
+ [Plotly 面板](plotly-panel.md)
+ [Sankey 面板](sankey-panel.md)
+ [散点面板](scatter-panel.md)
+ [统计面板](stat-panel.md)
+ [状态时间轴面板](state-timeline-panel.md)
+ [状态历史面板](status-history-panel.md)
+ [表面板](table-panel.md)
+ [文本面板](text-panel.md)
+ [时间序列面板](time-series-panel.md)
+ [Thresholds](thresholds.md)
+ [WindRose](windrose.md)
+ [检查面板](inspect-a-panel.md)
+ [计算列表](list-of-calculations.md)

# 警报列表面板
<a name="alert-list-panel"></a>

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

警报列表面板显示控制面板警报。您可以将列表配置为显示当前状态或最近的状态更改。有关警报的更多信息，请参阅 [Grafana Alerting](alerts-overview.md)。

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

## 选项
<a name="alert-list-panel-options"></a>
+  **显示**：选择面板应显示当前警报状态，还是最近的警报状态更改。
+  **最大项目数**：设置要列出的最大警报数。
+  **排序顺序**：选择显示警报的排序方式。
  +  **按字母顺序（升序）**：按字母顺序排列
  +  **按字母顺序（降序）**：按字母顺序倒序排列
  +  **重要性**：根据以下值，按重要性划分，其中 1 为最高：
    + 警报：1
    + 无数据：2
    + 待处理：3
    + 正常：4
    + 已暂停：5
+  **来自此控制面板的警报**：仅显示警报列表所在控制面板的警报。

## 筛选条件
<a name="alerts-panel-filter"></a>

使用以下选项筛选警报，使其与您选择的查询、文件夹或标签相匹配：
+  **警报名称**：输入警报名称查询。
+  **控制面板标题**：输入控制面板标题查询。
+  **文件夹**：选择一个文件夹。仅会显示所选文件夹中控制面板的警报。
+  **控制面板标签**：选择一个或多个标签。仅会显示带有一个或多个标签的控制面板的警报。

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

选择要在此面板中显示的警报状态。
+ 正常
+ 已暂停
+ 无数据
+ 执行错误
+ 警报
+ 待定

# 条形图面板
<a name="bar-chart-panel"></a>

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

通过此面板可视化，您可以绘制分类数据图形。

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

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


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

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

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

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

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

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

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

**显示值**

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

**组宽度**控制组的宽度。0=最小宽度，1=最大宽度。

**条形图宽度**控制条形图的宽度。0=最小宽度，1=最大宽度。

**线宽**控制条形图的线宽。

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

**渐变模式**设置渐变填充的模式。填充渐变基于线条颜色。要更改颜色，请使用标准颜色方案字段选项。渐变外观受填充不透明度设置的影响。
+  **无**：无渐变填充，这是默认设置。
+  **不透明度**：渐变的透明度是根据 y 轴上的值计算的。填充的不透明度随 Y 轴上的值增加而增加。
+  **色调**：渐变色是根据线条颜色的色调生成的。

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

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

**图例模式**：使用这些设置可以优化图例在可视化中的显示方式。
+  **列表**：以列表形式显示图例。这是图例的默认显示模式。
+  **表**：以表的形式显示图例。
+  **隐藏**：隐藏图例。

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

**图例计算**：选择要在图例中显示的标准计算。可以输入多个值。

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

**轴**：使用以下字段设置来优化轴的显示方式。除非您在正在编辑的字段选项框外部单击或按 Enter 键，否则某些字段选项不会影响可视化。
+  **放置**：设置 y 轴的放置。
+  **自动**：Grafana 会自动为序列分配 Y 轴。当有两个或多个具有不同单位的序列时，Grafana 将左轴分配给第一个单位，将右轴分配给下一个单位。
+  **左**：在左侧显示所有 Y 轴。
+  **右**：在右侧显示所有 Y 轴。
+  **隐藏**：隐藏所有 Y 轴。
+  **标签**：设置 Y 轴文本标签。如果有多个 Y 轴，可使用覆盖分配不同的标签。
+  **宽度**：设置轴的固定宽度。默认情况下，Grafana 会动态计算轴的宽度。

  通过设置轴的宽度，具有不同轴类型的数据可以共享相同的显示比例。这样就可以更容易比较多个图形的数据，因为轴在视觉上不会相互移动或拉伸。
+  **软最小值和软最大值**：设置软最小值或软最大值选项，以更好地控制 Y 轴限制。默认情况下，Grafana 会根据数据集自动设置 Y 轴的范围。

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

  您可以设置标准 min/max 选项来定义 Y 轴的硬限制。

# 条形仪表面板
<a name="alert-panel-bar-gauge-panel"></a>

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

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

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

## 数据和字段选项
<a name="bar-gauge-data-and-field-options"></a>

通过条形仪表可视化，您可以应用以下选项：
+  [转换](panel-transformations.md) 
+  [字段选项和覆盖](field-options-overrides.md) 
+  [Thresholds](thresholds.md) 

## 显示选项
<a name="bar-gauge-display-options"></a>

使用以下选项来优化您的可视化：
+  **显示**：选择 Amazon Managed Grafana 显示数据的方式。
  +  **计算**：显示基于所有行的计算值。有关可用计算的列表，请参阅 [计算列表](list-of-calculations.md)。
  +  **所有值**：为每行显示一个单独的统计数据。如果选择此选项，则还可以选择**限制**或要显示的最大行数。
+  **值**：选择 reducer 函数，Amazon Managed Grafana 将使用该函数将多个字段简化为单个值。选择**值**列表以查看函数和简要说明。
+  **方向**：选择堆叠方向。
  +  **自动**：Amazon Managed Grafana 会选择其认为最佳的方向。
  +  **水平**：从左到右水平拉伸条形图。
  +  **垂直**：从上到下垂直拉伸条形图。
+  **显示模式**：选择显示模式。
  +  **渐变**：选择阈值级别来定义渐变。
  +  **复古 LCD**：将仪表分成点亮或不点亮的小单元格显示。
  +  **基本**：根据匹配阈值使用单一颜色。
+  **显示未填充区域**：如果要将条形图的未填充区域渲染为深灰色，请选择此选项。此选项不适用于复古 LCD 显示模式。

# 时钟面板
<a name="clock-panel"></a>

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

时钟面板显示当前时间或倒计时。每秒更新一次。
+ **模式**：默认为**时间**。如果选择**倒计时**，请设置**倒计时截止时间**以开始倒计时。
+ **12 或 24 小时**：显示时间的选项有 12 小时制和 24 小时制。
+ **时区**：时区由时刻时区库提供。默认值为计算机上的时区。
+ **倒计时截止时间**：如果您已将**模式**设置为**倒计时**，请指定倒计时的时间和日期。
+ **倒计时结束文本**：指定倒计时结束时要显示的文本。
+ **日期/时间格式选项**-自定义字体大小、粗细和 date/time 格式。如果显示倒计时，但不想看到秒数减少，请将时间格式更改为 24 小时制 `hh:mm` 或 12 小时制 `h:mm A`。有关选项的完整列表，请参阅[显示](https://momentjs.com/docs/#/displaying/)。
+ **背景颜色**：为时钟选择背景颜色。

# 控制面板列表面板
<a name="dashboard-list-panel"></a>

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

控制面板列表面板显示指向其他控制面板的动态链接。可将该列表配置为使用已加星标的控制面板、最近查看的控制面板、搜索查询和控制面板标签。

每次加载仪表板时，此面板都会查询仪表板列表，始终提供最多的 up-to-date结果。

## 选项
<a name="options-1"></a>

使用以下选项来优化您的可视化：
+  **已加星标**：按字母顺序显示已加星标的控制面板。
+  **最近查看**：按字母顺序显示最近查看的控制面板。
+  **搜索**：按搜索查询或标签显示控制面板。此选项要求您在**查询**或**标签**中至少输入一个值。
+  **显示标题**：将所选列表选项（“已加星标”、“最近查看”、“搜索”）显示为标题。
+  **最大项数**：设置每个部分列出的最大项数。例如，在保留默认值 10 的情况下，如果选择显示已加星标和最近查看的控制面板，面板最多会显示总共 20 个控制面板，每个部分 10 个。

### Search
<a name="panel-dashboard-list-search"></a>

以下选项仅在选择**搜索**选项时适用。
+  **查询**：输入您要搜索的查询。查询不区分大小写，并接受部分值。
+  **文件夹**：选择要显示的控制面板文件夹。
+  **标签**：输入要搜索的标签。请注意，现有标签不会在您键入时显示，并且*区分*大小写。

**注意**  
当出现多个标签和字符串时，控制面板列表将显示符合*所有*条件的标签和字符串。

# 仪表面板
<a name="gauge-panel"></a>

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

 **计量表**是一个单值面板，可以为每个序列、列或行重复一个计量表。

## 数据和字段选项
<a name="gauge-panel-data-and-field-options"></a>

计量表可视化允许您应用以下选项：
+  [转换](panel-transformations.md) 
+  [字段选项和覆盖](field-options-overrides.md) 
+  [Thresholds](thresholds.md) 

## 显示选项
<a name="gauge-panel-display-options-2"></a>

要优化您的可视化，请使用以下选项：
+  **显示**：选择 Amazon Managed Grafana 显示数据的方式。
  +  **计算**：显示基于所有行的计算**值**。有关可用计算的列表，请参阅 [计算列表](list-of-calculations.md)。
  +  **所有值**：为每行显示一个单独的统计数据。如果选择此选项，则还可以选择**限制**或要显示的最大行数。
+  **方向**：选择堆叠方向。
  +  **自动**：Amazon Managed Grafana 会选择它认为最佳的方向。
  +  **水平**：从左到右水平拉伸条形图。
  +  **垂直**：从上到下垂直拉伸条形图。
+  **显示阈值标签**：选择是否显示阈值。
+  **显示阈值标记**：选择是否在内部计量表值范围之外显示阈值范围。

# Geomap 面板
<a name="AMG-Geomap"></a>

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

**Geomap** 面板可视化使您能够使用地理空间数据，查看和自定义世界地图。通过配置各种叠加样式和地图视图设置，您可以轻松聚焦于数据中基于位置的重要特征。

## 数据层
<a name="Data-Layer"></a>

Geomap 插件中的数据层决定了如何基于基础地图，实现地理空间数据的可视化。

### 位置
<a name="Location"></a>

**Geomap** 面板需要一个地理数据来源。这些数据来自数据库查询，数据有四种映射选项。
+ **自动**可自动搜索位置数据。当您的查询基于以下数据字段名称之一时，请使用此选项。
  + geohash: “geohash”
  + latitude: “latitude”, “lat”
  + longitude: “longitude”, “lng”, “lon”
  + lookup: “lookup”
+  **坐标**指定查询包含坐标数据。系统会提示您从数据库查询中选择纬度和经度的数值数据字段。
+  **地理哈希**指定您的查询包含地理哈希数据。系统会提示您从数据库查询中为地理哈希选择字符串数据字段。
+  **查找**指定查询包含需要映射为地理位置的名称数据。系统会提示您从数据库查询中选择查找字段，并选择 ` gazetteer`。` gazetteer ` 是用于将查询到的数据映射到地理点的目录。

## 标记图层
<a name="Markers-Layer"></a>

**标记**图层允许您将数据点显示为不同的标记形状，如圆形、方形、三角形、星形等。
+ **标记颜色**可配置标记的颜色。默认的“固定大小”会使所有点保持为单一颜色。还有一个备选选项，可根据数据点的值和在**阈值**部分设置的阈值设置多种颜色。
+  **标记大小**可配置标记的大小。默认值为 ` Fixed size`，即无论数据点的情况如何，所有标记的大小都保持相同。但是，也有一个选项可以根据对应的数据点缩放圆形的大小。需要设置 ` Min` 和 `Max ` 标记大小，以便标记层可以在这些范围内缩放。
+  **标记形状**提供了以不同方式可视化数据点的灵活性。
  + 圆形
  + 方形
  + 三角形
  + 十字形
  + X 形
+  **填充不透明度**可配置每个标记的透明度。

## 热图图层
<a name="Heatmap-layer"></a>

**热图**图层将各种数据点聚类，以直观显示不同密度的位置。要添加热图层，请在**数据层**下选择**热图**。



与**标记**类似，系统会提示您使用各种选项来确定要可视化的数据点以及可视化的方式。
+ **权重值**用于配置热图聚类的强度。固定值使所有数据点的权重值保持恒定。该值范围应为 0\$11。与**标记**类似，下拉列表中还有一个备选选项，可以根据数据值自动缩放权重值。
+  **半径**用于配置热图集群的大小。
+  **模糊**用于配置每个集群的模糊程度。

# 图形面板
<a name="graph-panel"></a>

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

图形面板可以呈现为直线、点路径或一系列条形。这种类型的图形用途广泛，几乎可以显示任何时间序列数据。

## 数据和字段选项
<a name="graph-panel-data-and-field-options"></a>

使用图形可视化时，可以应用以下选项：
+  [转换](panel-transformations.md) 
+ 警报。这是唯一允许设置警报的可视化类型。有关更多信息，请参阅 [Grafana Alerting](alerts-overview.md)。
+  [Thresholds](thresholds.md) 

## 显示选项
<a name="graph-panel-display-options"></a>

使用以下设置来优化可视化效果：
+  **条形图**：将值显示为条形图。
+  **折线图**：将值显示为折线图。
+  **线宽**：指定序列的线条宽度。默认 为 1。
+  **阶梯**：将相邻的点绘制成阶梯。
+  **区域填充**：指定序列的颜色填充量。默认值为 1，0 表示没有颜色。
+  **填充渐变**：指定区域填充的渐变程度。默认值为 0，表示没有渐变，10 表示急剧的渐变。
+  **点数**：显示值的点数。
+  **点半径**：控制点的大小。
+  **警报阈值**：在面板上显示警报阈值和区域。

### 堆叠和空值
<a name="stacking-and-null-value"></a>
+  **堆叠**：每个序列堆叠在另一个序列之上。
+  **百分比**：每个序列按所有序列总计的百分比绘制。选择**堆叠**后，此选项可用。
+  **空值**：指定空值的显示方式。*这是一项重要的设置。*请参阅下面的注释。
  +  **连接**：如果序列中存在间隙（即一个或多个空值），该行将跳过间隙并连接到下一个非空值。
  +  **空值** 如果序列中存在间隙（即空值），则图表中的直线将被打断并显示间隙。这是默认设置。
  +  **空值为零**：如果序列中存在间隙（即空值），则间隙将在图形面板中显示为零值。

**重要**  
如果您正在监视服务器的 CPU 负载并且负载达到 100%，则服务器将锁定，发送统计信息的代理将无法收集负载统计信息。这会导致指标中存在间隙，使用默认的*空值*设置意味着 Amazon Managed Grafana 将显示间隙并指明出现了问题。如果将其设置为*连接*，则很容易错过此信号。

### 悬停工具提示
<a name="graph-panel-hover-tooltip"></a>

使用这些设置可以更改工具提示的外观，该工具提示会在您将光标悬停在图形可视化效果上时出现。
+  **模式**：确定悬停工具提示显示的序列数量。
  +  **全部序列**：悬停工具提示显示图形中的所有序列。在工具提示的序列列表中，Grafana 工作区以粗体突出显示光标悬停在其上方的序列。
  +  **单个**：悬停工具提示仅显示一个序列，即图形中光标悬停在其上方的序列。
+  **排序顺序**：如果选择**所有序列**模式，则会对悬停工具提示中的序列排序。当光标悬停在图形上时，Amazon Managed Grafana 会显示与线条相关的值。通常，用户最感兴趣的是最高值或最低值。对这些值进行排序可以更轻松地找到所需的数据。
  +  **无**：工具提示中序列的顺序由查询中的排序顺序决定。例如，您可以按序列名称的字母顺序对序列排序。
  +  **递增**：悬停工具提示中的序列按值以递增顺序排序，最低值位于列表顶部。
  +  **递减**：悬停工具提示中的序列按值以递减顺序排序，最高值位于列表顶部。

## 序列覆盖
<a name="graph-panel-series-overrides"></a>

序列覆盖允许图形面板中的序列以与其他序列不同的方式呈现。您可以为每个序列自定义不同显示选项，也可以使用正则表达式规则来自定义显示选项。例如，可以将某个序列的线宽加粗，使其突出，或者将其移至 Y 轴右侧。

您可以添加多个序列覆盖。

**添加序列覆盖**

1. 选择**添加序列覆盖**。

1. 在**别名或正则表达式**中，键入或选择一个序列。选择字段以查看可用序列列表。

   例如，`/Network.*/` 将与名为 `Network out` 和 `Network in` 的两个序列匹配。

1. 选择 **\$1**，然后选择要应用于该序列的样式。您可以向每个条目添加多个样式。
+  **条形图**：将序列显示为条形图。
+  **折线图**：将序列显示为折线图。
+  **线条填充**：显示带有区域填充的折线图。
+  **填充渐变**：指定区域填充渐变量。
+  **线宽**：设置线宽。
+  **空值点模式**：使用此选项可以忽略空值或将其替换为零。如果要忽略数据中的间隙，此选项很重要。
+  **填充至下方**：填充两个序列之间的区域。
+  **阶梯线**：将序列显示为阶梯线。
+  **短横线**：显示带有短横线的线条。
+  **隐藏序列**：隐藏序列。
+  **短横线长度**：设置线条中短横线的长度。
+  **短横线间距**：设置线条中短横线之间的空格长度。
+  **点**：将序列显示为单独的点。
+  **点半径**：设置点渲染的半径。
+  **堆栈**：设置序列的堆栈组。
+  **颜色**：设置序列颜色。
+  **Y 轴**：设置序列 y 轴。
+  **Z 索引**：设置序列 z 索引（渲染顺序）。当您叠加不同的样式（例如条形图和面积图）时，此选项非常重要。
+  转换：将值转换为负值以在 y 轴下方呈现。
+  **图例**：控制序列是否显示在图例中。
+  **在工具提示中隐藏**：控制序列是否显示在图表工具提示中。

## 轴
<a name="graph-panel-axes"></a>

使用这些选项来控制可视化中轴的显示。

### 向左 Y/Right Y
<a name="left-yright-y"></a>

两个 y 轴的选项相同。
+  **显示**：选择显示或隐藏轴。
+  **单位**：选择 y 值的显示单位。
+  **刻度**：选择用于 y 值的刻度：**线性**或**对数**。默认值为**线性**。
+  **Y 最小值**：y 的最小值。默认值为 **auto**。
+  **Y 最大值**：y 的最大值。默认值为 **auto**。
+  **小数**：定义 y 值显示的小数位数。默认值为 **auto**。
+  **标签**：指定 y 轴标签。默认值为“"”。

### Y 轴
<a name="y-axes"></a>
+  **对齐**：按值对齐左右的 y 轴。默认为未选中/false。
+  **级别**：输入用于左右 y 轴对齐的值，从 Y=0 开始。默认值是 0。选择**对齐**后，此选项可用。

### X 轴
<a name="x-axis"></a>
+  **显示**：选择显示或隐藏轴。
+  **模式**：显示模式完全改变了图形面板的可视化效果。就像三个面板合而为一。主要模式是时间序列模式，而且 x 轴上显示了时间。另外两种模式包括基本的条形图模式（在 x 轴上显示序列而不是时间）和直方图模式。
  +  **时间**（默认值）：x 轴表示时间，数据按时间（例如，按小时或分钟）分组。
  +  **序列**：数据按序列分组，而不是按时间分组。y 轴仍然代表值。
    +  **值**：这是用于值的聚合类型。默认值为**合计**（将值相加）。
  +  **直方图**：此选项将图形转换为直方图。直方图是一种将数字分组为范围的条形图，通常称为桶或箱。条形越高表示该范围内的数据越多。

    有关此直方图的更多信息，请参阅 [直方图和热图简介](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)。
    +  **桶**：设置要按其对值进行分组的桶数量。如果留空，Amazon Managed Grafana 会尝试计算合适的桶数量。
    +  **X 最小值**：筛选出直方图中小于此最小限制的值。
    +  **X 最大值**：筛选出大于此最大限制的值。

## 图例
<a name="graph-panel-legend"></a>

使用这些设置可以优化图例在可视化中的显示方式。

### 选项
<a name="graph-panel-legends-options"></a>
+  **显示**：清除以隐藏图例。默认选中（true）。
+  **作为表**：选择此选项可在表中显示图例。默认选中（true）。
+  **向右**：选择后可在右侧显示图例。
+  宽度：输入图例的最小宽度（以像素为单位）。选择**右对齐**后，此选项可用。

### 值
<a name="graph-panel-values"></a>

可以在图例名称旁边显示其他值。
+  **最小值**：指标查询返回的最小值。
+  **最大值**：指标查询返回的最大值。
+  **平均值**：指标查询返回的平均值。
+  **当前值**：从指标查询返回的最后一个值。
+  **总计**：从指标查询返回的所有值的总和。
+  **小数**：图例值和图形悬停工具提示显示的小数位数。

Amazon Managed Grafana 会计算客户端的图例值。这些图例值取决于指标查询使用的聚合类型或点合并类型。以上所有图例值不能同时正确。

例如，如果您绘制请求/秒之类的速率（可能使用平均值作为聚合器），则图例中的总数将不代表请求总数。这是 Amazon Managed Grafana 收到的所有数据点的总和。

### 隐藏序列
<a name="graph-panel-hide-series"></a>

当指标查询中某个序列的所有值均为特定值时，则隐藏序列。
+  **只有空值**：value=NULL（默认为未选中）
+  **只有零**：value=Zero（默认为未选中）

### 时间区域
<a name="graph-panel-time-regions"></a>

您可以在图形上突出显示特定的时间区域，以便于查看，例如周末、工作时间和下班时间。所有配置的时间区域均以 UTC 时间为准。

# 热图
<a name="visualization-heatmap"></a>

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

通过热图面板可视化，您可以查看随时间变化的直方图。有关此直方图的更多信息，请参阅 [直方图和热图简介](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)。

## 轴选项
<a name="heatmap-axes-options"></a>

使用这些设置来调整轴在可视化中的显示方式。

### Y 轴
<a name="heatmap-y-axis"></a>
+  **单位**：y 轴值的显示单位
+  **刻度**：用于 y 轴值的刻度
  +  **线性**：线性刻度 
  +  **log（底数 2）**：底数为 2 的对数刻度
  +  **log（底数 10）**：底数为 10 的对数刻度
  +  **log（底数 32）**：底数为 32 的对数刻度
  +  **log（底数 1024）**：底数为 1024 的对数刻度
+  **Y-Min**：最小 y 值（默认为自动）
+  **Y-Max**：最大 y 值（默认为自动）
+  **小数**：渲染 y 轴值的小数位数（默认为自动）

### 存储桶
<a name="heatmap-buckets"></a>

**注意**  
如果数据格式为**时间序列桶**，则此部分不可用。
+  **Y 轴桶**：y 轴将拆分的桶数。
+  **大小**：每个 y 轴桶的大小（仅当**刻度**为*线性*时可见）。此选项的优先级高于 **Y 轴桶**。
+  **拆分因子**：（仅当**刻度**为 *log（底数 2）*或更大时才可见）。默认情况下，Amazon Managed Grafana 按对数底数拆分 y 值。使用此选项，您可以将每个默认桶拆分成指定数量的桶。
+  **X 轴桶**：x 轴将拆分的桶数。
+  **大小**：每个 x 轴桶的大小。数量或时间间隔（10s、5m、1h 等）。支持的间隔：ms、s、m、h、d、w、M、y。此选项的优先级高于 **X 轴桶**。

#### 桶边界
<a name="heatmap-bucket-bound"></a>

当数据格式为时间序列桶时，数据来源将返回名称表示桶边界的序列。但根据数据来源的不同，边界可以是上限或下限。您可以使用此选项调整边界类型。如果设置了**自动**，则可以根据面板的数据来源类型选择边界选项。

#### 桶大小
<a name="heatmap-bucket-size"></a>

Amazon Managed Grafana 使用桶计数和大小选项来计算热图中每个单元格的大小。您可以通过计数（第一个输入框）或指定大小间隔来定义桶大小。对于 y 轴，大小间隔只是一个值。对于 X 桶，可在**大小**输入中指定时间间隔。例如，您可以将时间范围设置为 `1h`。这将使单元格在 x 轴上宽 1h。

#### 数据格式
<a name="heatmap-data-format"></a>

在**格式**列表中选择一个选项。
+ **时间序列**：Amazon Managed Grafana 通过遍历所有时间序列值来进行分桶。可在**桶**选项中设置桶的大小和间隔。
+ **时间序列桶**：每个时间序列已经表示一个 y 轴桶。时间序列名称（别名）必须是表示桶上限或下限间隔的数值。Grafana 工作区不进行分桶，因此桶大小选项是隐藏的。

## 显示选项
<a name="heatmap-display-options"></a>

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

### 颜色
<a name="heatmap-colors"></a>

色谱控制值计数（在每个桶中）和分配给每个桶的颜色之间的映射。色谱上最左侧的颜色表示最小计数，最右侧的颜色表示最大计数。使用浅色主题时，某些颜色方案会自动反转。

您也可以将颜色模式更改为**不透明度**。在这种情况下，颜色不会改变，但不透明度会随桶数的变化而变化。
+  **Mode (模式)** 
  +  **不透明度**：由单元格不透明度表示的桶值。不透明单元格表示最大值。
    +  **颜色**：单元格基色。
    +  **刻度**：将桶值映射到不透明度的刻度。
      +  **线性**：线性刻度。桶值以线性方式映射到不透明度。
      +  **sqrt**：幂刻度。以 `value ^ k` 计算的单元格不透明度，其中 `k` 是配置的**指数**值。如果指数小于 `1`，则会得到一个对数刻度。如果指数大于 `1`，则会得到一个指数刻度。如果是 `1`，则刻度将与线性相同。
    +  **指数**：指数值，大于 `0`。
  +  **色谱**：用单元格颜色表示的桶值。
    +  **方案**：如果模式为**色谱**，则选择颜色方案。

### 色阶
<a name="heatmap-color-scale"></a>

默认情况下，Amazon Managed Grafana 根据最小和最大桶值计算单元格颜色。可使用**最小值**和**最大值**覆盖这些值。将桶值视为 z 轴，将最小值和最大值分别视为 Z-Min 和 Z-Max。
+  **最小值**：用于单元格颜色计算的最小值。如果桶值小于最小值，则将其映射到最小颜色。默认值为 `series min value`。
+  **最大值**：用于单元格颜色计算的最大值。如果桶值大于最大值，则将其映射到最大颜色。默认值为 `series max value`。

### 图例
<a name="heatmap-legend"></a>

选择是否在可视化上显示热图图例。

### 存储桶
<a name="heatmap-legend-buckets"></a>
+  **隐藏零**：不绘制零值单元格。
+  **间距**：设置单元格之间的间距（像素）。默认值为 1 像素。
+  **圆度**：设置单元格圆度（像素）。默认值为 0。

### Tooltip
<a name="heatmap-tooltip"></a>
+  **显示工具提示**：显示热图工具提示。
+  **直方图**：在工具提示上显示 y 轴直方图。直方图表示特定时间戳的桶值的分布。
+  **小数**：设置渲染桶值的小数位数（默认为自动）。

# 直方图面板
<a name="histogram-panel"></a>

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

直方图可视化计算值的分布并将其显示为条形图。Y 轴和每个条形的高度代表落入每个括号中的值的数量，而 X 轴代表值范围。

直方图可视化支持时间序列和任何带有一个或多个数值字段的表结果。

## 显示选项
<a name="histogram-options"></a>

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

**桶大小**

桶的大小。将此字段留空，以自动调整桶大小（约为全量程的 10%）。

**桶偏移**

第一个桶不应该从零开始。非零偏移会移动聚合窗口。例如，大小为 5（0–5、5–10、10–15）且默认偏移量为 0 的桶将变为 2–7、7–12、12–17，偏移量为 2；在这种情况下，0、5 或 10 的偏移量实际上没有任何作用。通常，此选项将与明确定义的桶大小一起使用，而不是与自动桶大小一起使用。要使此设置生效，偏移量应大于 0 且小于桶大小；超出此范围的值将与该范围内的值具有相同的效果。

**组合序列**

这会将所有序列和字段合并为一个组合的直方图。

**线宽**控制条形图的线宽。

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

**渐变模式**设置渐变填充的模式。填充渐变基于线条颜色。要更改颜色，请使用标准颜色方案字段选项。渐变外观受填充不透明度设置的影响。
+  **无**：无渐变填充，这是默认设置。
+  **不透明度**：渐变的透明度是根据 Y 轴上的 n 值计算的。填充的不透明度随 Y 轴上的值增加而增加。
+  **色调**：渐变色是根据线条颜色的色调生成的。

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

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

## 图例选项
<a name="histogram-legend"></a>

启用图例选项后，可以显示值映射或阈值括号。要在图例中显示值映射，请务必将标准选项下的“颜色方案”选项设置为“单色”或“经典”调色板。要查看图例中的阈值括号，请将“颜色方案”设置为“来自阈值”。

**图例模式**：使用这些设置可以优化图例在可视化中的显示方式。
+  **列表**：以列表形式显示图例。这是图例的默认显示模式。
+  **表**：以表的形式显示图例。
+  **隐藏**：隐藏图例。

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

**图例计算**

选择要在图例中显示的计算。有关更多信息，请参阅 [计算列表](list-of-calculations.md)。

# 日志面板
<a name="logs-panel"></a>

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

日志面板可视化显示来自支持日志的数据来源（例如 Elastic、Influx 和 Loki）的日志行。通常，您可以使用图形面板旁边的此面板来显示相关进程的日志输出。

日志面板显示在**查询**选项卡上输入的查询结果。多个查询的结果按时间合并和排序。如果数据来源返回的行数超过了可以显示的行数，则可以在面板内滚动。

要限制渲染的行数，可以使用**查询选项**中的**最大数据点**设置。如果未设置，则数据来源通常会强制使用默认限制。

## 显示选项
<a name="logs-panel-display-options"></a>

使用以下设置来优化可视化效果：
+  **时间**：显示或隐藏时间列。这是与数据来源报告的日志行关联的时间戳。
+  **唯一标签**：显示或隐藏唯一标签列，该列仅显示非常见标签。
+  **换行**：切换换行符。
+  **顺序**：按时间降序或升序显示结果。默认为**降序**，首先显示最新的日志。设置为**升序**可首先显示最旧的日志行。

# 新闻面板
<a name="news-panel"></a>

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

此面板显示 RSS 源。默认情况下，显示来自 Grafana Labs 博客的文章。

在**显示**部分的 **URL** 字段中，输入 RSS 源的 URL。此面板类型不接受任何其他查询。

# 节点图形面板（测试版）
<a name="node-graph-panel"></a>

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

节点图面板可视化定向图形或网络。面板使用定向力布局来有效定位节点，有助于显示复杂的基础设施图、层次结构或执行图。

## 数据要求
<a name="node-graph-panel-requirements"></a>

节点图面板需要数据的特定形状才能显示其节点和边。并非每个数据来源或查询都可以在此面板中可视化。

节点图可视化由*节点*和*边*组成。
+ *节点*显示为圆形。从应用程序的角度来看，节点可能代表应用程序、服务或其他任何相关的内容。
+ *边*显示为一条连接两个节点的线。连接可能是请求、执行或两个节点之间的某种其他关系。

## Nodes
<a name="node-graph-panel-nodes"></a>

通常，节点在节点内部显示两个统计值，在节点正下方显示两个标识符，通常是名称和类型。节点还可以在节点周围用彩色圆圈显示另一组数值，不同颜色的部分代表不同的数值，这些数值相加应为 1。例如，您可以用圆圈的红色部分表示误差百分比。

其他详细信息可以显示在上下文菜单中，该菜单会在您选择节点时显示。上下文菜单中还可以有其他链接，这些链接可以指向 Grafana 工作区的其他部分或任何外部链接。

## Edges
<a name="node-graph-panel-edges"></a>

当您将鼠标悬停在边上时，边也可以显示统计数据。与节点类似，您也可以选择边以打开包含其他详细信息和链接的上下文菜单。

支持此可视化的第一个 AWS X-Ray 数据源是其服务地图功能的数据源。有关更多信息，请参阅 [Connect 连接到 AWS X-Ray 数据源](x-ray-data-source.md)。

其他详细信息可以显示在上下文菜单中，该菜单会在您选择节点时显示。上下文菜单中还可以有其他链接，这些链接可以指向 Grafana 工作区的其他部分或任何外部链接。

## 浏览节点图
<a name="node-graph-panel-navigation"></a>

通过选择任何节点或边的外部并拖动鼠标，可以在节点图内平移。

您可以使用节点图左上角的按钮进行缩放。

# 饼图面板
<a name="pie-chart-panel"></a>

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

饼图将来自一个或多个查询的简化序列或序列中的值（它们彼此相关）显示为饼图的切片。切片的弧长、面积和中心角都与切片值成正比，因为它与所有值的总和相关。如果您想以美观的形式快速比较一小组值，最好使用这种类型的图表。

饼图可视化允许您应用以下选项：
+  [转换](panel-transformations.md). 
+  [字段选项和覆盖](field-options-overrides.md). 
+  [Thresholds](thresholds.md).

## 选项
<a name="pie-chart-panel-options"></a>

您可以使用以下选项来优化可视化。
+  **显示**：选择要显示的信息量。**计算**将每个值归约为每个序列的单个值。**所有值**显示单个序列中的每个值。
+  **计算**：选择**计算**后，选择计算以减小每个序列。有关可用计算的信息，请参阅 [计算列表](list-of-calculations.md)。
+  **限制**：显示单个序列中的每个值时，这会限制显示的值的数量。
+  **字段**：选择要在可视化中显示的字段。
  + **数值字段**：所有包含数值的字段。
  + **所有字段**：所有未由转换删除的字段。
  + **时间**：所有带有时间值的字段。

## 标签
<a name="pie-charts-panel-labels"></a>

选择要在饼图上显示的标签。您可以选择多个标签。
+  **名称**：序列或字段名称。
+  **百分比**：占整体的百分比。
+  **值**：原始数值。

标签在图表正文上显示为白色。您可能需要选择颜色较深的图表，使其更加明显。较长的名称或数字可能会被截断。

## 图例位置和值
<a name="pie-charts-panel-legend"></a>

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

您可以选择多个值以显示在图例中。**百分比**是整体的百分比，**值**是原始数值。

# Plotly 面板
<a name="plotly-panel"></a>

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

Plotly 面板使用开源 javascript 图形库 [Plotly](https://plotly.com/javascript/) 渲染图表。

**数据**、**布局**和**配置**字段与 [Plotly 文档](https://plotly.com/javascript/plotlyjs-function-reference/)中描述的常用参数相匹配。必须采用 JSON 格式。

数据来源提供的数据可通过用户定义的脚本进行转换，然后再注入 Plotly 图表。该脚本包含 2 个参数。
+ `data`：数据来源返回的数据。
+ `variables`：当前控制面板中包含 [Grafana 变量](templates-and-variables.md)的对象（用户变量和以下几个全局变量：`__from`、`__to`、`__interval` 和 `__interval_ms`）。

该脚本返回的对象必须具有以下一个或多个属性：`data`、`layout`、`config` 和 `frames`。示例如下：

```
let x = data.series[0].fields[0].values;
let y = data.series[0].fields[1].values;
let series = {
    x: x,
    y: y,
    name: variables.name, // where ‘name’ is the name of a Grafana dashboard variable
};

return {
    data: [series],
    config: {
        displayModeBar: false,
    },
};
```

*数据*、*布局*和*配置*字段中提供的脚本和 JSON 返回的对象将被合并（深度合并）。

如果未提供脚本，面板将仅使用*数据*、*布局*和*配置*字段。

# Sankey 面板
<a name="sankey-panel"></a>

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

Sankey 面板显示了 Sankey 关系图，这些关系图非常适合可视化流数据，流宽度与所选指标成正比。下图显示了一个 Sankey 关系图，其中包含两组源和目标。

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/sankey-panel.png)


**工作原理**

sankey 面板需要至少 2 列数据，分别是数据流的源和目标。您的查询应将您的数据分为至少两组。该面板将按查询顺序绘制从第一列数据点到最后一列数据点的链接。链接的粗细将与查询中的指标分配的值成比。

**自定义**
+ **链接**：当前有两种链接颜色选项：多色或单色。默认为多色。要为链接选择单色，请切换**仅限单一链接颜色**选项，然后从 Grafana 的颜色选择器中选择颜色。
+ **节点**：您可以通过更改**节点颜色**选项来更改矩形节点的颜色
+ **节点宽度**：可以使用**节点宽度**滑块或在输入框中输入数字来调整节点的宽度。此数字必须是整数。
+ **节点填充**：可以使用**节点填充**滑块或在输入框中输入数字来调整节点之间的垂直填充。此数字必须是整数。如果您的链接太薄，可以尝试调整这个数字
+ **标题**：可以在编辑器面板中使用**显示名称**覆盖来更改列标题。这与您为**文本颜色**选择的颜色相同
+ **Sankey 布局**：可使用**布局迭代**滑块稍微调整 Sankey 链接的布局。此数字必须为整数，并且是用于生成布局的松弛迭代次数。

# 散点面板
<a name="scatter-panel"></a>

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

散点面板显示表格数据的 X/Y 散点图，其界面比其他图形面板更简单。与图形面板不同，散点面板不要求数据处于时间序列中。散点面板需要表格式的数据集，其中包含两列或多列数值数据。

其中一列可以分配给 X 轴。可以将一列或多列分配给一系列 Y 轴值，并将生成的数据绘制为一系列点。每个序列还可以选择使用多个统计最佳拟合中的一个来显示回归线。

**创建散点面板**

以下过程介绍了如何使用散点面板创建散点图。对于此示例，我们将假设存在如下表所示的 `HEIGHT` 数据，其中包含三列数值 `Age`、`Boys` 和 `Girls`，按年龄显示男孩和女孩的平均身高。


| 天数 | 男孩身高 | 女孩身高 | 
| --- | --- | --- | 
|  5  |  109.7  |  109.5  | 
|  6  |  115.6  |  115.4  | 
|  7  |  121.1  |  120.8  | 
|  8  |  126.3  |  126  | 
|  9  |  131.3  |  131.3  | 
|  10  |  136.2  |  137.1  | 
|  11  |  141.2  |  143.2  | 
|  12  |  147  |  148.7  | 
|  13  |  153.6  |  152.6  | 
|  14  |  159.9  |  155.1  | 
|  15  |  164.4  |  156.7  | 
|  16  |  167.3  |  157.6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158.3  | 
|  19  |  170.8  |  158.6  | 

**使用散点面板创建散点图**

1. 在您的 Grafana 控制面板中，选择**添加面板**。有关添加面板的更多详细信息，请参阅[添加面板](add-a-panel-to-a-dashboard.md)。

1. 对于查询，编写一个将返回所需数据的查询。在这种情况下，您将使用 `SELECT * FROM HEIGHT` 之类的查询。

1. 选择**散点**可视化。

这将创建一个散点图，使用第一列作为 X 轴，其他数值列作为 Y 轴。

**配置选项**

散点面板提供以下四个自定义配置选项。
+ **X 轴**：您可以选择用作 X 轴的字段，以及轴的范围、标题和显示信息。
+ **Y 轴**：您可以选择用作 Y 轴的字段，包括每个字段的显示选项以及轴的范围和标题信息。您还可以选择显示每个字段的回归线。有关回归线配置的更多详细信息，请参阅以下信息。
+ **图例**：您可以打开或关闭面板的图例，也可以选择图例中文本的大小。
+ **显示**：您可以为图表设置其他选项，包括网格颜色和边框样式。

**回归线配置**

除了单个点之外，每个 Y 轴数据集还可以显示一条线。有五个线条类型的选项。
+ **无**：不显示回归线。
+ **简单**：显示连接数据集点的回归线。
+ **线性**：使用最小二乘法这种最佳拟合方法显示一条直线。
+ **指数**：显示指数最佳拟合回归线。
+ **幂**：显示幂最佳拟合回归线。

# 统计面板
<a name="stat-panel"></a>

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

统计面板显示一个很大的统计值，并带有可选的图表迷你图。您可以使用阈值来控制背景或值颜色。

默认情况下，统计面板显示以下内容之一：
+ 仅显示单个序列或字段的值。
+ 多个序列或字段的值和名称。

您可以使用**文本模式**选项来控制是否显示文本。

## 数据和字段选项
<a name="stat-panel-data-and-field-options"></a>

统计可视化使您能够应用以下选项：
+  [转换](panel-transformations.md).
+  [字段选项和覆盖](field-options-overrides.md).
+  [Thresholds](thresholds.md).

## 自动布局调整
<a name="stat-panel-automatic-layout-adjustment"></a>

面板会根据控制面板中的可用宽度和高度自动调整布局。如果面板变得太小，将会自动隐藏图形（迷你图）。

## 显示选项
<a name="stat-panel-display-options"></a>

使用以下选项来优化您的可视化：
+  **显示**：选择 Amazon Managed Grafana 显示数据的方式。
  +  **计算**：显示基于所有行的计算值。
    +  **计算**：选择要应用的计算。有关可用计算的信息，请参阅 [计算列表](list-of-calculations.md)。
  +  **所有值**：每行显示一个单独的统计数据。
    +  **限制**：指定要显示的最大行数。
+  **字段**：选择要包含在此面板中的字段名称或字段类型（包括**所有字段**或**数值字段**）。
+  **值**：选择 reducer 函数，Amazon Managed Grafana 将使用该函数将多个字段简化为单个值。选择**值**列表以查看函数和简要说明。
+  **方向**：选择堆叠方向。
  +  **自动**：Amazon Managed Grafana 会选择它认为最佳的方向。
  +  **水平**：从左到右水平拉伸条形图。
  +  **垂直**：从上到下垂直拉伸条形图。
+  **文本模式**：可以使用**文本模式**选项来控制面板显示的文本。如果只有名称和颜色很重要，而值不重要，则将**文本模式**更改为**名称**。该值仍用于确定颜色，并显示在工具提示中。
  +  **自动**：如果数据包含多个序列或字段，则同时显示名称和值。
  +  **值**：仅显示值，不显示名称。名称显示在工具提示中。
  +  **值和名称**：始终显示值和名称。
  +  **名称**：显示名称而不是值。值显示在工具提示中。
  +  **无**：不显示任何内容（空）。名称和值显示在工具提示中。
+  **颜色模式**：选择一种颜色模式。
  +  **值**：仅为值和图形区域着色。
  +  **背景**：同时为背景着色。
+  **图表模式**：选择图形模式。
  +  **无**：隐藏图表并仅显示值。
  +  **面积**：在值下方显示面积图。此选项要求您的查询返回时间列。
+  **对齐模式**：选择对齐模式。
  +  **自动**：如果仅显示单个值（不重复），则该值居中。如果显示多个序列或多行，则该值为左对齐。
  +  **中心**：统计值居中。

# 状态时间轴面板
<a name="state-timeline-panel"></a>

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

状态时间轴面板可视化显示一段时间内的离散状态变化。每个字段或序列都渲染为其唯一的水平段。状态区域可以用值或不用值渲染。此面板适用于字符串或布尔状态，但也可以与时间序列一起使用。与时间序列一起使用时，使用阈值将数值转换为离散状态区域。

## 状态时间轴选项
<a name="state-timeline-options"></a>

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

**合并相等的连续值**

控制 Grafana 是否合并相邻的相同值。

**显示值**

控制是否在状态区域内渲染数值。如果有足够的空间，Auto 将渲染值。

**对齐值**

控制状态区域内的值对齐。

**行高**

控制行间的间距。1 = 无间距，0.5 = 50% 间距。

**线宽**

控制状态区域的线宽。

**填充不透明度**

控制状态区域的不透明度。

## 值映射
<a name="state-timeline-valuemap"></a>

要为布尔值或字符串值分配颜色，请使用 [值映射](field-options-overrides.md#value-mapping)。

## 带阈值的时间序列数据
<a name="state-timeline-threshold"></a>

该面板也可以用于时间序列数据。在这种情况下，使用阈值将时间序列转换为离散的彩色状态区域。

## 图例选项
<a name="state-timeline-legend"></a>

启用图例选项后，可以显示值映射或阈值括号。要在图例中显示值映射，请务必将“标准”选项下的“颜色方案”选项设置为“单色”或“经典”调色板。要查看图例中的阈值括号，请将“颜色方案”设置为“来自阈值”。

**图例模式**：使用这些设置可以优化图例在可视化中的显示方式。
+  **列表**：以列表形式显示图例。这是图例的默认显示模式。
+  **表**：以表的形式显示图例。
+  **隐藏**：隐藏图例。

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

# 状态历史面板
<a name="status-history-panel"></a>

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

状态历史可视化显示一段时间内的周期性状态。每个字段或序列都渲染为水平行。然后渲染框并围绕每个值居中。

状态历史可视化适用于字符串、布尔值和数值字段或时间序列。时间字段为必填项。您可以使用值映射为字符串着色，或为数字范围赋予文本值。

## 显示选项
<a name="status-timeline-options"></a>

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

**显示值**

控制值是否在值框内渲染。如果有足够的空间，Auto 将渲染值。

**列宽**控制框的宽度。1 = 最大宽度，0 = 最小宽度。

**线宽**控制状态区域的线宽。

**填充不透明度**控制状态区域的填充不透明度。

## 值映射
<a name="status-history-valuemap"></a>

要为布尔值或字符串值分配颜色，请使用 [值映射](field-options-overrides.md#value-mapping)。

## 带阈值的时间序列数据
<a name="status-history-threshold"></a>

该面板也可以用于时间序列数据。在这种情况下，使用阈值为框着色。也可以使用渐变配色方案为值着色。

## 图例选项
<a name="status-history-legend"></a>

启用图例选项后，可以显示值映射或阈值括号。要在图例中显示值映射，请务必将“标准”选项下的“颜色方案”选项设置为“单色”或“经典”调色板。要查看图例中的阈值括号，请将“颜色方案”设置为“来自阈值”。

**图例模式**：使用这些设置可以优化图例在可视化中的显示方式。
+  **列表**：以列表形式显示图例。这是图例的默认显示模式。
+  **表**：以表的形式显示图例。
+  **隐藏**：隐藏图例。

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

# 表面板
<a name="table-panel"></a>

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

表面板支持时间序列以及表、注释和原始 JSON 数据的多种模式。此面板还提供日期格式、值格式和着色选项。

## 数据和字段选项
<a name="data-and-field-options"></a>

对于表可视化，您可以应用以下选项：
+  [转换](panel-transformations.md).
+  [字段选项和覆盖](field-options-overrides.md).
+  [Thresholds](thresholds.md).

## 显示选项
<a name="display-options"></a>
+  **显示标题**：显示或隐藏从数据来源导入的列名。
+  **按升序/降序排序**：选择列标题可将排序顺序从默认值更改为降序和升序。每次单击时，排序顺序都会变为循环中的下一个选项。一次只能按一列排序。
+  [表字段选项](#table-field-options)：更改字段选项，例如列宽、对齐方式和单元格显示模式。
+  [筛选表列](#filter-table-columns)：暂时更改列数据的显示方式。例如，您可以按从高到低的顺序排列值，或者隐藏特定的值。

## 注释支持
<a name="annotation-support"></a>

新表面板目前不支持注释。

## 表字段选项
<a name="table-field-options"></a>

本节介绍所有可用的表字段选项。这些选项以 Amazon Managed Grafana 中的相同顺序列出。本主题中列出的选项仅适用于表面板可视化。

您在正在编辑的字段选项框之外进行选择或按 Enter 之前，大多数字段选项不会影响可视化。

有关应用这些选项的更多信息，请参阅[配置所有字段](field-options-overrides.md#configure-all-fields)和[配置特定字段](field-options-overrides.md#configure-specific-fields)。

### 列对齐方式
<a name="column-alignment"></a>

选择 Amazon Managed Grafana 应如何与单元格内容对齐：
+ 自动（默认）
+ 靠左对齐
+ 居中对齐
+ 靠右对齐

### 列宽
<a name="column-width"></a>

默认情况下，Amazon Managed Grafana 会根据单元格内容自动计算列宽。在此字段选项中，您可以覆盖设置并定义所有列的宽度（以像素为单位）。

例如，如果您在字段中输入 `100`，则在字段外进行选择时，所有列的宽度都将设置为 100 像素。

### 单元格显示模式
<a name="cell-display-mode"></a>

默认情况下，Amazon Managed Grafana 会自动选择显示设置。您可以通过选择以下选项之一更改所有字段，从而覆盖设置。

**注意**  
如果您在**字段**选项卡中进行这些设置，则显示模式将应用于所有字段，包括时间字段。对于很多选项，如果您在**覆盖**选项卡中对它们进行设置，它们的效果能达到最佳。

#### 颜色文本
<a name="color-text"></a>

如果设置了阈值，则字段文本将以相应的阈值颜色显示。

#### 对背景着色
<a name="color-background"></a>

如果设置了阈值，则字段背景将以相应的阈值颜色显示。

#### 梯度表
<a name="gradient-gauge"></a>

阈值水平定义渐变。

#### 液晶表
<a name="lcd-gauge"></a>

将仪表分成点亮或不点亮的小单元格。

#### JSON 视图
<a name="json-view"></a>

该值以代码格式显示。如果值是一个对象，则当您将鼠标悬停在值上时，会出现允许您浏览 JSON 对象的 JSON 视图。

### 列筛选器
<a name="column-filter"></a>

## 筛选表列
<a name="filter-table-columns"></a>

如果您在表选项中打开**列筛选器**，则可以筛选表选项。有关更多信息，请参阅 [表字段选项](#table-field-options)。

### 打开列筛选
<a name="turn-on-column-filtering"></a>

1. 在 Amazon Managed Grafana 中，选择显示表的控制面板，而表中包含您要筛选的列。

1. 在要筛选的表面板上，[打开面板编辑器](AMG-panel-editor.md#open-the-panel-editor)。

1. 选择**字段**选项卡。

1. 在**表**选项中，打开**列筛选器**选项。

每个列标题旁边都会显示一个筛选器图标。

### 筛选列值
<a name="filter-column-values"></a>

要筛选列值，请选择列标题旁边的筛选器（漏斗）图标。Grafana 工作区显示该列的筛选器选项。

选中要显示的值旁边的复选框。在顶部的搜索字段中输入文本，在显示屏中显示这些值，这样您就可以从中选择，而不用滚动来查找。

### 清除列筛选条件
<a name="clear-column-filters"></a>

应用筛选条件的列在标题旁边会显示一个蓝色的漏斗。

要移除过滤器，请选择蓝色漏斗图标，然后选择**清除筛选器**。

# 文本面板
<a name="text-panel"></a>

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

您可以使用文本面板为控制面板创建信息和描述面板。

在**模式**中，选择是使用 markdown 还是 HTML 来设置文本样式，然后在下面的框中输入内容。Grafana 工作区包括标题和段落以帮助您入门，或者您可以从其他编辑器中粘贴内容。

# 时间序列面板
<a name="time-series-panel"></a>

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

时间序列面板可将时间序列渲染成线条、点路径或条形图序列。这种类型的图形用途广泛，几乎可以显示任何时间序列数据。

**注意**  
您可以将图形面板可视化迁移到时间序列可视化。若要迁移，请在**面板**选项卡上，选择**时间序列可视化**。Grafana 会传输所有适用的设置。

可以对时间序列可视化应用以下选项：
+  [转换](panel-transformations.md) 
+  [字段选项和覆盖](field-options-overrides.md) 
+  [Thresholds](thresholds.md) 

您还可以使用字段选项来创建不同类型的图形或调整轴。

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

## 工具提示模式
<a name="time-series-panel-tooltip"></a>

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

## 图例模式和放置
<a name="time-series-panel-legend"></a>

选择图例的显示方式。
+  **列表**：以列表形式显示图例。这是默认值。
+  **表**：以表的形式显示图例。
+  **隐藏**：隐藏图例。

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

## 图例计算
<a name="time-series-panel-legend-calculations"></a>

选择要在图例中显示的计算。有关更多信息，请参阅 [计算列表](list-of-calculations.md)。

# 将时间序列绘制为线条
<a name="time-series-graph-lines"></a>

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

本节介绍了如何使用时间序列字段选项将时间序列数据可视化为线条，并说明了这些选项的作用。

**创建面板**

1. 创建一个面板，选择**时间序列**可视化。有关更多信息，请参阅 [添加面板](add-a-panel-to-a-dashboard.md)。

1. 在**面板编辑器**中，选择**字段**。

1. 在**样式**中，选择**线条**。

## 设置线条样式
<a name="time-series-graph-lines-style"></a>

有多种选项来设置线条的样式。
+ **线插值**：选择 Grafana 插入序列线的方式。选项包括**线性**、**平滑**、**前一步**和**后一步**。
+ **线宽**：将线条的粗细设置在 0 到 10 像素之间。
+ **填充不透明度**：设置序列填充的不透明度，范围为 0% 到 100%。
+ **渐变模式**：设置渐变填充的模式。填充渐变基于线条颜色。要更改颜色，请使用标准颜色方案字段选项。

  渐变外观受**填充不透明度**设置的影响。

  渐变填充的选项包括**无**、**不透明度**和**色调**。对于**不透明度**，渐变的透明度是根据 y 轴上的值计算的。填充的不透明度随 y 轴上的值增加而增加。对于**色调**，渐变颜色是根据线条颜色的色调生成的。
+ **线条样式**：设置线条的样式。要更改颜色，请使用标准颜色方案字段选项。

  线条样式的外观受**线宽**和**填充不透明度**设置的影响。

  线条样式的选项包括**实线**、**虚线**和**点线**。
+ **空值**：选择数据间隙的显示方式。可以将空值连接起来形成一条连续的线，也可以设置一个阈值，如果超过该阈值，数据间隙将不再连接。您可以选择**从不**连接有间隙的数据点，**始终**连接有间隙的数据点，或者设置一个**阈值**，当达到该阈值时，数据间隙将不再连接。
+ **显示点**：选择何时在图形上显示点。选项包括**自动**、**始终**和**从不**。

## 填充至下方
<a name="time-series-panel-legend-fillbelow"></a>

此选项仅在“覆盖”选项卡中可用。

**填充两个序列之间的区域**

1. 在下面选择要填充的字段。

1. 在**添加覆盖属性**中，选择**在下面填充**。

1. 选择希望填充停止的序列。

# 将时间序列绘制为条形图
<a name="time-series-graph-bars"></a>

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

本节介绍了如何使用时间序列字段选项将时间序列数据可视化为条形图，并说明了这些选项的作用。

**创建面板**

1. 创建一个面板，选择**时间序列**可视化。有关更多信息，请参阅 [添加面板](add-a-panel-to-a-dashboard.md)。

1. 在**面板编辑器**中，选择**字段**。

1. 在**样式**中，选择**条形图**。

## 设置条形图样式
<a name="time-series-graph-bars-style"></a>

有多种选项来设置条形图的样式。
+ **条形图对齐**：设置条形图相对于数据点的位置。选项包括**前**、**居中**和**后**。
+ **线宽**：将条形图轮廓的粗细设置在 0 到 10 像素之间。
+ **填充不透明度**：设置条形图填充的不透明度，范围为 0% 到 100%。
+ **渐变模式**：设置渐变填充的模式。填充渐变基于线条颜色。要更改颜色，请使用标准颜色方案字段选项。

  渐变外观受**填充不透明度**设置的影响。

  渐变填充的选项包括**无**、**不透明度**和**色调**。对于**不透明度**，渐变的透明度是根据 y 轴上的值计算的。填充的不透明度随 y 轴上的值增加而增加。对于**色调**，渐变颜色是根据线条颜色的色调生成的。
+ **显示点**：选择何时在图形上显示点。选项包括**自动**、**始终**和**从不**。

# 将时间序列绘制为点
<a name="time-series-graph-points"></a>

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

本节介绍了如何使用时间序列字段选项将时间序列数据可视化为点，并说明了这些选项的作用。

**创建面板**

1. 创建一个面板，选择**时间序列**可视化。有关更多信息，请参阅 [添加面板](add-a-panel-to-a-dashboard.md)。

1. 在**面板编辑器**中，选择**字段**。

1. 在**样式**中，选择**点**。

## 设置点样式
<a name="time-series-graph-points-style"></a>

当您以点的形式绘制时，可以选择点的大小。
+ **点大小**：选择点大小，直径介于 1 到 40 像素之间。

# 更改轴显示
<a name="time-series-change-axis"></a>

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

本节介绍了如何使用时间序列字段选项来控制可视化中轴的显示，并说明了轴选项的作用。

轴有多种选项。
+ **Y 轴放置**：设置 y 轴的放置。选项包括**左**、**右**和**隐藏**。
+ **Y 轴标签**：设置 y 轴的文本标签。如果有多个 y 轴，可使用**覆盖**选项卡为其分配不同的标签。
+ **宽度**：设置轴的固定宽度。默认情况下，Grafana 工作区会动态计算轴的宽度。通过设置轴的宽度，不同轴类型的数据可以共享相同的显示比例。这样就可以更容易比较多个图形的数据，因为轴在视觉上不会相互移动或拉伸。
+ **软最小值和软最大值**：设置**软最小值**或**软最大值**，以更好地控制 y 轴限制。默认情况下，Grafana 工作区会根据数据自动设置 y 轴的范围。

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

# 用图形绘制堆叠时间序列
<a name="time-series-stacked"></a>

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

本节介绍了如何使用时间序列字段选项来控制序列的堆叠，并说明了堆叠选项的作用。堆叠允许 Grafana 相互叠加显示序列。在可视化中使用堆叠时要小心，因为很容易创建误导性图形。您可以在此处阅读有关为什么堆叠不是最佳方法的更多信息：[堆叠问题](https://www.data-to-viz.com/caveat/stacking.html)。

# 分组堆叠序列
<a name="time-series-stacked-groups"></a>

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

堆叠组选项只能作为覆盖选项使用。

**将序列堆叠在同一组中**

1. 在“覆盖”部分中，为**堆栈序列**选项创建字段覆盖。

1. 选择**正常**堆叠模式。

1. 为您希望序列显示在其中的堆叠组命名。堆叠组名称选项仅在创建覆盖时可用。

# Thresholds
<a name="thresholds"></a>

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

阈值根据您定义的条件设置值文本或背景的颜色。

可以通过以下两种方式之一定义阈值：
+ **绝对**阈值是根据数字定义的；例如，1 到 150 之间的 80。
+ **百分比**阈值是相对于最小值或最大值定义的；例如，80%。

您可以将阈值应用于以下可视化：
+ [条形仪表面板](alert-panel-bar-gauge-panel.md) 
+  [仪表面板](gauge-panel.md) 
+  [图形面板](graph-panel.md)
+  [统计面板](stat-panel.md)
+  [表面板](table-panel.md)

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

在支持阈值的可视化中，Amazon Managed Grafana 会设置以下默认阈值：80 = 红色；基本 = 绿色；模式 = 绝对。

**基本**值表示负无穷大。它通常是*代表良好*的颜色。

## 添加阈值
<a name="add-a-threshold"></a>

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

**注意**  
这些说明仅适用于统计数据、计量表、条形仪表和表可视化。

1. 选择要向其中添加阈值的面板。

1. 选择**字段**选项卡。

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

   Amazon Managed Grafana 添加了一个阈值，其中包含建议的数字和颜色值。

1. 接受建议或编辑新的阈值。
   +  **编辑颜色**：选择要更改的色点，然后选择一种新颜色。
   +  **编辑编号**：选择要更改的编号，然后输入一个新编号。
   +  **阈值模式**：选择模式，以更改此面板上所有阈值的模式。

1. 选择**保存**将更改保存在控制面板中。

## 向图表面板添加阈值
<a name="add-a-threshold-to-a-graph-panel"></a>

在图表面板可视化中，您可以使用阈值向图表中添加任意线条或区域，以便更轻松地查看图表何时跨越特定阈值。

1. 选择要向其中添加阈值的图表面板。

1. 在**面板**选项卡上，选择**阈值**。

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

1. 根据需要填写任意数量的字段。只有 **T1** 字段是必填字段。
   +  **T1**：需要两个值才能显示阈值。
     +  **lt** 或 **gt**：选择 **lt** 表示小于，或选择 **gt** 表示大于，以指示阈值适用的范围。
     +  **值**：输入阈值。Grafana 工作区沿着 y 轴在该值的位置绘制一条阈值线。
   +  **颜色**：选择与颜色对应的条件，或定义自己的颜色。
     +  **自定义**：定义填充颜色和线条颜色。
     +  **critical**：填充和线条颜色为红色。
     +  **warning**：填充和线条颜色为黄色。
     +  **ok**：填充和线条颜色为绿色。
   +  **填充**：选择是否显示阈值填充。
   +  **线条**：选择是否显示阈值线条。
   +  **Y 轴**：选择**左**或**右**。

1. 选择**保存**将更改保存在控制面板中。

## 删除阈值
<a name="delete-a-threshold"></a>

1. 选择要从其中移除阈值的面板。

1. 选择**字段**选项卡。（或者，对于图表面板，选择**面板**选项卡。）

1. 选择要移除的阈值旁边的垃圾桶图标。

1. 选择**保存**将更改保存在控制面板中。

# WindRose
<a name="windrose"></a>

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

 WindRose 面板接收原始时间序列数据，转换数据并将其映射到 WindRose 图表中。

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/windrose.png)


## 选项
<a name="windrose-options"></a>

该 WindRose 面板支持以下选项：
+ 轴频率
+ 轴样式（度数或指南针）
+ 刻度（线性、平方、对数）

# 检查面板
<a name="inspect-a-panel"></a>

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

面板检查器可帮助您了解面板并对其进行故障排除。您可以检查任何 Grafana 工作区面板的原始数据，将该数据导出到逗号分隔值（CSV）文件，查看查询请求，以及导出面板和数据 JSON。

## 面板检查器 UI
<a name="panel-inspector-ui"></a>

面板检查器在面板顶部显示 **Inspect: < NameOfPanelBeingInspected >**。选择右上角的箭头可展开或缩小窗格。

面板检查器由四个选项卡组成：
+  **数据选项卡**：显示应用转换后查询返回的原始数据。默认情况下，不会应用覆盖和值映射之类的字段选项。
+  **统计选项卡**：显示查询花费的时间和返回的数量。
+  **JSON 选项卡**：允许您查看和复制面板 JSON、面板数据 JSON 和数据帧结构 JSON。如果您要配置或管理 Amazon Managed Grafana，这会很有用。
+  **查询选项卡**：显示 Amazon Managed Grafana 查询数据来源时向服务器发送的请求。

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

## 面板检查器任务
<a name="panel-inspector-tasks"></a>

在面板检查器中，您可以检查面板、检查和下载原始查询结果、检查查询性能、查看面板 JSON 模型以及查看原始请求和对数据来源的响应。

### 打开面板检查器
<a name="open-the-panel-inspector"></a>

您可以检查任何可以查看的面板。

1. 在 Grafana 工作区控制面板中，选择包含想要检查的面板的控制面板。

1. 选择要检查的面板的标题，然后选择**检查**。或者将鼠标悬停在面板标题上，然后按 **i**。

面板检查器面板在屏幕右侧打开。

### 检查原始查询结果
<a name="inspect-raw-query-results"></a>

在表中查看原始查询结果。这些是应用转换后并在面板应用字段选项或字段选项覆盖之前由查询返回的数据。

1. 打开面板检查器，然后选择**数据**选项卡。或者在面板菜单中，选择**检查**、**数据**。

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

  在应用了字段选项和选项覆盖的表中查看原始查询结果。

  1. 在面板检查器中打开**数据**选项卡。

  1. 在表上方，选择**数据显示选项**。

  1. 选择**应用字段配置**切换按钮。

### 将原始查询结果作为 CSV 文件下载
<a name="download-raw-query-results-as-csv"></a>

Amazon Managed Grafana 会在默认浏览器下载位置生成一个 CSV 文件。您可以在所选的查看器中打开该文件。

1. 打开面板检查器。

1. 如上所述，检查原始查询结果。调整设置，直到看到要导出的原始数据。

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

要下载用于 Excel 的 CSV 格式的文件，请在选择**下载 CSV** 之前展开**数据选项**面板并打开**下载为 Excel 格式**选项。

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

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

1. 打开面板检查器。

1. 选择**状态**选项卡。

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

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

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

1. 打开面板检查器，然后选择 **JSON** 选项卡。或者，在面板菜单中，选择**检查**、**面板 JSON**。

1. 在**选择来源**中，选择以下选项之一：
   +  **面板 JSON**：显示代表面板的 JSON 对象。
   +  **面板数据**：显示一个 JSON 对象，该对象表示传递给面板的数据。
   +  **DataFrame st** ructure-显示应用了变换、字段配置和覆盖的原始结果集。

1. 您可以展开或折叠 JSON 的某些部分进行浏览，也可以选择**复制到剪贴板**，然后将 JSON 粘贴到其他应用程序中。

### 查看对数据来源的原始请求和响应
<a name="view-raw-request-and-response-to-data-source"></a>

1. 打开面板检查器，然后选择**查询**选项卡。或者，在面板菜单中，选择**检查**、**查询**。

1. 选择**刷新**。

Amazon Managed Grafana 向服务器发送查询以收集信息，然后它会显示结果。您可以向下钻取查询的特定部分，展开或折叠所有部分，或者将数据复制到剪贴板以在其他应用程序中使用。

# 计算列表
<a name="list-of-calculations"></a>

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

本主题列出并定义了 Amazon Managed Grafana 中使用的计算方式。

在其他地方，这些计算用于**转换**选项卡以及条形仪表、计量表和统计数据可视化中。


|  计算  |  说明  | 
| --- | --- | 
|  全部为 null  |  当所有值都为 null 时为 True  | 
|  全部为 0  |  当所有值都为 0 时为 True  | 
|  更改计数  |  字段值更改的次数  | 
|  计数  |  字段中值的数量  | 
|  Delta  |  值的累积变化  | 
|  区别  |  字段第一个值和最后一个值的差  | 
|  去重计数  |  字段中唯一值的数量  | 
|  第一个（非 null）  |  第一个，字段中的非 null 值  | 
|  最大值  |  字段的最大值  | 
|  平均值  |  字段中所有值的平均值  | 
|  最小值  |  字段的最小值  | 
|  最小值（大于 0）  |  字段的最小正值  | 
|  Range  |  字段的最大值和最小值的差  | 
|  步骤  |  字段值之间的最小间隔  | 
|  Total  |  字段中所有值的总和  | 