在java日志记录中，将日志与监控结合的核心做法是提取结构化字段（如traceid、userid）并注入到日志框架的上下文中，同时通过mdc（mapped diagnostic context）实现链路追踪。这样做可以让日志系统自动携带业务上下文，便于后续接入prometheus或elk等监控平台进行聚合分析。
MDC如何传递TraceId
MDC通过线程局部变量存储键值对，拦截器在请求开始时生成唯一ID并放入MDC，日志输出时PatternLayout会自动读取该值。这种方式无需修改业务代码中的打印语句，即可实现全链路追踪。
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.slf4j.MDC;
public class TraceInterceptor {
private static final Logger log = LoggerFactory.getLogger(TraceInterceptor.class);
public void handleRequest(String traceId) {
MDC.put("traceId", traceId);
try {
// 执行业务逻辑
log.info("Processing request");
} finally {
MDC.clear();
}
}
}
预期结果：控制台或文件日志中会包含类似 [traceId=abc-123] 的前缀信息，方便检索。
立即学习“Java免费学习笔记（深入）”；
日志如何对接监控系统
日志对接监控通常采用Filebeat或Fluentd作为采集代理，将本地日志文件实时转发至Elasticsearch或Loki。配置时需指定日志格式匹配规则，确保结构化数据能被正确解析为指标。
# filebeat.yml 示例片段
filebeat.inputs:
- type: log
paths:
- /var/log/app/*.log
json.keys_under_root: true
json.overwrite_keys: true
output.elasticsearch:
hosts: ["localhost:9200"]
index: "app-logs-%{+yyyy.MM.dd}"
预期结果：日志数据进入ES后，可通过Kibana创建Dashboard，展示错误率、响应时间分布等监控视图。
当MDC中无TraceId时日志会怎样
如果请求未经过初始化拦截器，MDC中的TraceId将为空。此时日志输出不会报错，但会缺少追踪标识，导致无法关联同一请求的多条日志。建议在非Web环境（如定时任务）中手动设置默认TraceId。
