通过Tempo在Grafana中查询链路追踪并绘制属性时序图求助

操作步骤 #

1. 编写TraceQL查询语句 #

直接筛选目标事件并提取商户维度，语句如下：

{ span.attributes["merchant.configuration.cache.refreshed"] = "true" } | span.attribute("merchant.id") as merchant_id | group_by(merchant_id, timestamp())

• 筛选逻辑：定位所有包含merchant.configuration.cache.refreshed=true属性的Span
• 维度提取：把merchant.id作为分组标识
• 聚合规则：按商户ID和时间戳做分组，为时序图提供数据基础

2. Grafana面板配置 #

• 新建Time series面板，数据源选择你的Tempo实例
• 将上述TraceQL语句粘贴到查询框
• 可视化设置：
  • 在Legend选项中，选择merchant_id作为图例字段，每个商户会单独成一条曲线
  • 根据数据量调整时间粒度（如1分钟/5分钟），让曲线走势更直观
  • 可开启Points显示，方便查看单个事件的时间点

3. 常见问题处理 #

• 查询无结果：核对Span属性的键名（注意大小写、特殊字符是否完全匹配）
• 分组异常：确认目标Span中merchant.id属性存在且有有效值
• 时序混乱：检查Tempo是否正确解析了Span的startTimeUnixNano时间戳

内容的提问来源于stack exchange，提问作者Alan Mulligan