直方图
直方图计算值分布并将它们表示为柱状图。每个柱子代表一个桶；y轴和每个柱子的高度代表落入每个桶的值的计数，x轴代表值范围。
例如，如果您想了解人们的身高分布，可以使用直方图可视化来识别数据分布中的模式或洞察。
如果您需要
- 可视化并分析特定时间范围内的数据分布，以查看某些值出现的频率。
- 识别数据分布中的任何异常值。
- 提供统计分析以帮助决策。
配置直方图可视化
一旦创建了一个仪表板，以下视频将展示如何配置直方图可视化
支持的数据格式
直方图支持时间序列和任何包含一个或多个数值字段的表格结果。
示例
以下表格是直方图可视化所需数据类型的示例以及其格式化方式。
时间序列表
| 时间 | 步行（公里） |
|---|---|
| 2024-03-25 21:13:09 | 37.2 |
| 2024-03-25 21:13:10 | 37.1 |
| 2024-03-25 21:13:10 | 37.0 |
| 2024-03-25 21:13:11 | 37.2 |
| 2024-03-25 21:13:11 | 36.9 |
| 2024-03-25 21:13:12 | 36.7 |
| 2024-03-25 21:13:13 | 36.3 |
数据将按以下方式转换
基本数值表
| 性别 | 身高（公斤） | 体重（磅） |
|---|---|---|
| 男性 | 73.8 | 242 |
| 男性 | 68.8 | 162 |
| 男性 | 74.1 | 213 |
| 男性 | 71.7 | 220 |
| 男性 | 69.9 | 206 |
| 男性 | 67.3 | 152 |
| 男性 | 68.8 | 184 |
数据将按以下方式转换
面板选项
在面板编辑器的面板选项部分，设置基本选项，如面板标题和描述，以及面板链接。要了解更多信息，请参阅配置面板选项。
直方图选项
使用以下选项来细化您的直方图可视化。
桶计数
指定用于在直方图中分组数据的桶数，影响显示分布的粒度。留空将自动进行30个桶的计数。
桶大小
桶的大小。留空将自动设置为全范围的约10%。
桶偏移量
如果第一个桶不应从零开始。非零偏移量将具有将聚合窗口移动的效果。例如，具有默认0偏移量的0-5，5-10，10-15的5个大小桶将变为2-7，7-12，12-17的偏移量为2的桶；在此情况下，0，5或10的偏移量将实际上不起作用。通常，此选项会与显式定义的桶大小一起使用，而不是自动。为此设置产生影响，偏移量应大于0且小于桶大小；此范围之外的价值将具有与该范围内相同的效果。
合并系列
这将合并所有系列和字段到一个组合直方图中。
堆叠
控制多个系列在直方图中的显示方式。以下选项可供选择
- 关闭 - 系列不会堆叠，而是并排显示。
- 正常 - 系列相互堆叠，显示累积值。
- 100% - 系列堆叠以填充100%的图表，显示每个系列的相对比例。
线宽
控制柱子的线宽。
填充不透明度
控制填充不透明度。
渐变模式
设置渐变填充的模式。填充渐变基于线条颜色。要更改颜色，请使用标准的调色板字段选项。
渐变显示受填充不透明度设置的影响。
以下选项可供选择
- 无 - 无渐变填充。这是默认设置。
- 不透明度 - 渐变的透明度基于Y轴上的值计算。填充的不透明度随着Y轴上的值增加而增加。
- 色调 - 渐变颜色基于线条颜色。
- 方案 - 选择的 颜色方案 应用于直方图的条形。
工具提示选项
工具提示选项控制当你在可视化中的数据点上悬停时出现的覆盖信息。
工具提示模式
当你将鼠标悬停在可视化上时，Grafana 可以显示工具提示。选择工具提示的行为。
- 单选 - 悬停工具提示仅显示单个系列，即你在可视化上悬停的那个系列。
- 全部 - 悬停工具提示显示可视化中的所有系列。Grafana 在工具提示中的系列列表中以粗体突出显示你悬停的系列。
- 隐藏 - 当你与可视化交互时，不显示工具提示。
使用覆盖来隐藏工具提示中的单个系列。
值排序顺序
当你将 工具提示模式 设置为 全部 时，将显示 值排序顺序 选项。此选项控制工具提示中值的列表顺序。从以下选项中选择：
- 无 - Grafana 自动排序工具提示中显示的值。
- 升序 - 工具提示中的值按从小到大列出。
- 降序 - 工具提示中的值按从大到小列出。
最大宽度
设置工具提示框的最大宽度。
最大高度
设置工具提示框的最大高度。默认为 600 像素。
图例选项
图例选项控制出现在图形下方或右侧的系列名称和统计数据。有关图例的更多信息，请参阅 配置图例。
| 选项 | 描述 |
|---|---|
| 可见性 | 切换开关以打开或关闭图例。 |
| 模式 | 使用这些设置来定义图例在可视化中的显示方式。 列表 以列表的形式显示图例。这是图例的默认显示模式。 表格 以表格的形式显示图例。 |
| 位置 | 选择显示图例的位置。 底部 将图例放置在图形下方。 右侧 将图例放置在图形右侧。 |
| 宽度 | 控制当图例放置在可视化的右侧时的宽度。如果将图例位置设置为 右侧，则显示此选项。 |
| 值 | 选择要在图例中显示的 标准计算。可以有一个以上的计算。 |
标准选项
标准选项 在面板编辑器窗格中允许您更改在可视化中显示的字段数据。设置标准选项后，更改应用于所有字段或系列。有关对字段显示的更精细控制，请参阅 配置覆盖。
| 选项 | 描述 |
|---|---|
| 单位 | 选择字段应使用的单位。 |
| 最小/最大 | 设置用于百分比阈值计算的最小值和最大值，或者将这些字段留空以自动计算。 |
| 字段最小/最大 | 启用 字段最小/最大 以使 Grafana 根据字段的最小或最大值分别计算每个字段的 min 或 max。 |
| 小数位数 | 指定 Grafana 在渲染的值中包含的小数位数。 |
| 显示名称 | 设置所有字段的显示标题。您可以在字段标题中使用变量。 |
| 颜色方案 | 为整个可视化设置单色或多色。 |
| 无值 | 输入 Grafana 应显示的字段值为空或 null 时应显示的内容。默认值为破折号 (-)。 |
要了解更多信息，请参阅 配置标准选项。
数据链接
数据链接允许您链接到其他面板、仪表板和外部的资源，同时保持源面板的上下文。您可以创建包含系列名称或甚至鼠标光标下的值的链接。
对于每个数据链接，设置以下选项
- 标题
- URL
- 在新标签页中打开
想了解更多，请参阅配置数据链接。
值映射
值映射是一种技术，您可以使用它来更改数据在可视化中的显示方式。
对于每个值映射，设置以下选项
- 条件 - 选择映射到显示文本和（可选）颜色的内容
- 值 - 特定值
- 范围 - 数值范围
- 正则表达式 - 正则表达式
- 特殊 - 如
Null、NaN（非数字）或布尔值如true和false等特殊值
- 显示文本
- 颜色（可选）
- 图标（仅限画布）
想了解更多，请参阅配置值映射。
阈值
阈值是您为指标设置的值或限制，当达到或超过该值时在视觉上体现出来。阈值是您根据查询结果条件性地样式化和着色可视化的一种方式。
对于每个阈值，设置以下选项
| 选项 | 描述 |
|---|---|
| 值 | 为每个阈值设置值。 |
| 阈值模式 | 从 绝对 和 百分比 中选择。 |
想了解更多，请参阅配置阈值。
字段覆盖
覆盖允许您针对特定字段或系列自定义可视化设置。当您添加覆盖规则时，它针对特定的一组字段，并允许您定义该字段显示的多个选项。
从以下覆盖选项中选择
| 选项 | 描述 |
|---|---|
| 具有名称的字段 | 从所有可用字段列表中选择一个字段。 |
| 匹配正则表达式的名称字段 | 使用正则表达式指定要覆盖的字段。 |
| 具有类型的字段 | 通过类型选择字段，例如字符串、数值或时间。 |
| 查询返回的字段 | 选择特定查询返回的所有字段，如 A、B 或 C。 |
| 具有值的字段 | 选择您定义的缩减条件返回的所有字段，如 最小值、最大值、计数、总数。 |
想了解更多，请参阅配置字段覆盖。
