文档 Grafana 文档 面板和可视化 可视化 直方图

直方图

直方图计算值的分布，并将其显示为条形图。每个条形代表一个箱体；y 轴和每个条形的高度表示落在每个箱体中的值的计数，x 轴表示值范围。

例如，如果您想了解人们身高的分布，您可以使用直方图可视化来识别数据分布中的模式或洞察力。

如果需要，您可以使用直方图可视化

• 在特定时间范围内可视化和分析数据分布，以查看特定值出现的频率。
• 识别数据分布中的任何异常值。
• 提供统计分析以帮助决策

配置直方图可视化

创建 仪表盘 后，以下视频将向您展示如何配置直方图可视化。

支持的数据格式

直方图支持时间序列以及任何具有一个或多个数值字段的表格结果。

示例

以下表格是直方图可视化所需数据类型及其格式的示例。

时间序列表格

数据转换如下

基本数值表格

数据转换如下

面板选项

在面板编辑器窗格的 **面板选项** 部分中，设置基本选项，如面板标题和描述，以及面板链接。要了解更多信息，请参阅 配置面板选项。

直方图选项

使用以下选项来优化直方图可视化。

箱体数量

指定用于在直方图中对数据进行分组的箱体数量，这会影响显示分布的粒度。将此留空以自动计算 30 个箱体数量。

箱体大小

箱体的大小。将此留空以自动确定箱体大小（约为完整范围的 10%）。

箱体偏移量

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

合并序列

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

堆叠

控制如何在直方图中显示多个序列。从以下选项中选择

• **关闭** - 序列不会堆叠，而是并排显示。
• **普通** - 序列相互堆叠，显示累积值。
• **100%** - 序列堆叠以填充图表 100%，显示每个序列的相对比例。

线宽

控制条形的线宽。

填充不透明度

控制填充不透明度条。

渐变模式

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

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

从以下选项中选择

• **无** - 无渐变填充。这是默认设置。
• **不透明度** - 渐变的透明度根据 Y 轴上的值计算。填充的不透明度随着 Y 轴上的值而增加。
• **色调** - 渐变颜色根据线条颜色的色调生成。
• **方案** - 所选 调色板 应用于直方图条。

工具提示选项

工具提示选项控制将鼠标悬停在可视化中的数据点时出现的叠加信息。

工具提示模式

当您将鼠标悬停在可视化上时，Grafana 可以显示工具提示。选择工具提示的行为方式。

• **单一 -** 悬停工具提示仅显示一个序列，即您在可视化上悬停的序列。
• **全部 -** 悬停工具提示显示可视化中的所有序列。Grafana 会在工具提示中的序列列表中以粗体突出显示您悬停的序列。
• **隐藏 -** 当您与可视化交互时，不要显示工具提示。

使用覆盖来隐藏工具提示中的单个序列。

值排序顺序

当您将 **工具提示模式** 设置为 **全部** 时，将显示 **值排序顺序** 选项。此选项控制工具提示中列出值的顺序。从以下选项中选择

• **无** - Grafana 会自动对工具提示中显示的值进行排序。
• **升序** - 工具提示中的值按从小到大排列。
• **降序** - 工具提示中的值按从大到小排列。

最大宽度

设置工具提示框的最大宽度。

最大高度

设置工具提示框的最大高度。默认值为 600 像素。

图例选项

图例选项控制出现在图表下方或右侧的序列名称和统计信息。有关图例的更多信息，请参阅 配置图例。

标准选项

面板编辑器窗格中的**标准选项**可让您更改字段数据在可视化中的显示方式。设置标准选项后，更改将应用于所有字段或系列。要更细致地控制字段的显示方式，请参阅配置覆盖。

要了解更多信息，请参阅配置标准选项。

数据链接

数据链接允许您链接到其他面板、仪表板和外部资源，同时保持源面板的上下文。您可以创建包含系列名称甚至光标下值的链接。

对于每个数据链接，请设置以下选项

• 标题
• URL
• 在新标签页中打开

要了解更多信息，请参阅配置数据链接。

值映射

值映射是一种技术，您可以使用它来更改数据在可视化中的显示方式。

对于每个值映射，请设置以下选项

• **条件** - 选择映射到显示文本和（可选）颜色的内容
  • **值** - 特定值
  • **范围** - 数值范围
  • **正则表达式** - 正则表达式
  • **特殊** - 特殊值，例如Null、NaN（非数字）或布尔值，例如true 和false
• 显示文本
• **颜色**（可选）
• **图标**（仅限画布）

要了解更多信息，请参阅配置值映射。

阈值

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

设置以下选项

• **值** - 设置每个阈值的值。
• **阈值模式** - 从以下选项中选择
  • 绝对值
  • 百分比

要了解更多信息，请参阅配置阈值。

字段覆盖

覆盖允许您为特定字段或系列自定义可视化设置。添加覆盖规则时，它会针对特定字段集，并让您定义多个选项来控制该字段的显示方式。

从以下覆盖选项中选择

要了解更多信息，请参阅配置字段覆盖。