开放代码社区 › TLog 分布式日志标记追踪工具

TLog 分布式日志标记追踪工具

开发工具Java

TLog 是轻量级分布式日志标记追踪工具，可快速接入并自动为日志打标签，实现微服务链路追踪。支持 log4j、log4j2、logback 日志框架，以及 Dubbo、Feign、Spring Cloud 等 RPC 与 HTTP 调用，并支持线程池、定时任务、消息队列的上下文透传，适用于微服务日志排查与链路追踪场景。

AI/机器学习Web后端前端工具Java

作者：用户6868语言：Java更新：2026-10-27

仓库地址

https://gitee.com/dromara/TLog.git

前往原仓库

README

<p align="center">
<a href="https://tlog.yomahub.com/">
    <img width="500" src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/b6f59550ebf757953be9484c.png" alt="logo">
</a>
</p>

<h3>您的star是我继续前进的动力，如果喜欢请右上角帮忙点个star</h3>

## 概述
TLog是一个轻量级的分布式日志标记追踪神器，10分钟即可接入，自动对日志打标签完成微服务的链路追踪。支持log4j，log4j2，logback三大日志框架，支持dubbo，dubbox，springcloud三大RPC框架

## 项目官网请点击：[项目官网](https://tlog.yomahub.com/)

## 项目文档请点击：[项目文档](https://tlog.yomahub.com/pages/5b7bd2/)

## 示例工程请点击：[示例工程](https://gitee.com/bryan31/tlog-example)

## TLog 2.0

同一套 starter 支持 Spring Boot 2、3、4，运行产物为 Java 8 字节码；构建源码需要 JDK 17 或更新版本。具体运行组合与验收方法见 [兼容性测试](https://gitee.com/dromara/TLog/blob/master/compatibility-tests/README.md)。

2.0 使用日志配置文件接入，已移除 javaagent 和 `AspectLogEnhance.enhance()`。1.x 用户请先阅读 [升级指南](https://gitee.com/dromara/TLog/blob/master/docs/TLOG_2.0_UPGRADE.md)。

## 特性

* 日志标签与 MDC：支持 logback、log4j、log4j2，自定义标签模板和 traceId 生成器。
* Spring Boot 自动适配 javax/jakarta Servlet，覆盖同步、Callable 和 ASYNC/ERROR 重派发。
* Spring 管理的线程池自动传播 TLog 上下文和 MDC，保留已有 TaskDecorator；普通线程池可使用 `TLogExecutors.wrap`。
* 自动配置容器内的 RestTemplate、WebClient.Builder、RestClient.Builder（Spring 6.1+）。
* 支持 Dubbo、Dubbox、Feign、HttpClient 4/5、OkHttp、Hutool HTTP、Forest。
* WebFlux、Spring Cloud Gateway、Soul、Shenyu 使用 Reactor Context 隔离请求，在 Reactor 回调中恢复日志上下文。
* 支持 JDK TimerTask、Quartz、Spring Scheduled、XXL-JOB。
* Kafka、RabbitMQ 通过消息 header 透传：Spring Kafka / Spring AMQP 自动装配（`tlog.kafka.enabled`、`tlog.rabbitmq.enabled`），原生客户端各一行接入；其它 MQ 可继续使用 `TLogMqWrapBean` 包装消息体。
* 支持 W3C `traceparent` 入站 traceId 复用、总开关和各功能开关；提供 IDE 配置提示。

## 快速接入

引入 `com.yomahub:tlog-web-spring-boot-starter:2.0.0`，并保留应用原有的 Spring Boot Web 或 WebFlux starter。在日志 pattern 中加入 `%X{tl}`，或者使用 TLog 提供的 encoder/layout/converter。

完整配置、异步边界和迁移示例见 [升级指南](https://gitee.com/dromara/TLog/blob/master/docs/TLOG_2.0_UPGRADE.md)，发布前验证命令见 [发布验收](https://gitee.com/dromara/TLog/blob/master/docs/TLOG_2.0_RELEASE.md)。

由于社区群超过200人，需要邀请入群。关注公众号后点击`个人微信`加我，我可以拉你入群

![offIical-wx](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/371b9e55c556d87d1b67cf76.jpg)

## 🦾赞助商

**Easysearch**

<a href="https://easysearch.cn/"><img src="https://infinilabs.cn/img/download/media-assets/easysearch-banner-4.webp"></a>

## 开源不易，支持就请赞助TLog

<img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/bed1335fbd4002ca3a0de2b7.jpg" alt="zanshang" width="258" />