用途:为 PostHog 项目中的服务编写实用、低噪声的日志告警。适用于用户要求设置或建议告警、评估某服务是否产生可告警信号、或刚启用日志告警需要起始告警集的场景。不适用于调优已有告警或事故进行中的调查。
主要能力与流程:先用 posthog:logs-services 取最近 24 小时前 25 个服务做分诊,候选需日志量非平凡且错误率非零(或用户点名);可用 posthog:logs-attributes-list 等收窄过滤;再用 posthog:logs-count-ranges(-7d、targetBuckets: 24)建立基线,并用脚本 python3 scripts/baseline_stats.py --window-minutes 5 计算阈值建议,据 health 标记(sparse、empty、spiky、flat)决定继续或跳过;用 posthog:logs-alerts-simulate-create 回放草稿,目标为 -7d 内触发 0–3 次,每个候选最多模拟 3 次;最后用 posthog:logs-alerts-create 创建,并用 posthog:logs-alerts-destinations-create 接入通知目标。
默认参数:threshold_operator 为 above(音量下限告警用 below);window_minutes 为 5、10、15、30、60 之一;evaluation_periods 为 3、datapoints_to_alarm 为 2(2-of-3)、cooldown_minutes 为 30。filters 至少包含 severityLevels、serviceNames 或 filterGroup 之一,模拟与创建须一致。
限制:编写阶段不要调用 posthog:query-logs;每个候选最多 3 次模拟;接入通知前须与用户确认频道或 webhook URL,不擅自接入生产频道;无法落入 0–3 次触发区间时应记录原因并放弃。具体定价、支持平台与效果资料暂未提供。