本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Grafana 9 提供的可视化 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 Grafana 提供了多种可视化来支持不同的用例。本文档的这一部分重点介绍了内置面板、其选项和典型用法。 [时间序列面板](v9-panels-time-series.md) 面板是一种常见的入门面板，用于学习使用面板的基础知识。 **Topics** + [警报列表面板](v9-panels-alert-list.md) + [注释面板](v9-panels-annotations.md) + [条形图面板](v9-panels-bar-chart.md) + [条形仪表](v9-panels-bar-gauge.md) + [K 线图面板](v9-panels-candlestick.md) + [画布面板](v9-panels-canvas.md) + [时钟面板](v9-panels-clock.md) + [控制面板列表](v9-panels-dashboard-list.md) + [仪表面板](v9-panels-gauge.md) + [Geomap 面板](v9-panels-geomap.md) + [图形面板](v9-panels-graph.md) + [热图面板](v9-panels-heatmap.md) + [直方图面板](v9-panels-histogram.md) + [日志面板](v9-panels-logs.md) + [新闻面板](v9-panels-news.md) + [节点图面板](v9-panels-node-graph.md) + [饼图面板](v9-panels-piechart.md) + [Plotly 面板](v9-panels-plotly.md) + [Sankey 面板](v9-panels-sankey.md) + [散点面板](v9-panels-scatter.md) + [统计面板](v9-panels-stat.md) + [状态时间轴面板](v9-panels-state-timeline.md) + [状态历史面板](v9-panels-status-history.md) + [表面板](v9-panels-table.md) + [文本面板](v9-panels-text.md) + [时间序列面板](v9-panels-time-series.md) + [跟踪面板（测试版）](v9-panels-traces.md) + [WindRose](v9-panels-windrose.md) # 警报列表面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 警报列表面板显示控制面板警报。您可以将列表配置为显示当前状态或最近的状态更改。有关警报的更多信息，请参阅 [Grafana 9 版本中的警报](v9-alerts.md)。 使用这些设置来改进可视化结果。 ## 选项 + **组模式**：选择**默认分组**以显示按警报规则分组的警报实例，或者选择**自定义分组**以按一组自定义标签对警报实例进行分组。 + **最大项目数**：设置要列出的最大警报数。 + **排序顺序**：选择显示警报的排序方式。 + **按字母顺序（升序）**：按字母顺序排列 + **按字母顺序（降序）**：按字母顺序倒序排列 + **重要性**：根据以下值，按重要性划分，其中 1 为最高： + `alerting` 或 `firing`：1 + `no_data`：2 + `pending`：3 + `ok`：4 + `paused` 或 `inactive`：5 + **来自此控制面板的警报**：仅显示警报列表所在控制面板的警报。 ## 筛选条件 使用以下选项筛选警报，使其与您选择的查询、文件夹或标签相匹配： + **警报名称**：输入警报名称查询。 + **警报实例标签**：使用标签查询筛选警报实例。例如 `{severity="critical", instance=~"cluster-us-.+"}`。 + **文件夹**：选择一个文件夹。仅会显示所选文件夹中控制面板的警报。 + **数据来源**：筛选来自所选数据来源的警报。 ## 状态筛选条件 选择要在此面板中显示的警报状态。 + 警报/触发 + 待定 + 无数据 + Normal + 错误 # 注释面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 注释面板显示了可用于查看注释数据的可用注释列表。有多种选项可用于根据标签和当前控制面板筛选列表。 ## 注释查询 以下选项可控制注释列表的来源查询。 **查询筛选条件** 使用查询筛选条件从组织中的所有控制面板或此面板所在的当前控制面板创建注释列表。具有以下选项： + 所有控制面板：列出当前组织中所有控制面板的注释。 + 此控制面板：将列表限制为当前控制面板上的注释。 **时间范围** 使用时间范围选项来指定是否应将列表限制在当前时间范围内。具有以下选项： + 无：注释查询没有时间范围限制。 + 此控制面板：将列表限制为注释列表面板可用的控制面板的时间范围内。 **标签** 使用标签选项按标签筛选注释。您可以添加多个标签以优化列表。 **注意** 或者，将标签列表留空，然后选择作为面板本身结果一部分列出的标签来动态筛选。 *限制* 使用“限制”选项来限制返回的结果数量。 ## 显示 这些选项可控制注释面板显示中包含的其他元数据。 **显示用户** 使用此选项显示或隐藏创建注释的用户。 **显示时间** 使用此选项显示或隐藏创建注释的时间。 **显示标签** 使用此选项显示或隐藏注释相关的标签。*注意*：您可以使用标签对面板本身的注释列表进行实时筛选。 ## 链接行为 **链接目标** 使用此选项选择如何查看带注释的数据。具有以下选项： + 面板：此选项可让您直接进入面板的全屏视图，其中包含相应的注释 + 控制面板：此选项将注释聚焦于完整控制面板的上下文中 **之前的时间** 使用此选项设置注释之前的时间范围。使用持续时间字符串值，例如“1h”= 1 小时，“10m”= 10 分钟等。 **之后的时间** 使用此选项设置注释之后的时间范围。 # 条形图面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 通过此面板可视化，您可以绘制分类数据图形。 ## 支持的数据格式 仅支持一个数据框，且该数据框至少需要一个字符串字段（用作 X 轴或 Y 轴的类别）和一个或多个数值字段。以下是数据格式的示例： | 浏览器 | 市场占有率 | | --- | --- | | Chrome | 50 | | Internet Explorer | 17.5 | 如果您有多个数值字段，面板会显示分组条形图。 ### 可视化时间序列或多个结果集 如果您有多个时间序列或表，则首先需要使用 join 或 reduce 转换将其连接。例如，如果您有多个时间序列，并想要比较其最新值和最大值，请添加 **Reduce** 转换，并在**计算**下指定**最大值**和**最新值**选项。 ## 条形图选项 使用以下选项来优化可视化效果： **方向** + **自动**：Grafana 根据面板尺寸决定条形图的方向。 + **水平**：将 X 轴设为类别轴。 + **垂直**：将 Y 轴设为类别轴。 **X 轴刻度标签最大长度**用于设置条形图标签的最大长度。超过最大长度的标签会被截断（用省略号）。 **条形图标签最小间距**用于设置条形图标签之间的最小间距。 **显示值** 控制值是显示在条形图的顶部还是左侧。 + **自动**：如果有空间，则显示值。 + **始终**：始终显示值。 + **从不**：从不显示值。 **堆叠** 控制条形图堆叠。 + **关闭**：条形图不会堆叠。 + **正常**：条形图彼此堆叠。 + **百分比**：条形图彼此堆叠，每个条形图的高度为堆叠总高度的百分比（所有条形图堆叠的高度相同，合计为 100%）。 **组宽度**控制组的宽度。0=最小宽度，1=最大宽度。 **条形图宽度**控制条形图的宽度。0=最小宽度，1=最大宽度。 **条形图半径**控制条形图的半径，0=最小半径，0.5=最大半径。 **悬停时高亮显示整个区域**控制当鼠标指针悬停在条形图上方时，条形图周围区域是否高亮显示。 **线宽**控制条形图的线宽。 **填充不透明度**控制条形图的填充不透明度。 **渐变模式**设置渐变填充的模式。填充渐变基于线条颜色。要更改颜色，请使用标准颜色方案字段选项。渐变外观受**填充不透明度**设置的影响。 + **无**：无渐变填充，这是默认设置。 + **不透明度**：渐变的透明度是根据 y 轴上的值计算的。填充的不透明度随 Y 轴上的值增加而增加。 + **色调**：渐变色是根据线条颜色的色调生成的。 **工具提示模式**：当您将光标悬停在可视化上时，Grafana 可显示工具提示。选择工具提示的行为方式。 + **单个**：悬停工具提示仅显示一个序列，即您将鼠标悬停在可视化上面的序列。 + **全部**：悬停工具提示显示可视化中的所有序列。Grafana 在工具提示的序列列表中以粗体突出显示您悬停在上面的序列。 + **隐藏**：与可视化交互时不显示工具提示。 **注意** 可使用覆盖从工具提示隐藏单个序列。 **图例模式**：使用这些设置可以优化图例在可视化中的显示方式。有关更多信息，请参阅 [配置图例](v9-panels-configure-legend.md)。 + **列表**：以列表形式显示图例。这是图例的默认显示模式。 + **表**：以表的形式显示图例。 + **隐藏**：隐藏图例。 **图例放置**：选择图例的放置位置。 + **底部**：显示在图形下方。 + **右**：显示在图形右侧。 **图例计算**：选择要在图例中显示的标准计算。可以输入多个值。 **文本大小**：输入一个值以更改条形图上文本的大小。 **轴**：使用以下字段设置来优化轴的显示方式。除非您在正在编辑的字段选项框外部单击或按 Enter 键，否则某些字段选项不会影响可视化。 + **放置**：设置 y 轴的放置。 + **自动**：Grafana 会自动为序列分配 Y 轴。当有两个或多个具有不同单位的序列时，Grafana 将左轴分配给第一个单位，将右轴分配给下一个单位。 + **左**：在左侧显示所有 Y 轴。 + **右**：在右侧显示所有 Y 轴。 + **隐藏**：隐藏所有 Y 轴。 + **标签**：设置 Y 轴文本标签。如果有多个 Y 轴，可使用覆盖分配不同的标签。 + **宽度**：设置轴的固定宽度。默认情况下，Grafana 会动态计算轴的宽度。 通过设置轴的宽度，具有不同轴类型的数据可以共享相同的显示比例。这样就可以更容易比较多个图形的数据，因为轴在视觉上不会相互移动或拉伸。 + **软最小值和软最大值**：设置软最小值或软最大值选项，以更好地控制 Y 轴限制。默认情况下，Grafana 会根据数据集自动设置 Y 轴的范围。 软最小值或软最大值设置可以防止在数据大部分平缓的情况下，出现山峰状的突起，而从标准最小值和最大值字段选项派生的硬最小值或硬最大值，则可以通过剪裁超过定义点的尖峰，来防止间歇性尖峰压平有用的细节。 您可以设置标准 min/max 选项来定义 Y 轴的硬限制。 # 条形仪表 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 条形仪表可将每个字段归约为单个值，从而简化数据。您可以选择 Grafana 计算归约的方式。 此面板可以显示一个或多个条形仪表，具体取决于查询返回的序列、行或列的数量。 ## 值选项 使用以下选项来优化可视化显示值的方式： **显示**：选择 Grafana 显示数据的方式。 **计算**：显示基于所有行的计算值。 + **计算**：选择一个 reducer 函数，Grafana 将使用该函数将多个字段归约为单个值。有关可用计算的列表，请参阅计算类型。 + **字段**：选择面板中显示的字段。 **所有值**：为每行显示一个单独的统计数据。如果选择此选项，则还可以限制要显示的行数。 + **限制**：要显示的最大行数。默认为 5000。 + **字段**：选择面板中显示的字段。 ## 条形仪表选项 调整条形仪表的显示方式。 **方向**：选择堆叠方向。 + **自动**：Grafana 会选择其认为最佳的方向。 + **水平**：从左到右水平拉伸条形图。 + **垂直**：从上到下垂直拉伸条形图。 **显示模式**：选择显示模式。 + **渐变**：阈值级别定义梯度。 + **复古 LCD**：将仪表分成点亮或不点亮的小单元格。 + **基本**：基于匹配阈值的单色。 **显示未填充区域**：如果要将条形图的未填充区域渲染为深灰色，请选择此选项。不适用于复古 LCD 显示模式。 **最小宽度** 限制条形柱在垂直方向上的最小宽度。 当数据量较大时，自动显示 x 轴滚动条。 **最小高度** 限制条形行在水平方向上的最小高度。 当数据量较大时，自动显示 y 轴滚动条。 # K 线图面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 通过 K 线图面板，您可以可视化包含多个一致维度的数据（侧重于价格走势）。Kandlestick 面板包括 Open-High-Low-Close (OHLC) 模式，并支持基于时间序列数据的其他维度。 K 线图面板建立在 [时间序列面板](v9-panels-time-series.md) 的基础之上，包含许多常用的配置设置。 **Mode (模式)** 您可以使用模式选项切换用于可视化的维度。 + **蜡烛**将面板维度限制为 K 线图可视化使用的开盘、高点、低点和收盘维度。 + **成交量**将面板维度限制为成交量维度。 + **二者**是 K 线图面板的默认行为。包括 K 线图和成交量可视化。 **蜡烛样式** + **K 线图**是默认的显示样式，可在开盘和收盘维度之间创建蜡烛样式的可视化效果。 + **OHLC 条形图**显示四个核心维度的开盘值、高点值、低点值和收盘值。 **颜色策略** + **开盘以来**是默认行为。如果期间内价格变动为正值，该模式将使用*上涨*颜色。换句话说，如果收盘时的值大于或等于开盘时的值，则使用*上涨*颜色。 + **上次收盘以来**是另一种显示方法，蜡烛的颜色取决于期间内的价格走势或价值变化。换句话说，如果开盘值大于收盘值，则使用*上涨*颜色。如果开盘值小于收盘值，则使用*下跌*颜色。*该选项还会触发空心 K 线图可视化模式*。空心表示周期内的变动为正值（收盘时的值高于开盘时的值），实心表示周期内的变动为负值（收盘时的值低于开盘时的值）。要了解更多信息，请参阅[差异说明](https://thetradingbible.com/how-to-read-hollow-candlesticks)。 **上涨和下跌颜色** **上涨颜色**和**下跌颜色**选项用于选择价格上涨或下跌时使用的颜色。上述*颜色策略*将决定是使用周期内还是周期间的价格变动来选择 K 线图或 OHLC 条形图的颜色。 **开盘、高点、低点、收盘** K 线图面板会尝试将字段映射到相应的维度。如果面板无法将数据映射到这些维度，则可以使用**开盘**、**高点**、**低点**和**关闭**选项。 **注意** 这些值在图例中是隐藏的。 + **开盘**对应给定周期的起始值。 + **高点**对应给定周期的最高值。 + **低点**对应给定周期的最低值。 + **收盘**对应给定周期的最终（结束）值。 + **成交量**对应给定周期内的样本数（例如交易次数） **其他字段** K 线面板基于时间序列面板。除了开盘、高点、低点、收盘和成交量之外，还能可视化其他数据维度。**Include** 和 **Ignore** 选项允许面板使用 [时间序列面板](v9-panels-time-series.md) 中可用的相同样式和配置来可视化其他包含的数据，如简单移动平均线、布林线等。 # 画布面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 画布是一种新面板，将 Grafana 的强大功能与自定义元素的灵活性相结合。画布可视化是可扩展的表单构建面板，允许在静态和动态布局中显式放置元素。这使您能够以标准 Grafana 面板无法实现的方式设计自定义可视化和叠加数据，所有这些都在 Grafana 的 UI 中完成。如果您使用过流行的 UI 和 Web 设计工具，那么设计画布面板会感觉非常熟悉。 ## 元素 **指标值** 指标值元素让您可以轻松选择要在画布上显示的数据。此元素具有独特的“编辑”模式，可通过上下文菜单“编辑”选项或双击来触发。在编辑模式下，您可以选择要显示的字段数据。 **文本** 文本元素使您能够轻松地向画布添加文本。该元素还支持编辑模式，可通过双击或上下文菜单中的编辑菜单选项触发。 **矩形** 通过矩形元素，您可以在画布上添加基本的矩形。矩形元素支持显示文本（固定数据和字段数据），也可以根据数据阈值更改背景颜色。 **图标** 通过图标元素，您可以将支持的图标添加到画布。可根据阈值或值映射来设置图标的颜色。 ## 画布编辑 **内联编辑器** 画布引入了全新的编辑体验。现在，您可以在控制面板模式下以内联方式编辑画布面板。 **上下文菜单** 通过上下文菜单，您可以访问常见任务。支持的功能包括打开和关闭内联编辑器、复制元素、删除元素等。 右键单击面板或给定画布元素会触发上下文菜单。右键单击面板时，您可以设置背景图像，轻松地向画布添加元素。 右键单击元素时，您可以编辑、删除和复制该元素，或者修改元素的图层位置。 ## 画布选项 **内联编辑** 内联编辑开关让您可以锁定或解锁画布面板。关闭后，画布面板将处于*锁定*状态，将元素冻结在原位并防止意外修改。 # 时钟面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 时钟面板显示当前时间或倒计时。每秒更新一次。 + **模式**：默认为**时间**。如果选择**倒计时**，请设置**倒计时截止时间**以开始倒计时。 + **12 或 24 小时**：显示时间的选项有 12 小时制和 24 小时制。 + **时区**：时区由时刻时区库提供。默认值为计算机上的时区。 + **倒计时截止时间**：如果您已将**模式**设置为**倒计时**，请指定倒计时的时间和日期。 + **倒计时结束文本**：指定倒计时结束时要显示的文本。 + **日期/时间格式选项**-自定义字体大小、粗细和 date/time 格式。如果显示倒计时，但不想看到秒数减少，请将时间格式更改为 24 小时制 `hh:mm` 或 12 小时制 `h:mm A`。有关选项的完整列表，请参阅[显示](https://momentjs.com/docs/#/displaying/)。 + **背景颜色**：为时钟选择背景颜色。 # 控制面板列表 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 控制面板列表可视化可展示指向其他控制面板的动态链接。可将该列表配置为使用已加星标的控制面板、最近查看的控制面板、搜索查询和控制面板标签。 每次加载仪表板时，此面板都会查询仪表板列表，始终提供最多的 up-to-date结果。 **Options** 使用以下选项来优化可视化效果。 + **已加星标**：按字母顺序显示已加星标的控制面板。 + **最近查看**：按字母顺序显示最近查看的控制面板。 + **搜索**：按搜索查询或标签显示控制面板。您必须在**查询**或**标签**中至少输入一个值。对于**查询**和**标签**字段，支持变量插值，例如，`$my_var` 或 `${my_var}`。 + **显示标题**：所选列表选择（已加星标、最近查看、搜索）显示为标题。 + **最大项数**：设置每个部分列出的最大项数。例如，如果您保留默认值 10，并显示已加星标和最近查看的控制面板，则该面板将最多显示 20 个控制面板，每个部分有 10 个。 **搜索** 仅当选择**搜索**选项时，这些选项才适用。 + **查询**：输入您要搜索的查询。查询不区分大小写，并接受部分值。 + **文件夹**：选择要显示的控制面板文件夹。 + **标签**：您可以在此输入要搜索的标签。现有标签不会在您键入时显示，*并且*区分大小写。 **注意** 当出现多个标签和字符串时，控制面板列表将显示符合*所有*条件的标签和字符串。 # 仪表面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 仪表是一种单值可视化，可为每个序列、列或行重复仪表。 **值选项** 使用以下选项来优化可视化显示值的方式： **Show (显式)** 选择 Grafana 显示数据的方式。 **计算** 显示基于所有行的计算值。 + **计算**：选择一个 reducer 函数，Grafana 将使用该函数将多个字段归约为单个值。有关可用计算的列表，请参阅 [计算类型](v9-panels-calculation-types.md)。 + **字段**：选择面板中显示的字段。 **所有值** 为每行显示一个单独的统计数据。如果选择此选项，则还可以限制要显示的行数。 + **限制**：要显示的最大行数。默认为 5000。 + **字段**：选择面板中显示的字段。 **计量表** 调整仪表的显示方式。 + **显示阈值标签**：控制是否显示阈值。 + **显示阈值标记**：控制是否在内部计量表值范围之外显示阈值范围。 **文本大小** 调整仪表文本的大小。 + **标题**：输入仪表标题大小的数值。 + **值**：输入仪表值大小的数值。 # Geomap 面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 Geomap 面板可视化让您可以使用地理空间数据，查看和自定义世界地图。通过配置各种叠加样式和地图视图设置，您可以轻松聚焦于数据中基于位置的重要特征。 ## 地图视图 地图视图控制控制面板加载时地图的初始视图。 **初始视图** 初始视图配置首次加载 GeoMap 面板时面板的呈现方式。 + **视图**设置面板首次加载时地图的中心。 + **适应数据**根据地图图层的数据范围适应地图视图，并在数据发生变化时更新。 + **数据**选项允许根据所选图层中的“所有图层”、单个“图层”或“最后一个值”的数据选择范围。 + 如果适应来自单个“图层”或图层“最后一个值”的数据，则可以选择**图层**。 + **填充**以超出数据范围的相对百分比设置填充（仅在查看“最后一个值”时不可用）。 + **最大缩放**设置适应数据时的最大缩放级别。 + **坐标**根据以下因素设置地图视图： + **纬度** + **经度** + 还提供了默认视图，包括： + **（0°, 0°）** + **北美洲** + **南美洲** + **欧洲** + **非洲** + **西亚** + **南亚** + **东南亚** + **东亚** + **澳大利亚** + **大洋洲** + **缩放**设置初始缩放级别。 ## 地图图层 Geomap 可视化支持显示多个层。每个图层决定了如何基于基础地图，实现地理空间数据的可视化。 **类型** Geomap 可视化中有三种地图层类型可供选择。 + [标记图层](#v9-panels-geomap-markers) 在每个数据点渲染一个标记。 + [热图图层](#v9-panels-geomap-heatmap) 可视化数据的热图。 + [GeoJSON 图层](#v9-panels-geomap-geojson) 渲染 GeoJSON 文件中的静态数据。 目前还有五种图层类型处于 alpha 阶段。 + [夜间/白天图层（Alpha）](#v9-panels-geomap-nightday) 渲染夜间或白天区域。 + **最后一个点的图标（alpha）**在最后一个数据点渲染一个图标。 + **动态 GeoJSON（alpha）**根据查询结果设置 GeoJSON 文件的样式。 + **路由（alpha）**将数据点渲染为路由。 + [照片图层（Alpha）](#v9-panels-geomap-photos) 在每个数据点渲染一张照片。 **图层控件** 图层控件允许您创建图层、更改图层名称、重新排序和删除图层。 + **添加图层**可为 Geomap 可视化创建附加的可配置数据图层。添加图层时，系统会提示您选择图层类型。在面板配置过程中，您可以随时更改图层类型。有关每种图层类型的详细信息，请参阅上面的**图层类型**部分。 + 通过图层控件，您可以重命名、删除和重新排序面板上的图层。 + **编辑图层名称**（铅笔图标）可重命名图层。 + **垃圾桶**可删除图层。 + **重新排序**（六个点/抓取手柄）允许更改图层顺序。较高图层的数据将显示在较低图层的数据之上。拖放时，面板将更新图层顺序，以帮助简化图层顺序的选择。 您可以向单个 Geomap 面板添加多层数据，以创建丰富、详细的可视化效果。 **位置** Geomap 面板需要一个地理数据来源。这些数据来自数据库查询，数据有四种映射选项。 + **自动**可自动搜索位置数据。当您的查询基于以下数据字段名称之一时，请使用此选项。 + geohash: “geohash” + latitude: “latitude”, “lat” + longitude: “longitude”, “lng”, “lon” + lookup: “lookup” + **坐标**指定查询包含坐标数据。系统会提示您从数据库查询中选择纬度和经度的数值数据字段。 + **地理哈希**指定您的查询包含地理哈希数据。系统会提示您从数据库查询中为地理哈希选择字符串数据字段。 + **查找**指定查询包含需要映射为地理位置的名称数据。系统将提示您从数据库查询和地名录中选择查找字段。地名录是用于将查询到的数据映射到地理点的目录。 ## 标记图层 标记图层允许您将数据点显示为不同的标记形状，如圆形、方形、三角形、星形等。 标记有许多自定义选项。 + **标记颜色**可配置标记的颜色。默认的 `Single color` 会使所有点保持为单一颜色。还有一个备选选项，可根据数据点得值和在 `Thresholds` 部分设置的阈值设置多种颜色。 + **标记大小**可配置标记的大小。默认值为 `Fixed size`，即无论数据点的情况如何，所有标记的大小都相同。但是，也有一个选项可以根据对应的数据点缩放圆圈的大小。需要设置 `Min` 和 `Max` 标记大小，以便标记图层可以在这些范围内缩放。 + **标记形状**允许您选择形状、图标或图形，以帮助为数据提供额外的可视化上下文。从 Grafana 中包含的资源中选择，例如简单形状或 Unicon 库。您也可以指定包含图像资源的 URL。图像必须是可缩放向量图形（SVG）。 + **填充不透明度**可配置每个标记的透明度。 ## 热图图层 热图图层将各种数据点聚类，以直观显示不同密度的位置。添加热图图层： 单击数据图层下的下拉菜单并选择 `Heatmap`。 与 `Markers` 类似，系统会提示您使用各种选项来确定要可视化的数据点以及可视化的方式。 + **权重值**用于配置热图集群的强度。`Fixed value` 在所有数据点保持恒定的权重值。该值范围应为 0\$11。与标记类似，下拉列表中还有一个备选选项，可以根据数据值自动缩放权重值。 + **半径**用于配置热图集群的大小。 + **模糊**用于配置每个集群的模糊程度。 ## GeoJSON 图层 通过 GeoJSON 图层，可从文件系统中选择并加载静态 GeoJSON 文件。 + **GeoJSON URL** 提供了 Grafana 附带的 GeoJSON 文件供您选择。 + **默认样式**控制当上述规则不匹配时要应用的样式。 + **颜色**可配置默认样式的颜色 + **不透明度**可配置默认的不透明度 + **样式规则**根据特征属性应用样式 + **规则**允许您从 GeoJSON 文件中选择*特征*、*条件*和*值*来定义规则。垃圾桶图标可用于删除当前规则。 + **颜色**可为当前规则配置样式的颜色 + **不透明度**配置当前规则的透明度级别 + **添加样式规则**可创建其他样式规则。 ## CARTO 图层 CARTO 图层来自 [CARTO](https://carto.com/about-us/) 栅格底图。 **Options** + **主题** 选择一个主题，可以是**浅色**主题、**深色**主题或**自动**主题。 + **显示标签**在地图顶部显示国家/地区的详细信息。 + **不透明度**从 0（透明）到 1（不透明） ## XYZ 切片图层 XYZ 切片图层是来自通用切片图层的地图。 **注意** 有关通用切片图层的更多信息，请参阅 [Web 切片地图](https://en.wikipedia.org/wiki/Tiled_web_map)和 [Open Street Map 切片服务器列表](https://wiki.openstreetmap.org/wiki/Tile_servers)。 **Options** + **URL 模板** **注意** 设置有效的切片服务器 url，例如 \$1z\$1/\$1x\$1/\$1y\$1：`https://tile.openstreetmap.org/{z}/{x}/{y}.png`。 + **属性**设置图层的参考字符串（如果显示在[地图控件](#v9-panels-geomap-controls)中） + **不透明度**从 0（透明）到 1（不透明） ## Open Street Map 图层 来自 [Open Street Map](https://www.openstreetmap.org/about) 的地图，这是一个协作式的免费地理世界数据库。 **Options** + **不透明度**从 0（透明）到 1（不透明） ## ArcGIS 图层 A [rcGIS](https://services.arcgisonline.com/arcgis/rest/services) 图层是来自 [ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS MapServer 的图层。 **Options** + **服务器实例**，可从以下地图类型中选择。 + World Street Map + World Imagery + World Physical + Topographic + USA Topographic + World Ocean + 自定义 MapServer （有关格式，请参阅 [XYZ](#v9-panels-geomap-xyz)） + URL 模板 + 属性 + **不透明度**从 0（透明）到 1（不透明） ## 夜间/白天图层（Alpha） 夜间/白天图层根据当前时间范围显示夜间和白天区域。 **注意** 有关更多信息，请参阅 [ OpenLayers -的扩展 DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)。 **Options** + **显示**从面板时间范围切换时间来源 + **夜间区域颜色**选择夜间区域的颜色 + **显示太阳**切换太阳图标 + **不透明度**从 0（透明）到 1（不透明） ## 照片图层（Alpha） 照片图层在每个数据点渲染一张照片。 **注意** 有关更多信息，请参阅 [ OpenLayers -图像照片样式的扩展程序](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)。 **Options** + **图像来源字段** 选择包含以下任一格式的图像数据的字符串字段： + **图像 URLs** + **Base64 编码**图像二进制（`data:image/png;base64,…`） + **类型** 选择图像周围的框架样式 + **Square** + **Circle** + **锚定** + **对开** + **裁剪**切换（裁剪图像以适合尺寸） + **阴影**切换图像背后的方框阴影 + **边框**设置图像周围的边框大小 + **边框颜色**设置图像周围的边框颜色 + **半径**设置图像的整体大小（像素） ## 地图控件 地图控件界面包含以下地图信息和工具叠加选项。 **Zoom** 本节介绍了每个缩放控件。 *显示缩放控件* 在左上角显示缩放控件。 *鼠标滚轮缩放* 使用鼠标滚轮进行放大或缩小来打开或关闭。 **显示属性** 显示地图上底图图层的属性。 **显示刻度** 在左下角显示刻度信息。 **注意** 以 [m]/[km] 为单位显示。 **显示测量工具** 在右上角显示测量工具。仅当此控件打开时，才会显示测量值。 + **单击**开始测量 + **继续单击**继续测量 + **双击**结束测量 **注意** 更改测量类型或单位后，先前的测量值将从地图上删除。 如果控件关闭后又重新打开，则会显示最新的测量值。 单击并拖动测量值可以对其进行修改。 *长度* 获取几何形状的球面长度。该长度是坐标之间的大圆距离之和。对于多部分几何形状，长度是每个部分的长度之和。假设几何形状位于“EPSG:3857”中。 您可以选择以下长度测量单位： + **公制（m/km）** + **英尺（ft）** + **英里（mi）** + **海里（nmi）** *领域* 获取几何形状的球面面积。计算此面积时，假设多边形的边是球体上大圆的线段。假设几何形状位于“EPSG:3857”中。 您可以选择以下面积测量单位： + **平方米（m²）** + **平方千米（km²）** + **平方英尺（ft²）** + **平方英里（mi²）** + **英亩（acre）** + **公顷（ha）** **显示调试** 在地图右上角显示调试信息。这对于调试或验证数据来源很有用。 + **缩放**显示地图的当前缩放级别。 + **中心**显示地图中心的当前**经度**和**纬度**。 **Tooltip** + **无**仅当单击数据点时才显示工具提示。 + **详细信息**当指针悬停在数据点上时显示工具提示。 # 图形面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 图形面板可以呈现为直线、点路径或一系列条形。这种类型的图形用途广泛，几乎可以显示任何时间序列数据。 ## 数据和字段选项 使用图形可视化时，可以应用以下选项： + [转换数据](v9-panels-xform.md) + 警报。这是唯一允许设置警报的可视化类型。有关更多信息，请参阅 [Grafana 9 版本中的警报](v9-alerts.md)。 + [配置阈值](v9-panels-configure-thresholds.md) ## 显示选项 使用以下设置来优化可视化效果： + **条形图**：将值显示为条形图。 + **折线图**：将值显示为折线图。 + **线宽**：指定序列的线条宽度。默认 为 1。 + **阶梯**：将相邻的点绘制成阶梯。 + **区域填充**：指定序列的颜色填充量。默认值为 1，0 表示没有颜色。 + **填充渐变**：指定区域填充的渐变程度。默认值为 0，表示没有渐变，10 表示急剧的渐变。 + **点数**：显示值的点数。 + **点半径**：控制点的大小。 + **警报阈值**：在面板上显示警报阈值和区域。 ### 堆叠和空值 + **堆叠**：每个序列堆叠在另一个序列之上。 + **百分比**：每个序列按所有序列总计的百分比绘制。选择**堆叠**后，此选项可用。 + **空值**：指定空值的显示方式。*这是一项重要的设置。*请参阅下面的注释。 + **连接**：如果序列中存在间隙（即一个或多个空值），该行将跳过间隙并连接到下一个非空值。 + **空值** 如果序列中存在间隙（即空值），则图表中的直线将被打断并显示间隙。这是默认设置。 + **空值为零**：如果序列中存在间隙（即空值），则间隙将在图形面板中显示为零值。 **重要** 如果您正在监视服务器的 CPU 负载并且负载达到 100%，则服务器将锁定，发送统计信息的代理将无法收集负载统计信息。这会导致指标中存在间隙，使用默认的*空值*设置意味着 Amazon Managed Grafana 将显示间隙并指明出现了问题。如果将其设置为*连接*，则很容易错过此信号。 ### 悬停工具提示 使用这些设置可以更改工具提示的外观，该工具提示会在您将光标悬停在图形可视化效果上时出现。 + **模式**：确定悬停工具提示显示的序列数量。 + **全部序列**：悬停工具提示显示图形中的所有序列。在工具提示的序列列表中，Grafana 工作区以粗体突出显示光标悬停在其上方的序列。 + **单个**：悬停工具提示仅显示一个序列，即图形中光标悬停在其上方的序列。 + **排序顺序**：如果选择**所有序列**模式，则会对悬停工具提示中的序列排序。当光标悬停在图形上时，Amazon Managed Grafana 会显示与线条相关的值。通常，用户最感兴趣的是最高值或最低值。对这些值进行排序可以更轻松地找到所需的数据。 + **无**：工具提示中序列的顺序由查询中的排序顺序决定。例如，您可以按序列名称的字母顺序对序列排序。 + **递增**：悬停工具提示中的序列按值以递增顺序排序，最低值位于列表顶部。 + **递减**：悬停工具提示中的序列按值以递减顺序排序，最高值位于列表顶部。 ## 序列覆盖 序列覆盖允许图形面板中的序列以与其他序列不同的方式呈现。您可以为每个序列自定义不同显示选项，也可以使用正则表达式规则来自定义显示选项。例如，可以将某个序列的线宽加粗，使其突出，或者将其移至 Y 轴右侧。 您可以添加多个序列覆盖。 **添加序列覆盖** 1. 选择**添加序列覆盖**。 1. 在**别名或正则表达式**中，键入或选择一个序列。选择字段以查看可用序列列表。 例如，`/Network.*/` 将与名为 `Network out` 和 `Network in` 的两个序列匹配。 1. 选择 **\$1**，然后选择要应用于该序列的样式。您可以向每个条目添加多个样式。 + **条形图**：将序列显示为条形图。 + **折线图**：将序列显示为折线图。 + **线条填充**：显示带有区域填充的折线图。 + **填充渐变**：指定区域填充渐变量。 + **线宽**：设置线宽。 + **空值点模式**：使用此选项可以忽略空值或将其替换为零。如果要忽略数据中的间隙，此选项很重要。 + **填充至下方**：填充两个序列之间的区域。 + **阶梯线**：将序列显示为阶梯线。 + **短横线**：显示带有短横线的线条。 + **隐藏序列**：隐藏序列。 + **短横线长度**：设置线条中短横线的长度。 + **短横线间距**：设置线条中短横线之间的空格长度。 + **点**：将序列显示为单独的点。 + **点半径**：设置点渲染的半径。 + **堆栈**：设置序列的堆栈组。 + **颜色**：设置序列颜色。 + **Y 轴**：设置序列 y 轴。 + **Z 索引**：设置序列 z 索引（渲染顺序）。当您叠加不同的样式（例如条形图和面积图）时，此选项非常重要。 + 转换：将值转换为负值以在 y 轴下方呈现。 + **图例**：控制序列是否显示在图例中。 + **在工具提示中隐藏**：控制序列是否显示在图表工具提示中。 ## 轴 使用这些选项来控制可视化中轴的显示。 ### 向左 Y/Right Y 两个 y 轴的选项相同。 + **显示**：选择显示或隐藏轴。 + **单位**：选择 y 值的显示单位。 + **刻度**：选择用于 y 值的刻度：**线性**或**对数**。默认值为**线性**。 + **Y 最小值**：y 的最小值。默认值为 **auto**。 + **Y 最大值**：y 的最大值。默认值为 **auto**。 + **小数**：定义 y 值显示的小数位数。默认值为 **auto**。 + **标签**：指定 y 轴标签。默认值为“"”。 ### Y 轴 + **对齐**：按值对齐左右的 y 轴。默认为未选中/false。 + **级别**：输入用于左右 y 轴对齐的值，从 Y=0 开始。默认值是 0。选择**对齐**后，此选项可用。 ### X 轴 + **显示**：选择显示或隐藏轴。 + **模式**：显示模式完全改变了图形面板的可视化效果。就像三个面板合而为一。主要模式是时间序列模式，而且 x 轴上显示了时间。另外两种模式包括基本的条形图模式（在 x 轴上显示序列而不是时间）和直方图模式。 + **时间**（默认值）：x 轴表示时间，数据按时间（例如，按小时或分钟）分组。 + **序列**：数据按序列分组，而不是按时间分组。y 轴仍然代表值。 + **值**：这是用于值的聚合类型。默认值为**合计**（将值相加）。 + **直方图**：此选项将图形转换为直方图。直方图是一种将数字分组为范围的条形图，通常称为桶或箱。条形越高表示该范围内的数据越多。 有关此直方图的更多信息，请参阅 [直方图和热图简介](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)。 + **桶**：设置要按其对值进行分组的桶数量。如果留空，Amazon Managed Grafana 会尝试计算合适的桶数量。 + **X 最小值**：筛选出直方图中小于此最小限制的值。 + **X 最大值**：筛选出大于此最大限制的值。 ## 图例 使用这些设置可以优化图例在可视化中的显示方式。 ### 选项 + **显示**：清除以隐藏图例。默认选中（true）。 + **作为表**：选择此选项可在表中显示图例。默认选中（true）。 + **向右**：选择后可在右侧显示图例。 + 宽度：输入图例的最小宽度（以像素为单位）。选择**右对齐**后，此选项可用。 ### 值 可以在图例名称旁边显示其他值。 + **最小值**：指标查询返回的最小值。 + **最大值**：指标查询返回的最大值。 + **平均值**：指标查询返回的平均值。 + **当前值**：从指标查询返回的最后一个值。 + **总计**：从指标查询返回的所有值的总和。 + **小数**：图例值和图形悬停工具提示显示的小数位数。 Amazon Managed Grafana 会计算客户端的图例值。这些图例值取决于指标查询使用的聚合类型或点合并类型。以上所有图例值不能同时正确。 例如，如果您绘制请求/秒之类的速率（可能使用平均值作为聚合器），则图例中的总数将不代表请求总数。这是 Amazon Managed Grafana 收到的所有数据点的总和。 ### 隐藏序列 当指标查询中某个序列的所有值均为特定值时，则隐藏序列。 + **只有空值**：value=NULL（默认为未选中） + **只有零**：value=Zero（默认为未选中） ### 时间区域 您可以在图形上突出显示特定的时间区域，以便于查看，例如周末、工作时间和下班时间。所有配置的时间区域均以 UTC 时间为准。 # 热图面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 通过热图面板可视化，您可以查看随时间变化的直方图。有关直方图的更多信息，请参阅 [直方图和热图简介](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)。 ## 根据数据计算 此设置决定数据是已计算的热图（来自数据来源/转换器），还是在面板中计算的热图。 **X 桶** 此设置决定如何将 X 轴拆分为桶。可在**大小**输入中指定时间间隔。例如，时间范围为 `1h` 会使 X 轴上的单元格宽度为 1 小时。 **Y 桶** 此设置决定如何将 Y 轴拆分为桶。 **Y 桶刻度** 从以下 Y 轴值刻度中选择一个： + **线性**：线性刻度。 + **log（底数 2）**：底数为 2 的对数刻度。 + **log（底数 10）**：底数为 10 的对数刻度。 ## Y 轴 定义 Y 轴的显示方式 **放置** + **左**：在左侧 + **右**：在右侧 + **隐藏**：隐藏 **单位** 单位配置 **小数** 此设置决定十进制配置。 **最小/最大值** 此设置配置轴范围。 **反向** 选中后，轴将按相反顺序显示。 ## 颜色 色谱控制值计数（在每个桶中）和分配给每个桶的颜色之间的映射。色谱上最左侧的颜色表示最小计数，最右侧的颜色表示最大计数。使用浅色主题时，某些颜色方案会自动反转。 您也可以将颜色模式更改为“不透明度”。在这种情况下，颜色不会改变，但不透明度会随桶数的变化而变化 + **Mode (模式)** + **方案**：用单元格颜色表示的桶值。 + **方案**：如果模式为**方案**，则选择颜色方案。 + **不透明度**：由单元格不透明度表示的桶值。不透明单元格表示最大值。 + **颜色**：单元格基色。 + **刻度**：将桶值映射到不透明度的刻度。 + **线性**：线性刻度。桶值以线性方式映射到不透明度。 + **sqrt**：幂刻度。以 `value ^ k` 计算的单元格不透明度，其中 `k` 是配置的**指数**值。如果指数小于 `1`，则会得到一个对数刻度。如果指数大于 `1`，则会得到一个指数刻度。如果是 `1`，则刻度将与线性相同。 + **指数**：指数值，大于 `0`。 **从值开始/结束颜色** 默认情况下，Grafana 根据最小和最大桶值计算单元格颜色。可使用最小值和最大值覆盖这些值。将桶值视为 Z 轴，将最小值和最大值分别视为 Z-Min 和 Z-Max。 + **开始**：用于单元格颜色计算的最小值。如果桶值小于最小值，则将其映射到“最小”颜色。序列最小值为默认值。 + **结束**：用于单元格颜色计算的最大值。如果桶值大于最大值，则将其映射到“最大”颜色。序列最大值为默认值。 ## 单元格显示 使用单元格显示设置来优化热图中单元格的可视化效果。 ## 其他显示选项 **Tooltip** + **显示工具提示**：显示热图工具提示。 + **显示直方图**：在工具提示上显示 Y 轴直方图。直方图表示特定时间戳的桶值的分布。 **图例** 选择是否要在可视化上显示热图图例。 **样本** 设置用于显示样本数据的颜色。 # 直方图面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 直方图可视化计算值的分布并将其显示为条形图。Y 轴和每个条形的高度代表落入每个括号中的值的数量，而 X 轴代表值范围。 直方图可视化支持时间序列和任何带有一个或多个数值字段的表结果。 ## 支持的格式 直方图可视化支持时间序列和任何带有一个或多个数值字段的表结果。 ## 显示选项 使用以下选项来优化可视化效果： **桶大小** 桶的大小。将此字段留空，以自动调整桶大小（约为全量程的 10%）。 **桶偏移** 第一个桶不应该从零开始。非零偏移会移动聚合窗口。例如，大小为 5（0–5、5–10、10–15）且默认偏移量为 0 的桶将变为 2–7、7–12、12–17，偏移量为 2；在这种情况下，0、5 或 10 的偏移量实际上没有任何作用。通常，此选项将与明确定义的桶大小一起使用，而不是与自动桶大小一起使用。要使此设置生效，偏移量应大于 0 且小于桶大小；超出此范围的值将与该范围内的值具有相同的效果。 **组合序列** 这会将所有序列和字段合并为一个组合的直方图。 **线宽**控制条形图的线宽。 **填充不透明度**控制条形图的填充不透明度。 **渐变模式**设置渐变填充的模式。填充渐变基于线条颜色。要更改颜色，请使用标准颜色方案字段选项。渐变外观受填充不透明度设置的影响。 + **无**：无渐变填充，这是默认设置。 + **不透明度**：渐变的透明度是根据 Y 轴上的值计算的。填充的不透明度随 Y 轴上的值增加而增加。 + **色调**：渐变色是根据线条颜色的色调生成的。 **工具提示模式** 当您将光标悬停在图形上时，Grafana 可以显示工具提示。选择工具提示的行为方式： + **单个**：悬停工具提示仅显示您悬停在上面的序列。 + **全部**：悬停工具提示显示可视化中的所有序列。Grafana 在工具提示的序列列表中以粗体突出显示您悬停在上面的序列。 + **隐藏**：不显示工具提示。 **注意** 使用覆盖从工具提示隐藏单个序列。 ## 图例选项 启用图例选项后，可以显示值映射或阈值括号。要在图例中显示值映射，请务必将标准选项下的“颜色方案”选项设置为“单色”或“经典”调色板。要查看图例中的阈值括号，请将“颜色方案”设置为“来自阈值”。 **图例模式**：使用这些设置可以优化图例在可视化中的显示方式。 + **列表**：以列表形式显示图例。这是图例的默认显示模式。 + **表**：以表的形式显示图例。 + **隐藏**：隐藏图例。 **图例放置**：选择图例的放置位置。 + **底部**：显示在图形下方。 + **右**：显示在图形右侧。 **图例值** 选择要在图例中显示的标准计算。可以输入多个值。有关更多信息，请参阅 [计算类型](v9-panels-calculation-types.md)。 **图例计算** 选择要在图例中显示的计算。可以选择多个值。 # 日志面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 日志面板可视化显示来自支持日志的数据来源（例如 Elastic、Influx 和 Loki）的日志行。通常，您可以使用图形面板旁边的此面板来显示相关进程的日志输出。 日志面板显示在**查询**选项卡上输入的查询结果。多个查询的结果按时间合并和排序。如果数据来源返回的行数超过了可以显示的行数，则可以在面板内滚动。 要限制渲染的行数，可以使用**查询选项**中的**最大数据点**设置。如果未设置，则数据来源通常会强制使用默认限制。 ## 日志级别 对于指定了**级别**标签的日志，我们会使用标签值来确定日志级别，并相应地更新颜色。如果日志未指定级别标签，则会尝试查明其内容是否与任何受支持的表达式匹配（有关更多信息，请参阅下文）。日志级别始终由第一个匹配项决定。如果 Grafana 无法确定日志级别，则会使用**未知的**日志级别对其可视化。有关更多信息，请参阅 [日志可视化](v9-explore-logs.md#v9-explore-logs-viz)。 ## 日志详细信息 每个日志行都有一个可扩展区域，其中带有标签和检测到的字段，以实现更可靠的交互。每个字段或标签有一个统计图标，以显示与所有显示的日志相关的统计信息。 **数据链接** 通过数据链接，您可以将日志消息的任何部分转换为内部或外部链接。创建的链接在**日志详细信息**视图的**链接**部分以按钮的形式显示。 **显示选项** 使用以下设置来优化可视化效果： + **时间**：显示或隐藏时间列。这是与数据来源报告的日志行关联的时间戳。 + **唯一标签**：显示或隐藏唯一标签列，该列仅显示非常见标签。 + **常用标签**：显示或隐藏常用标签 + **换行**：切换换行符。 + **Prettify JSON**：将其设置为 `true` 可打印所有 JSON 日志。此设置不会影响 JSON 以外的任何格式的日志。 + **启用日志详细信息**：切换选项以查看每个日志行的日志详细信息视图。默认设置为 `true`。 + **顺序**：按时间降序或升序显示结果。默认为**降序**，首先显示最新的日志。设置为**升序**可首先显示最旧的日志行。 # 新闻面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 此面板显示 RSS 源。默认情况下，显示来自 Grafana Labs 博客的文章。 在**显示**部分输入 RSS 的 URL。此面板类型不接受任何其他查询。 **注意** RSS 源由 Grafana 前端加载，无需代理。因此，只有配置了相应 [CORS 标头](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)的 RSS 源才会加载。如果尝试显示的 RSS 源无法加载，请考虑重新托管 RSS 源或创建自己的代理。 # 节点图面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 节点图面板可视化定向图形或网络。面板使用定向力布局来有效定位节点，有助于显示复杂的基础设施图、层次结构或运行图。 ## 数据要求 节点图面板需要数据的特定形状才能显示其节点和边。并非每个数据来源或查询都可以在此面板中可视化。 节点图可视化由*节点*和*边*组成。 + *节点*显示为圆形。从应用程序的角度来看，节点可能代表应用程序、服务或其他任何相关的内容。 + *边*显示为一条连接两个节点的线。连接可能是请求、运算或两个节点之间的某种其他关系。 节点和边都可以具有关联的元数据或统计数据。数据来源定义了显示哪些信息和值，因此不同的数据来源可以显示不同类型的值，也可以不显示某些值。 ## Nodes 通常，节点在节点内部显示两个统计值，在节点正下方显示两个标识符，通常是名称和类型。节点还可以在节点周围用彩色圆圈显示另一组数值，不同颜色的部分代表不同的数值，这些数值相加应为 1。例如，您可以用圆圈的红色部分表示误差百分比。 其他详细信息可以显示在上下文菜单中，该菜单会在您选择节点时显示。上下文菜单中还可以有其他链接，这些链接可以指向 Grafana 工作区的其他部分或任何外部链接。 **注意** 节点图只能显示 1500 个节点。如果超过此限制，则右上角会显示一条警告，某些节点会被隐藏。您可以单击图形中的**隐藏节点**标记，展开图形的隐藏部分。 ## Edges 当您将鼠标悬停在边上时，边也可以显示统计数据。与节点类似，您也可以选择边以打开包含其他详细信息和链接的上下文菜单。 支持此可视化的第一个 AWS X-Ray 数据源是其服务地图功能的数据源。有关更多信息，请参阅 [Connect 连接到 AWS X-Ray 数据源](x-ray-data-source.md)。 ## 浏览节点图 通过选择任何节点或边的外部并拖动指针，可以在节点图内平移。 您可以使用节点图左上角的按钮进行缩放。 **隐藏节点** 为了保持合理的性能，在给定时间显示的节点数量是有限的。超出此限制的节点隐藏在可点击的标记后面，这些标记显示连接到该边的隐藏节点的大致数量。您可以选择标记来围绕该节点展开图形。 **网格视图** 您可以切换到网格视图，以便更好地了解图形中最有趣的节点。网格视图显示网格中没有边的节点，可以按节点内部显示的统计数据或节点的彩色边框表示的统计数据进行排序。 要对节点进行排序，请选择图例中的统计数据。统计数据名称旁边的标记显示当前用于排序和排序方向的统计数据。 选择节点，然后选择**在图形布局中显示**选项，切换回图形布局，将焦点放在所选节点上，以在整个图形的上下文中显示该节点。 ## 数据 API 这种可视化需要从数据来源返回特定形状的数据，以便正确显示。 节点图至少需要一个描述图形边缘的数据帧。默认情况下，节点图将根据此数据帧计算节点和任何统计数据。（可选）如果需要显示更多特定于节点的元数据，则可以发送描述节点的第二个数据帧。您必须在两个数据帧上设置 `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` 用于更易读的标签。 | # 饼图面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 饼图将来自一个或多个查询的简化序列或序列中的值（这些值彼此相关）显示为饼图的切片。切片的弧长、面积和中心角都与切片值成正比，因为它与所有值的总和相关。如果您想以美观的形式快速比较一小组值，最好使用这种类型的图表。 ## 值选项 使用以下选项优化可视化中的值。 **Show (显式)** 选择要显示的信息量。 + **计算**：将每个值归约为每个序列的单个值。 + **所有值**：显示单个序列中的每个值。 **计算** 选择计算后，选择计算以归约每个序列。有关可用计算的信息，请参阅[计算类型](v9-panels-calculation-types.md)。 **限制** 显示单个序列中的每个值时，这会限制显示的值数量。 **字段** 选择要在可视化中显示的字段。列表中提供了每个字段名称，也可以选择以下选项之一： + **数值字段**：所有包含数值的字段。 + **所有字段**：所有未由转换删除的字段。 + **时间**：所有带有时间值的字段。 ## 饼图选项 使用以下选项来优化可视化效果。 **饼图类型** 选择饼图的显示样式。可以是以下任一项： + **饼图**：标准饼图 + **甜甜圈**：中间有洞的饼图 **标签** 选择要在饼图上显示的标签。您可以选择多个标签。 + **名称**：序列或字段名称。 + **百分比**：占整体的百分比。 + **值**：原始数值。 默认情况下，标签在图表正文上显示为白色。您可以选择深颜色的图表，使其更加明显。较长的名称或数字可能会被截断。 **工具提示模式** 当您将光标悬停在可视化上时，Grafana 可显示工具提示。选择工具提示的行为方式。 + **单个**：悬停工具提示仅显示一个序列，即您将鼠标悬停在可视化上面的序列。 + **全部**：悬停工具提示显示可视化中的所有序列。Grafana 在工具提示的序列列表中以粗体突出显示您悬停在上面的序列。 + **隐藏**：与可视化交互时不显示工具提示。 使用覆盖从工具提示隐藏单个序列。 **图例模式** 使用这些设置可定义图例在可视化中的显示方式。有关图例的更多信息，请参阅[配置图例](v9-panels-configure-legend.md)。 + **列表**：以列表形式显示图例。这是图例的默认显示模式。 + **表**：以表的形式显示图例。 + **隐藏**：隐藏图例。 **图例放置** 选择显示图例的位置。 + **底部**：显示在图形下方。 + **右**：显示在图形右侧。 **图例值** 选择要在图例中显示的[标准计算](v9-panels-calculation-types.md)。可以输入多个值。 选择要在图例中显示的值。可以选择多个值。 + **百分比**：占整体的百分比。 + **值**：原始数值。 有关图例的更多信息，请参阅[配置图例](v9-panels-configure-legend.md)。 # Plotly 面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.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.buffer let y = data.series[0].fields[1].values.buffer let serie = { x : x, y : y, name : variables.project //where project is the name of a Grafana’s variable } return { data : [serie], config : { displayModeBar: false } } ``` *数据*、*布局*和*配置*字段中提供的脚本和 JSON 返回的对象将被合并（深度合并）。 如果未提供脚本，面板将仅使用*数据*、*布局*和*配置*字段。 # Sankey 面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.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 链接的布局。此数字必须为整数，并且是用于生成布局的松弛迭代次数。 # 散点面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.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 控制面板中，选择**添加面板**。 1. 对于查询，编写一个将返回所需数据的查询。在这种情况下，您将使用 `SELECT * FROM HEIGHT` 之类的查询。 1. 选择**散点**可视化。 这将创建一个散点图，使用第一列作为 X 轴，其他数值列作为 Y 轴。 **配置选项** 散点面板提供以下四个自定义配置选项。 + **X 轴**：您可以选择用作 X 轴的字段，以及轴的范围、标题和显示信息。 + **Y 轴**：您可以选择用作 Y 轴的字段，包括每个字段的显示选项以及轴的范围和标题信息。您还可以选择显示每个字段的回归线。有关回归线配置的更多详细信息，请参阅以下信息。 + **图例**：您可以打开或关闭面板的图例，也可以选择图例中文本的大小。 + **显示**：您可以为图表设置其他选项，包括网格颜色和边框样式。 **回归线配置** 除了单个点之外，每个 Y 轴数据集还可以显示一条线。有五个线条类型的选项。 + **无**：不显示回归线。 + **简单**：显示连接数据集点的回归线。 + **线性**：使用最小二乘法这种最佳拟合方法显示一条直线。 + **指数**：显示指数最佳拟合回归线。 + **幂**：显示幂最佳拟合回归线。 # 统计面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 统计面板可视化显示一个很大的统计值，并带有可选的图表迷你图。您可以使用阈值来控制背景或值颜色。 默认情况下，统计面板将显示以下内容之一： + 仅单个序列或字段的值。 + 多个序列或字段的值和名称。 您可以使用**文本模式**来控制是否显示文本。 ## 自动布局调整 面板会根据控制面板中的可用宽度和高度自动调整布局。如果面板变得太小，将会自动隐藏图形（迷你图）。 ## 值选项 使用以下选项来优化可视化显示值的方式： **Show (显式)** 选择 Grafana 显示数据的方式。 **计算** 显示基于所有行的计算值。 + **计算**：选择一个 reducer 函数，Grafana 将使用该函数将多个字段归约为单个值。有关可用计算的列表，请参阅[标准计算](v9-panels-calculation-types.md)。 + **字段**：选择面板中显示的字段。 **所有值** 为每行显示一个单独的统计数据。如果选择此选项，则还可以限制要显示的行数。 + **限制**：要显示的最大行数。默认为 5000。 + **字段**：选择面板中显示的字段。 ## 统计样式 设置可视化的样式。 **方向** 选择堆叠方向。 + **自动**：Grafana 会选择其认为最佳的方向。 + **水平**：从左到右水平拉伸条形图。 + **垂直**：从上到下垂直拉伸条形图。 **文本模式** 您可以使用文本模式选项来控制面板渲染的文本。如果值并不重要，重要的是名称和颜色，则将**文本模式**更改为**名称**。该值仍用于确定颜色，并显示在工具提示中。 + **自动**：如果数据包含多个序列或字段，则同时显示名称和值。 + **值**：仅显示值，不显示名称。名称显示在悬停工具提示中。 + **值和名称**：始终显示值和名称。 + **名称**：显示名称而不是值。值显示在悬停工具提示中。 + **无**：不显示任何内容（空）。名称和值显示在悬停工具提示中。 **颜色模式** 选择一种颜色模式。 + **值**：仅为值和图形区域着色。 + **背景**：同时为背景着色。 **图形模式** 选择图形和迷你图模式。 + **无**：隐藏图形并仅显示值。 + **面积**：在值下方显示面积图。这要求您的查询返回时间列。 **文本对齐方式** 选择对齐模式。 + **自动**：如果仅显示单个值（不重复），则该值居中。如果显示多个序列或多行，则该值为左对齐。 + **中心**：统计值居中。 文本大小 调整仪表文本的大小。 + **标题**：输入仪表标题大小的数值。 + **值**：输入仪表值大小的数值。 # 状态时间轴面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 状态时间轴面板可视化显示一段时间内的离散状态变化。每个字段或序列都渲染为其唯一的水平段。状态区域可以用值或不用值渲染。此面板适用于字符串或布尔状态，但也可以与时间序列一起使用。与时间序列一起使用时，使用阈值将数值转换为离散状态区域。 ## 状态时间轴选项 使用以下选项来优化可视化效果： **合并相等的连续值** 控制 Grafana 是否合并相邻的相同值。 **显示值** 控制是否在状态区域内渲染数值。如果有足够的空间，Auto 将渲染值。 **对齐值** 控制状态区域内的值对齐。 **行高** 控制行间的间距。1 = 无间距，0.5 = 50% 间距。 **线宽** 控制状态区域的线宽。 **填充不透明度** 控制状态区域的不透明度。 ## 值映射 要为布尔值或字符串值分配颜色，请使用 [配置值映射](v9-panels-configure-value-mappings.md)。 ## 带阈值的时间序列数据 该面板也可以用于时间序列数据。在这种情况下，使用阈值将时间序列转换为离散的彩色状态区域。 ## 图例选项 启用图例选项后，可以显示值映射或阈值括号。要在图例中显示值映射，请务必将“标准”选项下的“颜色方案”选项设置为“单色”或“经典”调色板。要查看图例中的阈值括号，请将“颜色方案”设置为“来自阈值”。 **图例模式**：使用这些设置可以优化图例在可视化中的显示方式。 + **列表**：以列表形式显示图例。这是图例的默认显示模式。 + **表**：以表的形式显示图例。 + **隐藏**：隐藏图例。 **图例放置**：选择图例的放置位置。 + **底部**：显示在图形下方。 + **右**：显示在图形右侧。 **图例值** 选择要在图例中显示的[标准计算](v9-panels-calculation-types.md)。可以输入多个值。 # 状态历史面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 状态历史可视化显示一段时间内的周期性状态。每个字段或序列都渲染为水平行。然后渲染框并围绕每个值居中。 状态历史可视化适用于字符串、布尔值和数值字段或时间序列。时间字段为必填项。您可以使用值映射为字符串着色，或为数字范围赋予文本值。 ## 显示选项 使用以下选项来优化可视化效果： **显示值** 控制值是否在值框内渲染。如果有足够的空间，Auto 将渲染值。 **列宽**控制框的宽度。1 = 最大宽度，0 = 最小宽度。 **线宽**控制状态区域的线宽。 **填充不透明度**控制状态区域的填充不透明度。 ## 值映射 要为布尔值或字符串值分配颜色，请使用 [配置值映射](v9-panels-configure-value-mappings.md)。 ## 带阈值的时间序列数据 该面板也可以用于时间序列数据。在这种情况下，使用阈值为框着色。也可以使用渐变配色方案为值着色。 ## 图例选项 启用图例选项后，可以显示值映射或阈值括号。要在图例中显示值映射，请务必将“标准”选项下的“颜色方案”选项设置为“单色”或“经典”调色板。要查看图例中的阈值括号，请将“颜色方案”设置为“来自阈值”。 **图例模式**：使用这些设置可以优化图例在可视化中的显示方式。 + **列表**：以列表形式显示图例。这是图例的默认显示模式。 + **表**：以表的形式显示图例。 + **隐藏**：隐藏图例。 **图例放置**：选择图例的放置位置。 + **底部**：显示在图形下方。 + **右**：显示在图形右侧。 **图例值** 选择要在图例中显示的[标准计算](v9-panels-calculation-types.md)。可以输入多个值。 # 表面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 表面板可视化非常灵活，支持时间序列、表、注释和原始 JSON 数据的多种模式。此面板还提供日期格式、值格式和着色选项。 ## 对列排序 单击列标题，将排序顺序从默认降序改为升序。每次单击时，排序顺序都会变为循环中的下一个选项。一次只能按一列排序。 ## 表选项 **显示标题** 显示或隐藏从数据来源导入的列名称。 ## 列宽 默认情况下，Grafana 会根据表大小和最小列宽自动计算列宽。此字段选项可以覆盖设置，并以像素为单位定义所有列的宽度。 例如，如果在字段中输入 `100`，则在字段外部单击时，所有列的宽度都将设置为 100 像素。 ## 最小列宽 默认情况下，表列的最小宽度为 150 像素。该字段选项可以覆盖默认值，并以像素为单位定义表面板新的最小列宽。 例如，如果在字段中输入 `75`，则在字段外部单击时，所有列的宽度将缩放到不小于 75 像素。 对于小屏幕设备（如智能手机或平板电脑），您可以将默认 `150` 像素值减小为 `50`，以便在控制面板中正确渲染表面板。 ## 列对齐方式 选择 Grafana 对齐单元格内容的方式： + 自动（默认） + 靠左对齐 + 居中对齐 + 靠右对齐 ## 单元格类型 默认情况下，Grafana 会自动选择显示设置。您可以选择以下选项之一来覆盖设置，为所有字段设置默认值。对于某些单元格类型，还可提供其他配置。 **注意** 如果您在**字段**选项卡中进行设置，该类型将应用于所有字段，包括时间字段。您可以在**覆盖**选项卡中进行设置，以将更改应用于一个或多个字段。 **颜色文本** 如果设置了阈值，则字段文本将以相应的阈值颜色显示。 **彩色背景（渐变或纯色）** 如果设置了阈值，则字段背景将以相应的阈值颜色显示。 **计量表** 单元格可以显示为图形仪表，具有几种不同的表示类型。 **基本** 基本模式将显示一个简单的仪表，其阈值水平定义了仪表的颜色。 **渐变** 阈值水平定义渐变。 **LCD** 将仪表分成点亮或不点亮的小单元格。 **JSON 视图** 显示格式化为代码的值。如果值是对象，则允许浏览 JSON 对象的 JSON 视图在悬停时显示。 ## 单元格值检查 从表单元格启用值检查。原始值显示在模态窗口中。 **注意** 仅当单元格显示模式设置为自动、彩色文本、彩色背景或 JSON 视图时，单元格值检查才可用。 ## 列筛选器 您可以暂时更改列数据的显示方式。例如，您可以按从高到低的顺序排列值，或者隐藏特定的值。有关更多信息，请查看以下[筛选表列](#v9-panels-table-filter)。 ## 分页 使用此选项启用或禁用分页。这是一个前端选项，不影响查询。启用后，页面大小会自动调整为表的高度。 ## 筛选表列 如果打开**列筛选器**，可以筛选表选项。 **打开列筛选** 1. 在 Grafana 中，导航到表控制面板，其中包含要筛选的列。 1. 在要筛选的表面板上，打开面板编辑器。 1. 选择**字段**选项卡。 1. 在**表**选项中，打开**列筛选器**选项。 每个列标题旁边都会显示一个筛选器图标。 **筛选列值** 要筛选列值，请选择列标题旁边的筛选器（漏斗）图标。Grafana 会显示该列的筛选选项。 选中要显示的值旁边的复选框。在顶部的搜索字段中输入文本，在显示屏中显示这些值，这样您就可以从中选择，而不用滚动来查找。 **清除列筛选条件** 应用筛选条件的列在标题旁边会显示一个蓝色的漏斗。 要删除筛选条件，请选择蓝色漏斗图标，然后选择清除筛选条件。 ## 表脚注 您可以使用表脚注来显示字段的[计算](v9-panels-calculation-types.md)。 启用表脚注后，您可以选择**计算**，然后选择要计算的**字段**。 如果未选择字段，系统会将计算应用于所有数值字段。 **计算行数** 如果要显示数据集中的行数，而不是所选字段中的值数，请选择**计数**计算并启用**计算行数**。 # 文本面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 文本面板使您可以直接在控制面板中包含文本或 HTML。可将其用于添加上下文信息和描述或嵌入复杂的 HTML。 **Mode (模式)** 模式决定了嵌入内容的显示方式。具有以下选项 + **Markdown**：此选项将内容格式化为 markdown。 + **HTML**：此设置将内容渲染为经过清理的 HTML。 + **代码**：此设置在只读代码编辑器中渲染内容。选择适当的语言，对嵌入文本应用语法突出显示。 **变量** 内容中的变量将展开以供显示。 # 时间序列面板 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 时间序列面板可将时间序列渲染成线条、点路径或条形图序列。这种类型的图形用途广泛，几乎可以显示任何时间序列数据。 **注意** 您可以将图形面板可视化迁移到时间序列可视化。若要迁移，请在**面板**选项卡上，选择**时间序列可视化**。Grafana 会传输所有适用的设置。 **Topics** + [工具提示选项](v9-time-series-panel-tooltip.md) + [图例选项](v9-time-series-panel-legend.md) + [图形样式选项](v9-time-series-graph.md) + [轴选项](v9-time-series-axis.md) + [颜色选项](v9-time-series-color.md) # 工具提示选项 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 当您将光标悬停在图形上时，Grafana 可以显示工具提示。选择工具提示的行为方式： + **单个**：悬停工具提示仅显示您悬停在上面的序列。 + **全部**：悬停工具提示显示图形中的所有序列。Grafana 在工具提示的序列列表中以粗体突出显示您悬停在上面的序列。 + **隐藏**：不显示工具提示。 # 图例选项 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 **图例模式**：选择图例的显示方式。 + **列表**：以列表形式显示图例。这是默认值。 + **表**：以表的形式显示图例。 + **隐藏**：隐藏图例。 **图例放置**：选择是否显示图例。 + **底部**：显示在图形下方。 + **右**：显示在图形右侧。 **图例计算** 选择要在图例中显示的计算。有关更多信息，请参阅 [计算类型](v9-panels-calculation-types.md)。 # 图形样式选项 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 **图形样式** 可使用此选项定义如何显示时间序列数据。您可以使用覆盖在同一个图形中组合多种样式。这里有三个样式选项：其他一些样式选项仅适用于某些图形样式。 + **线**：在图形上将时间序列显示为一条线。 + **条形图**：将时间序列显示为图形上的一系列条形图，每个条形图对应一个数据点。 + **点**：将时间序列显示为图形上的一系列点，每个点对应一个数据点。 **条形图对齐** 对于条形图，设置条形图相对于图形上绘制点的位置。由于条形图具有宽度，可将其放置在点的前面、后面或居中。选项包括**前**、**居中**或**后**。 **线宽** 设置折线图的线条粗细，或条形图中每个条的轮廓粗细。 **填充不透明度** 设置填充颜色的不透明度。例如，填充用于显示折线图中线条下方的区域，或用作条形图中条形的颜色。 **渐变模式** 渐变模式指定渐变填充，该填充基于序列颜色。要更改颜色，请使用标准颜色方案字段选项。有关更多信息，请参阅 [颜色方案](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme)。渐变模式选项包括： + **无**：无渐变填充。 + **不透明度**：一种不透明度渐变，其中填充的不透明度随着 Y 轴值的增加而增加。 + **色调**：一种基于序列色调的渐变。 + **方案**：由您的颜色方案定义的颜色渐变。该设置可用于填充和线条。有关更多信息，请参阅 [颜色选项](v9-time-series-color.md)。 渐变外观也可以通过**填充不透明度**设置来修改。 **显示点** 您可以配置可视化以向折线图或条形图添加点。您可以选择**始终**、**从不**或**自动**。使用**自动**时，Grafana 会根据数据的密度来确定是否显示点。如果数据的密度足够低，则会显示点。 **点大小** 设置绘制点的大小，直径从 1 到 40 像素不等。 **线插值** 选择 Grafana 插入序列线的方式。选项包括**线性**、**平滑**、**前一步**和**后一步**。 **线型** 设置线条样式。要更改颜色，请使用标准颜色方案字段选项。 线条样式的外观受**线宽**和**填充不透明度**设置的影响。 线条样式的选项包括**实线**、**虚线**和**点线**。 **连接 null 值** 选择 null 值（数据中的图形）在图形上的显示方式。可以将空值连接起来形成一条连续的线，也可以设置一个阈值，如果超过该阈值，数据间隙将不再连接。您可以选择**从不**连接有间隙的数据点，**始终**连接有间隙的数据点，或者设置一个**阈值**，当达到该阈值时，数据间隙将不再连接。 **堆栈序列** *堆叠*允许 Grafana 相互叠加显示序列。在可视化中使用堆叠时要小心，因为很容易创建误导性图形。要了解为什么堆叠可能不是最佳方法的更多信息，请参阅[堆叠问题](https://www.data-to-viz.com/caveat/stacking.html)。 堆叠选项包括： + **关闭**：关闭序列堆叠。 + **正常**：将序列堆叠在一起。 + **100%**：按百分比堆叠，其中所有序列相加为 100%。 **分组堆叠序列** 您可以覆盖堆叠行为以分组堆叠序列。有关创建覆盖的更多信息，请参阅 [配置字段覆盖](v9-panels-configure-overrides.md)。创建覆盖时，请指定您希望序列所属的堆叠组的名称。 **填充至下方** **填充至下方**选项填充两个序列之间的区域。此选项仅以序列或字段覆盖形式提供。使用此选项，您可以填充两个序列之间的区域，而不是从序列线向下填充到 0。例如，如果您有两个名为 *Max* 和 *Min* 的序列，您可以选择 **Max** 序列并将其覆盖，以**填充至下方** **Min** 序列。这将仅填充两条序列线之间的区域。 # 轴选项 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 轴类别下的选项会更改 X 和 Y 轴的渲染方式。某些选项只有在您编辑的字段选项框外部单击后才会生效。也可以按 `Enter` 键。 **放置** 设置 Y 轴的放置。选项包括： + **自动**：Grafana 会自动为序列分配 Y 轴。当有两个或多个具有不同单位的序列时，Grafana 将左轴分配给第一个单位，将右轴分配给下一个单位。 + **左**：在左侧显示所有 Y 轴。 + **右**：在右侧显示所有 Y 轴。 + **隐藏**：隐藏所有 Y 轴。 要为每个字段或序列分配轴，请[添加字段覆盖](v9-panels-configure-overrides.md)。 **标签** 设置 Y 轴文本标签。如果有多个 Y 轴，可使用覆盖分配不同的标签。 **Width (宽度)** 设置轴的固定宽度。默认情况下，Grafana 会动态计算轴的宽度。 通过设置轴的宽度，具有不同轴类型的数据可以共享相同的显示比例。此设置让您更容易比较多个图形的数据，因为轴在视觉上不会相互错位或拉伸。 **软最小值和软最大值** 设置**软最小值**或**软最大值**选项，以更好地控制 Y 轴限制。默认情况下，Grafana 会根据数据集自动设置 Y 轴的范围。 软最小值和软最大值设置允许在不存在重大更改时看到微小的变化。根据标准最小值和最大值字段选项得出硬最小值或最大值，可防止间歇性尖峰通过将尖峰剪过特定点来压平有用的细节。 要定义 Y 轴的硬限制，可以设置标准 min/max 选项。有关更多信息，请参阅[配置标准选项](v9-panels-configure-standard-options.md)。 **Scale** 设置 Y 轴刻度。选项包括**线性**或**对数**。如果选择对数，则可以进一步选择以 2 为底数或以 10 为底数的对数刻度。 **转换** 您可以覆盖序列以将转换应用于图表上的值（而不会影响基础值或工具提示、上下文菜单或图例中的值）。您有两个转换选项： + **负 Y 转换**：将结果翻转为 Y 轴上的负值。 + **常量**：将第一个值显示为常量线。 # 颜色选项 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 默认情况下，图形使用标准[颜色方案](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme)选项来指定序列颜色。您也可以通过单击图例序列颜色图标，使用图例打开颜色选取器。以这种方式设置颜色会自动创建覆盖规则，为特定序列设置特定颜色。 以下是可用于覆盖序列颜色默认值的其他选项。 **经典调色板** 最常见的设置是使用**经典调色板**绘制图形。此方案根据每个字段或序列的顺序自动为其分配颜色。如果查询中字段的顺序发生变化，颜色也会发生变化。您可以使用覆盖规则手动配置特定字段的颜色。 **单色** 使用此模式指定颜色。您还可以单击图例中每个序列旁边的彩色线条图标来打开颜色选取器。这将自动创建一个新的覆盖，将颜色方案设置为单色和选定颜色。 **按值颜色方案** 如果您选择按值配色方案，例如**从阈值（按值）**或 **Green-Yellow-Red （按值）**，则会出现 “**按系列着色**” 选项。此选项控制使用哪个值（最后一个、最小值、最大值）为序列指定颜色。 **方案渐变模式** 位于**图形样式**下方的**渐变模式**选项有一个名为 **Scheme** 的模式。启用 **Scheme** 时，线条或条形图会收到根据选定**方案**定义的渐变颜色。 **来自阈值** 如果将**颜色方案**设置为**来自阈值（按值）**，将**渐变模式**设置为**方案**，则线条或条形图颜色在超出定义的阈值时会发生变化。您只会看到在方案中选择的具体颜色。 **渐变颜色方案** 使用渐变颜色方案而*不*将**渐变模式**设置为**方案**，这意味着当序列中的值在设置的阈值之间移动时，所选颜色将在所选颜色之间形成渐变。 # 跟踪面板（测试版） **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 *跟踪*是一种可视化方式，使您能够在请求遍历基础设施中的服务时跟踪和记录请求。 有关跟踪的更多信息，请参阅 [Explore 中的跟踪](v9-explore-tracing.md)。 # WindRose **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.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) ## 选项 该 WindRose 面板支持以下选项： + 轴频率 + 轴样式（度数或指南针） + 刻度（线性、平方、对数）