告别线上排查难题!methodTraceLog —— 让 Spring Boot 方法级可观测性触手可及

告别线上排查难题!methodTraceLog —— 让 Spring Boot 方法级可观测性触手可及 一句话介绍一个 Spring Boot Starter搞定方法追踪、性能监控、日志管理、在线反编译还能让 AI Agent 直接帮你查 Bug。 你是否也遇到过这些场景线上接口报错了日志一大堆却找不到完整调用链想定位某个方法的耗时却发现没有埋点数据排查问题想反编译某个类看看逻辑却发现环境没有工具想给 AI 编程助手提供运行时上下文却无从下手接入 OpenTelemetry 成本太高小项目根本折腾不起如果你中了一条以上methodTraceLog就是为你准备的。 methodTraceLog 是什么methodTraceLog是一个面向 Spring Boot 应用的全功能方法级可观测性组件只需引入一个 Starter 依赖即可获得能力说明 方法调用追踪基于 AOP 自动拦截生成 traceid / spanid构建完整调用链 性能监控基于 Micrometer每个方法自动注册 Timer支持 Actuator 端点 日志文件管理在线查看、搜索、下载日志文件支持 WebSocket 实时 Tail 在线反编译内置 CFR 反编译器支持 Spring Boot Fat-Jar输出对 LLM 友好 AI Agent 集成独立 MCP Server让 Claude / GPT 等 AI 直接查询你的应用 OpenTelemetry可选 OTLP 导出与主流可观测平台无缝对接⚡ 5 分钟快速接入第一步添加依赖dependencygroupIdio.github.wb04307201/groupIdartifactIdmethodTraceLog-spring-boot-starter/artifactIdversion1.0.20/version/dependency第二步配置可选method-trace-log:log:enable:truesample-rate:1.0# 采样率0.0 ~ 1.0trace-store:type:in-memory# 支持 in-memory / file / nonefile:enable:truepath:./logs# 日志文件目录security:api-key:your-secret-key# API 鉴权密钥decompile:timeout-seconds:10第三步开箱即用启动应用后访问http://localhost:8080/methodTraceLog/panel你将看到一个功能完备的 Web 控制台 ️ Web 控制台一览控制台包含四大功能模块 概览Overview服务状态一目了然各功能模块开关状态、方法调用统计、成功率、平均耗时等核心指标卡片。 调用记录Traces按类名、方法名、traceId 搜索过滤导出为 JSON / CSV点击任意记录查看完整调用链树父子关系清晰呈现支持 W3C TraceParent 标准与上下游系统无缝串联 日志文件Logs在线浏览日志目录按关键字搜索支持分页查看大文件WebSocket 实时 Tail像tail -f一样实时查看日志输出 反编译Decompile输入类名即可查看源码无需本地安装反编译工具支持 Spring Boot Fat-Jar 内嵌套的 class 文件自动去除注解输出干净的代码适合喂给 AI 分析 AI-First让 AI Agent 直接帮你排查问题这是 methodTraceLog 最独特的能力——通过独立的MCP ServerAI 编程助手可以查询最近的方法调用记录根据 traceId 获取完整调用链在线反编译指定类/方法查看和搜索日志文件内容远程控制日志监控的启停接入方式以 Claude Code 为例{mcpServers:{methodTraceLog-mcp:{command:jbang,args:[io.github.wb04307201:methodTraceLog-mcp:1.0.20,--method-trace-log.mcp.hosts[0].namelocal-dev,--method-trace-log.mcp.hosts[0].urlhttp://localhost:8080,--method-trace-log.mcp.hosts[0].api-keyyour-key]}}}配置完成后AI 助手就拥有了 13 个工具可以直接查询你的应用运行时数据。零侵入设计MCP Server 是独立进程核心库不依赖任何 AI 框架生产环境安心使用。️ 架构设计亮点模块化设计methodTraceLog-parent ├── methodTraceLog # 核心库无 AI 依赖 ├── methodTraceLog-spring-boot-autoconfigure # 自动配置 ├── methodTraceLog-spring-boot-starter # Starter 入口 ├── methodTraceLog-mcp # MCP Server独立进程 └── methodTraceLog-test # 测试用例安全第一 路径穿越防护日志目录白名单校验 双重认证API KeyCLI/MCP Cookie Session浏览器⏱️ 超时保护反编译器默认 10s 超时 大小限制单类 50MB 上限标准化遵循W3C Trace Context规范传播 traceparent兼容OpenTelemetry OTLP/HTTP导出支持 Micrometer Actuator 生态可扩展自定义ICallService实现自动发现多种 Trace 存储策略内存 / 文件 / 无存储采样率灵活配置适配不同流量场景 技术栈技术说明Java 17最低要求Spring Boot 3.5.x框架基座Spring AOP (AspectJ)方法拦截Micrometer指标采集CFR 0.152反编译引擎STOMP SockJSWebSocket 实时推送OpenTelemetry SDK 1.41可选 Tracing 导出Spring AI MCP Server 1.1.7AI Agent 协议支持 适合谁用独立开发者一个人维护多个服务需要轻量级的观测方案小中型团队不想搭建完整的可观测平台但需要调用链和性能数据AI 辅助开发希望 AI 编程助手能感知运行时状态提升排查效率学习研究想深入理解 AOP、分布式追踪、MCP 协议的实现细节 立即开始!-- Maven --dependencygroupIdio.github.wb04307201/groupIdartifactIdmethodTraceLog-spring-boot-starter/artifactIdversion1.0.20/version/dependency// Gradleimplementationio.github.wb04307201:methodTraceLog-spring-boot-starter:1.0.20开源协议Apache License 2.0项目地址GitHubhttps://github.com/wb04307201/methodTraceLogGiteehttps://gitee.com/wb04307201/methodTraceLog 写在最后在微服务和分布式系统日益复杂的今天可观测性不再是可选项而是必备能力。methodTraceLog 的诞生是为了让每一个 Spring Boot 应用都能以最低的成本获得最专业的方法级观测能力。不需要搭建 Prometheus Grafana不需要接入 SkyWalking不需要改造代码——一个依赖全部搞定。更重要的是它是AI-First设计的。在 AI 编程助手日益普及的今天methodTraceLog 让你的应用运行时对 AI 可见让AI 帮你查 Bug从概念变成现实。试试看你会爱上这种透明感。✨