成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Honeycomb Query Builder 排查查询简报

按 SELECT/WHERE/GROUP BY 等子句、关系字段前缀与 Run Query,整理遥测排查查询简报;不代持团队凭据、不声称已定位根因。

场景说明

面向独立开发者与值班:把「在 Honeycomb 里把一次错误链路问清楚」写成可对账步骤,区别于 Sentry 开 PR 壳与 LangSmith trace 点检。

案例叙事

01他们做了什么

线上出现「结账页偶发折扣码错误」,日志里只有零散字段,需要按 trace 结构把 root 路由与下游 span 一起收窄——这正是 Query Builder 的典型用法。

Honeycomb Docs《Build a Query》(dateModified 可核)说明:可用 Query Builder 对遥测数据构造查询以调查与探索;在子句中输入字段名、运算符与值。查询最多六个子句:SELECT(计算并画随时间变化的图,HEATMAP 看分布)、WHERE(按字段过滤)、GROUP BY(分组)、ORDER BY、LIMIT、HAVING(按聚合条件过滤)。关系字段用于在 WHERE/GROUP BY 中按 span 类型收窄 trace,前缀包括:root.(匹配根 span)、parent.(直接父及其直接子)、child.(匹配一子并返回对应父)、any./any2./any3.(trace 内任一 span,最多三组独立过滤)、none.(排除含该匹配 span 的 trace)。关系字段仅 UI Query Builder 的 WHERE/GROUP BY 可用,且对子句自动 AND。文档示例:统计结账路径上错误——SELECT COUNT,WHERE error exists AND any.name = getDiscounts AND root.name = /cart/checkout,GROUP BY error。运行可用 Run Query 或 Shift+Enter;结果通常含随时间可视化与汇总表;多 SELECT 多图,GROUP BY 多折线且表中每组一行;空 SELECT 返回原始事件。可改数据集、对比时间范围。本场景据此输出排查查询简报。禁止声称「生产根因已锁定」或索要团队 API Key。

02实际效果

  • 源未披露量化「MTTR 下降」;公开文只描述子句、关系前缀与结果形态。
  • 能把「只会按单字段过滤 / 与 Sentry开PR 或 LangSmith 点检混淆」拆开。
  • 为一次错误链路收窄提供可落地的查询提问清单。

03值得知道

  • 具体可视化算子与 Calculated Fields 以配套专页为准。
  • 关系字段在 UI 外的查询 API 能力不在本条一手源范围。
  • 上面写的是产品机制,不是你团队数据集里已有字段字典。

04可复制提示词

Honeycomb Query Builder 简报

你是 Honeycomb Query Builder 助手。只给排查查询核对简报,不要编造已定位根因。

症状:{{symptom}}
时间窗:{{time_range}}
已知路由/span 名:{{known_names}}
数据集认知:{{dataset}}

输出 Markdown:
1. 建议的 SELECT/WHERE/GROUP BY 骨架
2. 是否需要 root./any./child. 等关系前缀
3. 结果图/表如何解读提问
4. 下一步人工 Run Query 验收
禁止索要团队 API Key;禁止声称「根因已确认」。

查询无结果/过宽提纲

查询空白或返回过多噪声,请写收窄提纲。

当前子句摘要:{{clauses}}
预期 trace 形态:{{trace_shape}}

输出:
1. 是否用错关系前缀或 AND 过严
2. 是否时间窗/数据集不对
3. 是否应先空 SELECT 看原始事件
4. 人工下一步
不要伪造「已找到唯一根因」。

05一手来源

怎么做

  1. 粘贴故障时间窗、关心的服务/路由/错误字段、是否已有 trace 样例,以及想对比的维度
  2. Agent 按官方 Build a Query 要点输出:六子句→关系字段前缀→结果图/表→改数据集与时间范围提问清单
  3. 人工在 Honeycomb UI 执行 Run Query;Agent 不登录客户团队、不声称「根因已确认」

实用提示

  • 关系字段仅在 UI Query Builder 的 WHERE/GROUP BY 可用;同前缀条件默认 AND,须全部满足
  • 与 sentry-bug-to-fix-pr / langsmith-agent-trace-error-spotcheck 不同:本条是 Honeycomb 查询子句与 trace 关系前缀,不是自动开 PR,也不是 LangSmith 点检壳
#Honeycomb#Query Builder#可观测性#Traces#独立开发者