SuperAPI AI 工具集

suppressing-noisy-errors

通用与其它

查看项目

更新于 10-16 03:45

技能介绍

用途:在 PostHog 错误跟踪中创建抑制规则,让匹配的事件在摄取阶段被丢弃,不再生成 issue。适合处理无法从代码修复的噪声,如浏览器扩展、第三方脚本、广告拦截器、浏览器引擎怪癖(ResizeObserver loop、Script error.)、机器人或爬虫流量。若错误真实但量大,应改用 sampling_rate 采样而非完全抑制;若只是不想收到通知,应改状态或通知规则;若是重复错误,应合并或建分组规则。

主要能力:通过 MCP 工具查询候选 issue、检查 $exception 样本、查看已有规则、创建抑制规则、用 issue 状态隐藏历史数据。规则使用与分组规则相同的过滤器结构,支持 $exception_types、$exception_values、$exception_sources、$exception_functions 等数组属性,以及 exact、icontains、regex 等操作符。regex 区分大小写,需用 (?i) 内联标志。

使用方式:先用 query-error-tracking-issues-list 按出现次数排序找高噪声候选,再用 query-error-tracking-issue-events 确认模式(建议 onlyAppFrames: false 以显示第三方帧)。过滤器尽量窄,AND 组合多个条件。创建前用 filterGroup 对最近 7 天数据做干跑预览,注意 status 用 all、filterTestAccounts 用 false。确认后调用 error-tracking-suppression-rules-create,建议 sampling_rate 从 0.95 起步,确认无误后再收紧到 1.0。创建后观察 24-48 小时。

限制:抑制在摄取阶段生效,只影响新事件,历史数据保留。不要创建匹配全部或过宽的规则,过窄规则无害,过宽会静默销毁真实数据。编辑或删除规则的工具未启用,误报时需用户在 Project settings → Error tracking → Suppression rules 手动禁用。若需 OR 组或不支持的运算符,需回退到 execute-sql 写 HogQL。