OpenTelemetry日志语义约定:结构化字段与错误关联
概览
- OTel 日志语义约定定义常见字段与错误结构;与 Trace/Span 关联形成统一上下文。
- 结构化日志提高检索与聚合效率,便于跨服务分析。
技术参数(已验证)
- 核心字段:`service.name`、`severity_text`/`severity_number`、`event.name`、`exception.type/message/stacktrace`、`http.`、`db.`。
- 关联:在日志中携带 `trace_id`/`span_id` 与 `resource.attributes`;支持从日志跳转 Trace。
- 采集:通过 OTel SDK/Collector 采集 `logs` 管道;处理器进行属性增强与过滤。
- 级别与抽样:在高吞吐场景进行抽样与级别控制;避免高基数标签与成本膨胀。
- 安全与隐私:脱敏敏感字段;遵循最小可见与合规要求。
实战清单
- 在所有服务统一日志字段与格式;在错误事件中附带异常信息与关联 ID。
- 在 Collector 配置属性增强与过滤;记录丢弃与队列积压。
- 建立看板与查询模板;对高价值错误设定分组与告警规则。
发表评论 取消回复