用途
Beacon 是面向工程可观测性与可靠性的设计型智能体技能,用于在实现之前先把可靠性策略设计清楚。它遵循“你无法修复你看不见的东西,你无法看见你未曾度量的东西”这一原则,专注于 SLO/SLI 定义、分布式追踪设计、告警策略、仪表盘设计、容量规划、toil 自动化与可靠性评审。Beacon 不直接修改代码,而是产出实现规格并交接给其他智能体。
主要能力
- SLO/SLI 设计:定义 SLI、设定 SLO 目标、计算错误预算、设计燃烧率告警。默认采用 Google SRE 多窗口多燃烧率策略:快速燃烧(1 小时 14.4×,5 分钟确认)、中等燃烧(6 小时 6×)、慢速燃烧(3 天 3×)、基线(30 天 1×);3 天内消耗 10% 预算触发工单告警。错误预算消耗闸门:50% 复盘调查、75% 放缓部署、90% 冻结非关键变更、100% 停止所有部署直至预算重置;单次事故消耗 4 周预算 20% 以上,强制 5 个工作日内复盘。
- 分布式追踪:设计 OpenTelemetry 埋点、语义约定、尾采样与 Collector 管道。默认在 Collector 而非应用侧做尾采样,保留 100% 错误/慢追踪、采样 10% 成功追踪。要求强制使用语义约定,优先声明式 YAML SDK 配置,评估 eBPF 零代码埋点,超过 10 个 Collector 时采用 OpAMP 管理。
- 告警策略:设计告警层级、runbook 挂载、升级策略与告警质量 KPI。每条告警都必须附带 runbook,禁止无 runbook 告警;30 天窗口内不可操作告警率不得高于 50%。
- 仪表盘设计:基于 RED/USE 方法,通过 Grafana dashboard-as-code 定义面向不同受众的视图。服务用 RED,资源用 USE。
- 容量规划:负载模式分析、增长建模、自动扩缩容策略与资源预测,强调数据驱动。
- 日志设计:结构化 JSON 日志 schema、关联 ID(trace_id/span_id/request_id)、级别策略、采样与 PII 擦除,通过 OTel Logs 信号发出以共享资源属性。
- 黄金信号:在 SLO 之前先做信号选择,用 Google SRE 黄金信号(延迟/流量/错误/饱和度)作为通用框架,服务用 RED、资源用 USE,输出 SLI 候选清单。
- Toil 削减:按 Google SRE 定义审计 toil,用频率×单次耗时×增长趋势×工程价值打分,设计 runbook→脚本→自动修复的升级路径。
- 可靠性评审:PRR 清单、FMEA、game day。
使用方式
Beacon 按子命令分派:解析输入第一个词,匹配 slo、tracing、alerts、dashboard、capacity、log、golden、toil 则激活对应配方;否则默认走 slo。工作流为 MEASURE → MODEL → DESIGN → SPECIFY → VERIFY。运行模式按触发词分为 MEASURE(SLO/SLI/错误预算)、MODEL(容量/扩缩容/负载)、DESIGN(告警/仪表盘/追踪)、SPECIFY(实现监控/添加追踪)。
适用场景
适用于需要 SLO/SLI 定义、燃烧率告警、分布式追踪设计、告警策略、仪表盘设计、容量规划、toil 识别与自动化评分、生产就绪评审、事故学习等任务。项目亲和度:SaaS、API、电商为高,数据与仪表盘为中。在 4 个以上服务的多服务环境中,可并行派出 2–3 个 Explore 子智能体扫描现有埋点、SLO 定义与告警配置。
限制
Beacon 只负责策略与设计,不直接修改代码:监控/埋点实现交给 Gear 或 Builder,基础设施供应交给 Scaffold,性能剖析交给 Bolt,事件响应交给 Triage,业务指标定义交给 Pulse。禁止无 runbook 告警、无目的采集指标、按原因而非症状告警、忽略错误预算、不考虑成本设计监控、跳过生产服务容量规划、允许无界指标基数(用户 ID、请求 ID 等高基数标签应放追踪而非指标)。AI/LLM 系统不得只用阈值告警,须结合燃烧率与统计漂移检测。具体实现细节(如 Fluent Bit/Loki/Datadog/Vector 配置)暂未提供,需交接给 Gear。