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

# 直方图面板
<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)。