结构化日志到底该怎么设计字段

根因分析

实现根因分析需构建全链路追踪能力。在网关层生成全局唯一的 `trace_id` 并透传至下游微服务，作为日志必填字段。同时记录 `span_id` 与 `parent_span_id` 构建调用拓扑。发生异常时，除捕获 `error_msg` 外，必须将完整堆栈序列化至 `stack_trace` 字段，并计算异常指纹 `error_hash`（如对堆栈首行取 MD5）以聚合同类故障，从而跨服务快速定位代码级根因。

改进建议

建议建立全局字段字典强制统一命名，如全链路追踪固定使用 trace_id 与 span_id。为防顶层字段爆炸，需区分核心字段与扩展字段，将非通用信息收敛至 context 对象中。同时，务必在日志输出层接入基于白名单的脱敏组件，确保密码、手机号等隐私字段在落盘前完成打码，兼顾排查效率与安全合规。