用途:把可观测性当作一门工程学科来落地,核心是“为还没提出的问题埋点”——监控只验证已知故障模式,可观测性让系统回答事先未预料的问题。遥测要回答两件事:什么坏了(症状)与为什么坏(原因),且应把更多投入放在捕获症状上。
主要能力:以“宽事件”(规范日志行)为默认埋点方式,即每个请求、每个服务发送一条结构化、高信息密度的事件,在请求结束时于 finally 中发出,确保异常路径也能落数据;覆盖指标、追踪、日志、上下文传播、采样与 Collector。OpenTelemetry 作为厂商中立的底座:信号经 OTLP 导出,service.name 为必填资源属性,遵循语义约定属性名,跨服务用 W3C traceparent 传播上下文,出站请求应注入当前上下文而非自造关联头。生产默认推荐 Collector 做批处理、重试、脱敏与后端切换。还涵盖 SLI/SLO/错误预算定义、RED/USE/四黄金信号、多窗口多燃烧率告警(如 99.9% SLO 对应 14.4/6/1 燃烧率)、告警必须可行动并附运行手册、日志等级与 PII/密钥卫生、遥测成本与基数控制。
使用方式:资源目录按需加载,如 node-patterns.md 用于 Node/TypeScript 接入 OTel,slo-alerting.md 用于定义 SLO 与告警,testing-telemetry.md 用于测试埋点,references.md 查依据。TypeScript 最小接入为 @opentelemetry/sdk-node、@opentelemetry/api、@opentelemetry/auto-instrumentations-node,并通过 node --import ./instrumentation.mjs 在应用代码前加载埋点文件,初始化顺序错误会导致静默采集不到数据。
适用场景与限制:适用于新老服务埋点、定义 SLI/SLO 与错误预算、设计或精简告警、排查生产未知问题、审查遥测开销与基数;CI 失败诊断、本地与生产漂移、Core Web Vitals 优化不属本技能。限制:读时聚合依赖能处理原始事件的后端;从不被视为纯粹的“采样即美德”,绝不能静默采样 SLO 所依据的数据流;指标仅限有界低基数标签,高基数维度应放到事件/跨度;扇出类个人数据的采集须符合隐私政策。具体产品与价格暂未提供。