TLog 分布式日志追踪新手入门指南项目概览属性信息项目名称TLog组织DromaraStars3.4K ⭐⭐⭐Watching269Forks767语言Java (100%)Gitee 仓库https://gitee.com/dromara/TLog[1]官网https://tlog.yomahub.com/[2]开源协议MITGVP认证是项目简介TLog是一个轻量级的分布式日志标记追踪神器10分钟即可接入自动对日志打标签完成微服务的链路追踪。核心价值•零侵入设计对业务代码无侵入式设计使用简单•快速接入10分钟即可接入无需复杂配置•轻量级性能损耗仅0.01%几乎无性能影响•全链路追踪自动为日志打标签实现微服务链路追踪核心功能特性1. 日志框架支持•✅ Log4j•✅ Log4j2•✅ Logback2. RPC框架支持•✅ Dubbo•✅ Dubbox•✅ Spring Cloud3. 网关支持•✅ Spring Cloud Gateway•✅ Soul网关4. 特性•✅ JavaAgent无侵入接入•✅ 字节码一行代码接入•✅ 配置文件接入•✅ HttpClient标签传递•✅ OkHttp标签传递•✅ 异步线程追踪•✅ 线程池追踪•✅ 多级异步线程追踪•✅ 三种任务框架支持JDK TimerTask、Quartz、XXL-JOB•✅ 自定义日志标签模板适用场景 典型应用场景场景说明微服务链路追踪跨服务日志关联分析分布式系统调试快速定位问题来源性能分析分析请求处理时间日志聚合统一查看完整调用链 目标用户•微服务架构开发者•分布式系统运维人员•需要日志追踪的开发团队•中大型互联网公司技术架构核心模块tlog-all # 全部模块聚合tlog-core # 核心模块tlog-common # 公共模块tlog-agent # JavaAgent模块tlog-spring-boot # Spring Boot集成tlog-dubbo # Dubbo集成tlog-feign # Feign集成tlog-forest # Forest集成tlog-okhttp # OkHttp集成tlog-httpclient # HttpClient集成tlog-rest-template # RestTemplate集成tlog-xxl-job # XXL-JOB集成tlog-gateway # 网关集成接入方式TLog提供三种接入方式1.JavaAgent方式完全无侵入只需添加启动参数2.字节码方式一行代码接入基于字节码增强3.配置文件方式基于配置文件的简单接入快速开始1. Maven 引入!-- 方式一Spring Boot Starter (推荐) --dependency groupIdcom.yomahub/groupId artifactIdtlog-spring-boot-starter/artifactId version1.5.0/version/dependency !-- 方式二如果使用其他框架 --dependency groupIdcom.yomahub/groupId artifactIdtlog-all/artifactId version1.5.0/version/dependency2. 配置文件# application.ymltlog: enabled: true appname: your-app-name # 是否追踪MDC上下文 trace-mid: TID # 日志模板 log-pattern: [{TID}] {methodName} {className}3. Logback配置!-- logback.xml --appender nameCONSOLE classch.qos.logback.core.ConsoleAppender encoder pattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %highlight(%-5level) %cyan(%logger{36}) - %msg%n/pattern /encoder/appender4. JavaAgent方式接入java -javaagent:tlog-agent.jar -jar your-app.jar5. 验证效果启动应用后日志将自动添加链路追踪标识2026-05-07 10:30:15.123 [http-nio-8080-exec-1] INFO c.example.Service - [TID:xxx123] Method:doSomething Class:com.example.Service - 开始处理请求2026-05-07 10:30:15.125 [http-nio-8080-exec-1] INFO c.example.Service - [TID:xxx123] Method:doSomething Class:com.example.Service - 请求处理完成性能表现根据官方压测数据指标数值性能损耗约0.01%内存占用极小吞吐量影响可忽略TLog经过严格的性能测试确保在高并发场景下对系统性能的影响可以忽略不计。常见问题Q1: TLog支持哪些RPC框架A: 目前支持Dubbo、Dubbox、Spring Cloud生态包括Feign、RestTemplate等。Q2: 如何在异步线程中保持追踪A: TLog自动支持线程池和多级异步场景会自动传递链路上下文。Q3: 如何自定义日志标签格式A: 通过配置文件设置log-pattern参数支持多个系统级埋点标签。Q4: 是否支持热更新规则A: 支持配置文件方式的动态更新无需重启应用。Q5: 如何排除不需要追踪的接口A: 在配置文件中添加排除路径规则即可。学习资源官方资源•官网文档https://tlog.yomahub.com/[3]•项目文档https://tlog.yomahub.com/pages/5b7bd2/[4]•示例工程https://gitee.com/bryan31/tlog-example[5]社区支持•项目作者铂赛东 (bryan31)•官方公众号关注作者公众号获取入群邀请项目推荐指数维度评分说明易用性⭐⭐⭐⭐⭐10分钟即可接入轻量级⭐⭐⭐⭐⭐性能损耗仅0.01%实用性⭐⭐⭐⭐⭐微服务开发必备学习价值⭐⭐⭐⭐理解链路追踪原理综合推荐指数⭐⭐⭐⭐⭐强烈推荐对比同类产品特性TLogSkyWalkingZipkin侵入性低中中性能损耗0.01%3-5%5-10%配置复杂度简单复杂中等学习成本低高中TLog的优势在于轻量级和零侵入适合快速集成和小型项目。报告生成时间2026年5月数据来源Gitee 官方数据项目官网https://tlog.yomahub.com/[6]References[1]:https://gitee.com/dromara/TLog[2]:https://tlog.yomahub.com/[3]:https://tlog.yomahub.com/[4]:https://tlog.yomahub.com/pages/5b7bd2/[5]:https://gitee.com/bryan31/tlog-example[6]:https://tlog.yomahub.com/
