首页/云/可观测性速查/Max data points 与步长控制
Grafana 与看板53 条

Max data points 与步长控制

Max data points 与 Min interval 共同决定查询步长:步长过大趋势变粗、速率窗口失真;两者是精度与后端负载的平衡旋钮。

可观测性速查云更新于 2026-10-13

Max data points 是什么

Max data points 与 Min interval 两个设置共同决定查询步长:步长决定图上每个数据点代表多长时间的数据。步长过大,趋势被粗化,速率类函数因窗口与步长失配而失真;步长过小,后端查询压力与返回数据量同时上升。这个旋钮本质上是在精度与负载之间做平衡,理解关系后再调,才不会出现「大屏上看不出尖峰」这类问题。

基本信息

配置位置面板 Query options 区域
Max data points0 表示按面板像素宽度自动计算
Min interval步长下限,防止自动计算得过于激进
近似关系步长约为 Min interval 与「时间范围除以点数」中的较大者

典型使用场景

  • 大屏适配:固定点数让大屏与普通屏幕的查询负载接近
  • 长范围巡检:为周报看板放宽步长,减少后端压力
  • 告警复盘:为关键面板收紧步长,保留尖峰细节
  • 速率窗口匹配:用自动速率变量让窗口随步长变化
  • 慢面板优化:先判断是数据源慢还是点数过多

关系与配置位置

关系与配置位置
# 面板 Query options:
Max data points = 0        # 按面板宽度自动决定点数
Min interval = 30s         # 步长下限

# 近似关系:
# 步长 ≈ max(Min interval, 时间范围 / Max data points)

# 速率类查询窗口随步长自适应的写法:
rate(http_requests_total[$__rate_interval])

# 手写固定窗口的问题:
# 在长范围大屏上窗口小于步长时曲线出现台阶,尖峰被抽平

# 排查慢面板:先看 Query inspector 里的查询耗时与返回点数

设置与效果

设置作用取值思路
Max data points单条序列返回的最大点数大屏固定一个值以便负载可控
Min interval步长下限不低于抓取间隔,否则无意义
自动变量让窗口随步长变化速率类查询优先使用
间隔变量按时间范围自动选聚合间隔写查询时优先复用
步长与抓取间隔的关系是硬约束:步长小于抓取间隔时不会增加信息量,只会重复返回同一批样本,白白消耗后端资源。
排查面板慢的次序建议是:先看查询本身是否过重,再看返回点数是否远超前端可渲染的数量,最后才考虑提高数据源侧的性能。

易错点

  • 手写固定速率窗口在长范围大屏上与步长失配,曲线出现台阶或尖峰被抽平
  • 把 Max data points 固定得过小,复盘细粒度故障时看不到尖峰,误判为没有异常
  • 步长设置小于抓取间隔不会提升精度,只增加查询与传输开销
  • 不同面板使用不同步长时,同一指标在不同面板上看起来不一致,容易引发误判

数据来源与参考

  • Grafana 官方文档 · Query options
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌