首页/云/可观测性速查/内置宏:$__interval 与 $__rate_interval
Grafana 与看板53 条

内置宏:$__interval 与 $__rate_interval

面板查询里的时间宏由 Grafana 按时间范围与面板宽度实时计算:$__interval 是步长,$__rate_interval 是自适应速率窗口,避免窗口过小。

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

推荐写法

推荐写法
# 速率类查询用 rate 窗口宏(不小于抓取间隔的若干倍)
rate(http_requests_total[$__rate_interval])

# 其他常用宏
$__interval      # 面板当前步长(如 1m)
$__interval_ms   # 步长的毫秒数值
$__range         # 时间范围文本(如 6h)
$__from / $__to  # 起止毫秒时间戳
官方推荐 rate 等窗口函数搭配 $__rate_interval,可覆盖“窗口小于步长”的边界情况。

易错点

  • 固定写死 [5m] 而面板步长大于 5m 时,rate 会退化成对不上步长的稀疏采样
  • 把 $__rate_interval 用在 increase/sum_over_time 时可以,但语义是窗口不是速率,注意区分

数据来源与参考

  • Grafana 官方文档 · Global variables
  • Prometheus 文档 · rate 使用要点
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌