SQL Grafana 的 PostgreSQL / MySQL 数据源 dashboard 与告警规则模板

10次阅读

postgresql 中 time 字段需显式命名为 ”time” 并确保为 timestamptz 类型,否则 grafana 无法识别为时间序列;mysql 告警中 now() 是常量,应改用 date_sub(now(), interval 5 minute) 实现动态窗口。

SQL Grafana 的 PostgreSQL / MySQL 数据源 dashboard 与告警规则模板

PostgreSQL 数据源里 time 字段不被 Grafana 识别为时间序列?

Grafana 要把查询结果当时间序列画图,必须明确告诉它哪个字段是时间戳。PostgreSQL 默认不认 timestamptimestamptz 列为时间字段,除非你显式标注。

实操建议:

  • 在 SQL 查询末尾加 AS "time"(注意双引号,Grafana 强制要求字段名严格匹配)
  • 确保该字段类型是 timestamp with time zone;用 timezone('UTC', created_at) 强转更稳妥
  • 别用 now()CURRENT_TIMESTAMP 直接返回——它们不是列,Grafana 无法映射
  • 错误现象:面板显示“No data”或时间轴全平铺成一条线,Query inspector 里能看到字段名是 time_1 或类似自动生成名

MySQL 数据源告警规则里 WHERE 条件失效?

Grafana 告警基于「每分钟执行一次查询」,但 MySQL 的 NOW() 在单次查询中是常量,不会随告警评估周期动态更新,容易导致条件永远不满足或误触发。

实操建议:

  • DATE_SUB(NOW(), INTERVAL 5 MINUTE) 替代硬写时间字符串,让窗口随每次评估滚动
  • 避免在 WHERE 里用函数包裹索引字段,比如 DATE(created_at) = CURDATE() 会跳过索引;改用 created_at >= '2024-06-01' AND created_at
  • 告警查询必须返回标量(单行单列),否则 Grafana 报错 Expected single value, got 3 rows
  • MySQL 8.0+ 支持 UNIX_TIMESTAMP(),配合 Grafana 的 $__unixEpochFilter(time) 宏可自动注入时间范围,但得手动在 SQL 里写成 WHERE $1

SQL 模板变量在 PostgreSQL 和 MySQL 中行为不一致?

$__timeFilter() 这类宏生成的 SQL 片段,在两个数据源里语法不同:PostgreSQL 用 time >= '2024-01-01T00:00:00Z',MySQL 默认输出带毫秒的 '2024-01-01 00:00:00.000',而老版本 MySQL 不支持毫秒精度,直接报错。

实操建议:

  • PostgreSQL:放心用 $__timeFilter(time),只要 timetimestamptz 类型
  • MySQL:改用 $__timeEpochFilter(time)(输出 Unix 时间戳整数),再在 SQL 里转成时间:FROM_UNIXTIME($1)
  • 模板变量如 $env 在查询中要加单引号:WHERE env = '$env',否则会被当标识符解析,报错 column "prod" does not exist
  • MySQL 5.7 不支持 JSON_EXTRACT,想解析 JSON 字段得用 CAST(data->>'$.status' AS CHAR) —— 但 5.7 不认 ->>,只能退化为 SUBSTRING_INDEX(SUBSTRING_INDEX(data, '"status":"', -1), '"', 1)

Dashboard 导出后告警规则丢失或配置错乱?

Grafana 的 dashboard JSON 里,告警规则和查询语句是分开存储的:panels[n].targets 存查询,panels[n].alert 存告警逻辑,但导出时如果没勾选 Export with alert rules,或者目标 Grafana 实例没启用 executeAlerts,规则就只存了个空壳。

实操建议:

  • 导出前确认右上角 ⋯ → Export → Export for sharing externally 并勾选 Include alert rules
  • 导入后进 Alerting → Alert rules 页面检查状态,常见问题:PostgreSQL 数据源没开 Allow server-side queries(报错 Plugin not found: postgres
  • MySQL 连接串里如果含特殊字符(如 @/),URL 编码必须做全,否则导入后数据源 ID 错位,告警查不到数据源
  • 同一个 dashboard 多个 panel 共用同一告警规则时,修改其中一个 panel 的查询,不会自动同步到告警定义里——告警规则是独立实体,得单独编辑

最麻烦的是时间字段类型和时区处理:PostgreSQL 默认按 UTC 存 timestamptz,MySQL 却常存本地时区的 datetime,一不留神,告警窗口就偏移 8 小时。这点没法靠模板兜住,得从建表开始约定。

text=ZqhQzanResources