用途:为 PostHog 错误跟踪创建抑制规则,在事件摄取阶段丢弃高频、低价值的噪音错误,使其不生成 issue。仅当错误确实不可处理时才应使用,例如浏览器扩展、第三方脚本、广告拦截器、跨域 Script error.、ResizeObserver loop、无头浏览器或爬虫流量;高频但真实的错误应改用 sampling_rate 降采样而非完全抑制。仅想静音通知或错误为重复项时应改用状态、通知规则或分组规则。
主要能力:借助 MCP 工具完成候选识别、模式确认、过滤器收紧、采样决策、干跑验证、创建规则与创建后观察。相关工具包括 query-error-tracking-issues-list(按量筛选、通过 filterGroup 干跑)、query-error-tracking-issue-events(查看 $exception 样本)、execute-sql(filterGroup 不支持 OR 或特定操作符时的回退)、error-tracking-suppression-rules-list/create、error-tracking-issues-partial-update。过滤器应针对 $exception_sources、$exception_values、$exception_types、$raw_user_agent 等具体属性,并尽量用 AND 组合;正则区分大小写,需用 (?i)。
使用方式:先按出现量高、用户数低筛出候选,查看样本确认模式;再按推荐过滤器收紧范围;用 filterGroup 对过去 7 天干跑,逐条检查是否命中真实错误;向用户展示过滤器与影响后等待确认再创建。建议从 sampling_rate 0.95 起步保留 5% 哨兵数据,确认无漏杀后再收紧至 1.0。创建后观察 24—48 小时,用规则创建后的短窗口重新计数,避免复用 7 天估算。若出现真实问题骤降,立即请求用户在设置中停用规则并收紧过滤器;当前未启用编辑或删除规则的工具,无法程序化恢复。
限制:抑制在摄取时生效,历史数据不受影响;空过滤器或全匹配规则被明确禁止;规则过窄只会漏掉部分噪音,过宽则会静默丢弃真实数据。