# TLog

**Repository Path**: dromara/TLog

## Basic Information

- **Project Name**: TLog
- **Description**: 一个轻量级的分布式日志标记追踪神器，10分钟即可接入，自动对日志打标签完成微服务的链路追踪
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://tlog.yomahub.com
- **GVP Project**: Yes

## Statistics

- **Stars**: 3313
- **Forks**: 753
- **Created**: 2020-08-01
- **Last Updated**: 2025-06-16

## Categories & Tags

**Categories**: logging

**Tags**: 日志, 链路追踪

## README

<p align="center">
<a href="https://tlog.yomahub.com/">
    <img width="500" src="static/img/logo.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)

## 特性
* 通过对日志打标签完成轻量级微服务日志追踪
* 提供三种接入方式：javaagent完全无侵入接入，字节码一行代码接入，基于配置文件的接入
* 对业务代码无侵入式设计，使用简单，10分钟即可接入
* 支持常见的log4j，log4j2，logback三大日志框架，并提供自动检测，完成适配
* 支持dubbo，dubbox，springcloud三大RPC框架
* 支持Spring Cloud Gateway和Soul网关
* 适配HttpClient和Okhttp的http调用标签传递
* 支持三种任务框架，JDK的TimerTask，Quartz，XXL-JOB
* 支持日志标签的自定义模板的配置，提供多个系统级埋点标签的选择
* 支持异步线程的追踪，包括线程池，多级异步线程等场景
* 几乎无性能损耗，快速稳定，经过压测，损耗在0.01%

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

![offIical-wx](static/img/offical-wx.jpg)

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

<img src="static/img/zanshang.jpeg" alt="zanshang" width="258" />