PAYATHON 2026

如何在 Grafana 中显示 GridDB 传感器数据的每分钟平均值?

数据小陈

结论

当前使用的 GridDB Grafana 插件如果没有提供 SQL 查询输入框,就无法在 panel 里直接写 GROUP BY RANGE 来计算每分钟平均值。TIME_SAMPLING 只适合降采样或插值,不能保证对每分钟内所有原始读数执行 AVG()。能走的路有三条:插件支持 SQL 时,直接写聚合 SQL;在 GridDB 侧做预聚合,再让 Grafana 读取聚合后的 container;或者自建 HTTP API,由 API 执行 GROUP BY RANGE 聚合,Grafana 通过 JSON/Infinity 数据源读取结果。

为什么 TIME_SAMPLING 不等于每分钟平均

TIME_SAMPLING 一般是在查询结果或渲染阶段按时间间隔取点或插值,用来减少曲线点数。它不会把一分钟内每 2 秒一条的读数全部加起来再除以条数。时间范围短时看着正常,是因为原始点少;范围拉到 24 小时,如果只做采样,曲线可能很平滑,但数值并不是严格的分钟平均。

方案一:插件支持 SQL 时直接聚合

先确认插件版本是否提供 SQL 或自定义查询编辑器。如果有,直接把聚合 SQL 放进查询,并让返回的 ts 作为时间列。示例:

SELECT
  ts,
  AVG(heart_rate) AS avg_heart_rate,
  MIN(heart_rate) AS min_heart_rate,
  MAX(heart_rate) AS max_heart_rate
FROM device_01
WHERE ts BETWEEN TIMESTAMP('2026-09-27T00:00:00Z')
  AND TIMESTAMP('2026-09-28T00:00:00Z')
GROUP BY RANGE ts EVERY (1, MINUTE)
ORDER BY ts;

如果插件支持 Grafana 时间变量宏,可以把固定时间换成插件对应的时间过滤变量。不同插件版本对宏的支持不一样,要以实际插件文档和查询编辑器为准。没有 SQL 输入框时,这条路走不通。

方案二:GridDB 侧预聚合(推荐)

最稳妥的做法是新建一个按分钟聚合的 Time Series container,例如 device_01_1m,字段可以包含:

timestamp (TIMESTAMP, row key) | avg_heart_rate (DOUBLE) | min_heart_rate (INTEGER) | max_heart_rate (INTEGER) | avg_temperature (DOUBLE)

再用定时任务每分钟或每几分钟执行一次聚合 SQL,把结果写入这个 container。Grafana 只查询 device_01_1m,数据量会从每 2 秒一条降到每分钟一条,24 小时也只有 1440 条左右。聚合查询仍然可以使用:

SELECT
  ts,
  AVG(heart_rate) AS avg_heart_rate,
  MIN(heart_rate) AS min_heart_rate,
  MAX(heart_rate) AS max_heart_rate,
  AVG(temperature) AS avg_temperature
FROM device_01
WHERE ts BETWEEN TIMESTAMP('2026-09-27T00:00:00Z')
  AND TIMESTAMP('2026-09-28T00:00:00Z')
GROUP BY RANGE ts EVERY (1, MINUTE)
ORDER BY ts;

写入由外部定时程序完成,例如 cron + 应用脚本、Java 定时任务或其他调度工具。这样 Grafana 插件不用理解复杂 SQL,只要读取已经聚合好的 container。

方案三:自定义 API + Grafana JSON/Infinity 数据源

如果不想改存储结构,也可以做一个轻量 HTTP 服务。Grafana 把时间范围传给服务,服务在 GridDB 中执行 GROUP BY RANGE,返回时间序列 JSON。Grafana 用 Infinity 数据源或 JSON API 数据源读取。返回结构示例:

[
  {
    "timestamp": "2026-09-27T10:00:00Z",
    "avg_heart_rate": 78.4,
    "min_heart_rate": 71,
    "max_heart_rate": 89
  }
]

接口收到 from、to 后,再拼接或参数化执行聚合 SQL,不要直接把用户输入拼进 SQL。在 Grafana panel 中把 timestamp 设为 time 字段,把 avg_heart_rate 设为数值字段即可。

注意事项

  • 不要用 Grafana 的 Max data points 或 TIME_SAMPLING 代替真实聚合。它们只改变显示采样,不能保证统计口径。
  • 如果只在 Grafana 端临时拉原始数据再处理,24 小时、每 2 秒一条的数据量会带来很大的传输和渲染压力,不适合作为长期方案。
  • 聚合 SQL 的时间边界要明确,尤其是 BETWEEN 是否包含右端点,以及时区是否统一为 UTC。
  • 预聚合任务要处理迟到数据和重复执行问题,避免同一分钟被重复写入或漏算。
  • 不同 GridDB Grafana 插件版本功能差异较大,是否支持 SQL 输入要以实际插件界面和版本文档为准。

备注:内容仅供参考。