用途:当用户询问某个错误“怎么回事”或粘贴错误追踪 issue 链接时,该技能自动收集原本需手动拼凑的上下文:谁遇到、什么变更引入、在哪里发生、回放是否显示原因。
主要能力:通过 posthog:query-error-tracking-issue 获取问题基线(状态、负责人、顶部帧、版本、聚合与 sparkline);query-error-tracking-issue-events 取样本 $exception 事件(堆栈、URL、浏览器、$session_id);execute-sql 做版本/浏览器/URL/功能开关等分组与发布关联;query-logs 查错误时间附近的 OTEL 日志;query-session-recordings-list 找关联回放;read-data-schema 确认属性键。
使用方式:先取问题记录与 sparkline 判断形态(突增、平稳、爬升、间歇),再取最近与最早样本对比;按形态选择分组维度,注意版本属性区分 $app_version(用户应用版本)、$exception_releases 与 $lib_version(PostHog SDK 版本);用 issue_id 或 properties.$exception_issue_id 关联事件;功能开关需用 JSONExtract(ifNull(toString(...),'[]'),'Array(String)') 解析;用 $session_id 拉取前后事件、控制台日志与回放;最后按“是什么、影响谁、何时开始、可能原因、下一步”输出。
适用场景:单个 PostHog 错误问题的根因排查、发布回归定位、功能开关关联分析、回放与日志关联。
限制:日志与事件分开采集且保留期较短;trace 关联仅对显式埋点请求有效;未启用回放或未接入日志时结果可能为空;$app_version 在 Web/服务端需手动设置;分组错误需转交 grouping-noisy-errors;具体收费与平台支持暂未提供。