Heatmap 面板是什么
热力图用颜色深浅表示某个分桶区间在某个时刻的样本密度：横轴是时间，纵轴是数值分桶。它适合回答「分布随时间怎么变」，例如延迟长尾何时开始变厚、请求集中在哪个区间。数据来源通常是直方图指标的桶序列，面板把这些桶还原成二维分布，比单看一条分位数曲线包含更多信息。
基本信息
| 适用平台 | Grafana 各版本，面板名 Heatmap |
|---|---|
| 数据要求 | 带分桶维度的序列（如直方图的桶标签） |
| 查询设置 | Query options 里把 Format 设为 Heatmap |
| 关键配置 | Y 轴分桶方式、颜色方案、分位对照线 |
典型使用场景
- 接口延迟分布：观察长尾是稳定存在还是间歇性出现
- 发布前后对比：同一看板切换时间范围，比较分布形态变化
- 容量评估：确认请求集中在哪个区间，据此设置资源水位
- 排查尖刺：定位某个时间段出现的高延迟样本密度
- 对照分位线：把 p95 与 p99 折线叠加在热力图上一起看
查询与面板设置
查询与面板设置
# 直方图桶序列：必须保留 le 维度
sum by (le) (rate(http_request_duration_seconds_bucket{job="api"}[5m]))
# Query options：Format 选 Heatmap；Legend 可写 {{le}} 便于辨识
# Y 轴分桶：Bucket size 或 Bucket count 二选一
# 固定桶大小适合比较不同时间段；桶数量适合自适应展示
# 颜色方案：连续渐变，按最大值自适应或设固定上限
# 叠加分位线：用另一条查询画 p95 与 p99，便于肉眼对照长尾
# 直方图桶边界由上报侧决定，面板无法凭空细化分桶配置项与影响
| 配置项 | 作用 | 取值建议 |
|---|---|---|
| Y 轴分桶方式 | 决定行数与分辨率 | 比较不同时段时用固定桶大小 |
| 颜色方案 | 表示密度高低 | 固定上限可避免最大值变化导致的视觉漂移 |
| 单元格显示 | 是否显示数值 | 数据稀疏时打开便于确认样本量 |
| 缺数据 | 无样本的桶如何处理 | 按零处理与留空在观感上差别明显 |
| 叠加折线 | 分位对照线 | 用不同颜色区分 p95 与 p99 |
分桶边界由指标上报端决定，桶过粗看不到长尾、过细则每个格子样本量太少出现噪点；调整分桶要改应用侧的直方图定义，面板只能做展示。
热力图适合观察分布，不适合替代分位数告警：告警规则仍应基于分位查询，热力图是给人看的辅助视图。