---

title: OpenTelemetry日志语义约定：结构化字段与错误关联

keywords:

• OpenTelemetry
• Logs
• 语义约定
• 错误关联
• 结构化日志

description: 统一日志的结构化字段与语义约定，关联 Trace/Span，提升跨服务诊断与可视化能力。

tags:

• Logs
• OTel
• OpenTelemetry
• 可观测性
• 结构化日志
• 语义约定
• 运维
• 错误关联

categories:

• 文章资讯
• 技术教程

---

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 配置属性增强与过滤；记录丢弃与队列积压。
• 建立看板与查询模板；对高价值错误设定分组与告警规则。