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

PostgreSQL 数据源里 time 字段不被 Grafana 识别为时间序列?
Grafana 要把查询结果当时间序列画图,必须明确告诉它哪个字段是时间戳。PostgreSQL 默认不认 timestamp 或 timestamptz 列为时间字段,除非你显式标注。
实操建议:
- 在 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),只要time是timestamptz类型 - 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 小时。这点没法靠模板兜住,得从建表开始约定。









