结构化日志与分布式追踪结合提升系统可观测性：结构化日志以JSON格式输出，便于解析和分析；分布式追踪通过trace ID记录请求全链路，两者关联后可实现日志与调用链联动，显著缩短故障定位时间。
在现代 JavaScript 应用中，尤其是运行在 Node.js 环境或复杂前端架构中的系统，日志不再只是简单的 console.log。结构化日志与分布式追踪已成为可观测性的核心组成部分，帮助开发者快速定位问题、分析性能瓶颈并理解请求在系统间的流转路径。
结构化日志：让日志可读又可解析
传统日志通常以纯文本形式输出，例如：
User login failed for user123这类信息对人可读，但难以被程序高效解析。结构化日志使用统一格式（通常是 JSON），将日志内容组织为键值对，便于机器处理和集中分析。
在 Node.js 中，常用库如 winston 或 pino 支持结构化输出。例如使用 pino：
立即学习“Java免费学习笔记（深入）”；
const logger = require('pino')()logger.info({ userId: 'user123', action: 'login', success: false }, 'Login attempt failed')
输出结果为：
{"level":30,"time":1717743234567,"pid":1234,"hostname":"local","userId":"user123","action":"login","success":false,"msg":"Login attempt failed"}这样的日志可以直接被 ELK（Elasticsearch, Logstash, Kibana）或 Grafana Loki 等系统采集，支持按字段查询、过滤和可视化。
关键优势包括：
- 字段标准化，便于跨服务聚合分析
- 支持上下文注入，如请求ID、用户ID等
- 减少日志解析错误，提升告警准确率
分布式追踪：看清请求的完整生命周期
在微服务架构中，一个用户请求可能经过多个服务节点。要排查延迟或失败原因，必须知道请求“去过哪里”。这就是分布式追踪的作用。
它通过一个全局唯一的 trace ID 标识一次请求，并为每个操作生成 span，记录开始时间、持续时间和元数据。多个 span 组成 trace，形成调用链路图。
JavaScript 生态中，OpenTelemetry 是主流标准。它可以自动或手动收集追踪数据。例如，在 Express 应用中启用自动追踪：
const { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node')const { SimpleSpanProcessor } = require('@opentelemetry/sdk-trace-base')
const { OTLPSpanExporter } = require('@opentelemetry/exporter-trace-otlp-http')
const provider = new NodeTracerProvider()
provider.addSpanProcessor(new SimpleSpanProcessor(new OTLPSpanExporter()))
provider.register()
配合插件，它能自动捕获 HTTP 请求、数据库调用等 span，并将 trace ID 注入日志，实现日志与追踪的关联。
实际效果是：你在日志中看到一条记录包含 traceId: "abc-123"，然后可在 Jaeger 或 Zipkin 界面中搜索该 ID，查看完整的调用拓扑和耗时分布。
打通日志与追踪：提升排错效率
单独的日志或追踪都有局限。理想情况是两者联动。方法很简单：将 trace ID 写入每条相关日志。
借助 OpenTelemetry 的上下文传播机制，当前 trace ID 可在线程或异步调用中传递。结合日志库的上下文支持，就能自动附加 trace ID。
例如，在 pino 中使用上下文：
const { context, propagation } = require('@opentelemetry/api')function getLoggerWithTrace() {
const span = context.active().getValue('span')
const traceId = propagation.extract(context.active()).traceparent?.split('-')[1] || null
return logger.child({ traceId })
}
const log = getLoggerWithTrace()
log.info('Processing order') // 自动带 traceId
这样，在观测平台中点击某条日志，可直接跳转到对应的 trace，反之亦然，极大缩短故障定位时间。
基本上就这些。结构化日志解决“说什么”，分布式追踪回答“去了哪”，两者结合，让复杂系统的行为变得透明。
