核心用法
本技能为纯文档型技术指南，无实际可执行代码，专注于云原生系统的可观测性架构设计。核心围绕「三大支柱」展开：
1. 结构化日志 (Logs)
- 强制JSON格式输出，拒绝字符串拼接
- 标准字段：timestamp、level、service、message、trace_id、span_id
- 通过异步上下文存储实现自动字段继承
- 推荐库：Pino(Node)、zerolog/zap(Go)、structlog(Python)
2. 分布式追踪 (Traces)
- 统一使用OpenTelemetry标准，避免厂商锁定
- W3C Trace Context协议跨服务传播
- 采样策略：生产环境概率采样+错误全采
- 异步任务需序列化traceparent到消息队列
3. 指标监控 (Metrics)
- RED方法（面向请求）：Rate流量、Errors错误率、Duration延迟
- USE方法（面向资源）：Utilization利用率、Saturation饱和度、Errors错误数
- 警惕高基数标签：禁用user_id/request_id作为Prometheus label
配套工具链：OpenTelemetry Collector → Prometheus + Grafana + Loki + Jaeger
显著优点
- 生产级成熟度：涵盖采样策略、告警疲劳治理、PII擦除等企业级场景
- 标准中立：拒绝Datadog/Honeycomb等专有方案，降低厂商锁定风险
- 安全内建：文档本身即为安全指南，8条「NEVER」红线明确禁止日志记录密码/Token/PII
- 可落地性强：提供TypeScript/Go/Python多语言示例，含完整告警分级(P1-P4)和Dashboard设计模式
局限性与适用边界
- 非交互式工具：无自动化代码生成或配置扫描功能，需人工阅读实施
- 云原生聚焦：传统单体应用、嵌入式系统、无服务器边缘场景覆盖有限
- 技术栈偏好：Prometheus/Grafana生态为主，InfluxDB/TimescaleDB等替代方案提及较少
- 维护依赖：来源为个人开发者(T3)，无企业SLA保障
适合人群
- SRE/平台工程师：设计统一可观测性基线
- 后端开发：实施服务级别的日志/追踪/指标埋点
- 技术负责人：制定团队observability规范与Checklist
- 不适合：寻求一键部署脚本、或需要托管SaaS方案的团队
常规风险与缓解
| 风险点 | 缓解措施 |
|--------|----------|
| 示例代码中的`otel-collector:4318`需替换为实际地址 | 文档明确标注为「示例URL」 |
| T3来源信任度有限 | 内容经CLS-S+认证，无恶意模式，建议二次审查 |
| 高基数指标导致Prometheus OOM | 文档专设Anti-Patterns章节警示 |
| PII合规风险 | 独立章节+8条NEVER规则+Checklist强制验证 |
认证结论
经CLS-Certify v2.1.0扫描：0安全发现，静态/动态/依赖/网络/隐私全维度通过，S+顶级安全等级。纯Markdown文档技能，无可执行代码，可直接用于生产架构参考。