TLog：轻量级的分布式日志标记追踪工具

在现代软件开发中，分布式系统的日志管理和追踪一直是一个挑战。为了解决这个问题，TLog应运而生，它是一个轻量级的分布式日志标记追踪工具，能够在短短十分钟内接入，并自动对日志进行标记，完成微服务的链路追踪。本文将介绍TLog的特性、接入方式、以及如何使用。

📖 简介

TLog是一个分布式日志标记追踪工具，其主要特点包括：

• 支持log4j、log4j2、logback等主流日志框架，自动检测并适配。
• 支持dubbo、dubbox、springcloud等主流RPC框架。
• 提供三种接入方式：javaagent完全无侵入接入，字节码一行代码接入，基于配置文件的接入。
• 无业务代码侵入式设计，使用简单，接入快速。
• 支持Spring Cloud Gateway和Soul网关。
• 提供多种自定义标签模板，适应不同场景需求。

🍬 TLog 特性

TLog具有以下特性：

• 轻量级微服务日志追踪：通过对日志打标签完成微服务的轻量级日志追踪。
• 多种接入方式：提供javaagent、字节码、配置文件等多种接入方式，灵活适用于不同项目环境。
• 适配广泛：支持主流的RPC框架和日志框架，包括dubbo、dubbox、springcloud以及log4j、log4j2、logback等。
• 自定义标签模板：支持自定义方法级别的标签，便于定位日志。
• 异步线程追踪：支持异步线程的追踪，包括线程池、多级异步线程等场景。
• 低性能损耗：几乎无性能损耗，经过压测，损耗在0.01%以内。

✨Gitee荣誉证书

TLog曾入选2020年GVP，是对其质量和影响力的认可。

🦋 轻量，强大

TLog通过对日志打标签的方式完成微服务的日志追踪，具有轻量级且强大的特点。它不收集日志，而是生成全局唯一的追踪码，并支持SpanId和上下游服务信息标签的追加。同时，用户还可以根据需求自定义方法级别的标签，轻松定位日志。

⏰ 10分钟接入

TLog为用户提供了多种接入方式，其中最快速的方式只需10分钟即可完成接入。通过自动探测项目中使用的RPC框架和日志框架，并进行字节码的注入，TLog能够自动生成系统级日志标签，使接入过程简单快捷。

🧩 适配广泛

TLog不仅适配了市面上主流的RPC框架和日志框架，还支持多种网关、定时任务框架以及HTTP框架，为用户提供了广泛的选择空间。

🧱TLog架构图

TLog的架构图展示了其设计理念和实现方式，用户可以更好地理解TLog的工作原理和内部机制。

✨TLog 最新版本

用户可以通过Maven添加TLog的依赖，以获取最新版本的TLog。

<code><dependency> <groupId>com.yomahub</groupId> <artifactId>tlog-all-spring-boot-starter</artifactId> <version>1.5.1</version> </dependency></code>

⚒️TLog 接入方式

TLog提供了三种接入方式，分别适用于不同的项目环境和需求。具体选择哪种接入方式，可根据项目情况进行评估。

Javaagent接入方式

Javaagent方式是一种完全不侵入项目的接入方式，只需在项目的启动参数中添加相应的配置即可。

1. 在启动参数中加入Javaagent配置：-javaagent:/your_path/tlog-agent.jar
2. 根据具体情况配置相关参数，即可完成接入。

👉 TLog中SpanId的生成规则介绍

SpanId代表本次调用在整个调用链路树中的位置，通过SpanId可以组成一棵完整的链路树，便于日志追踪和定位。

🎈总结

TLog是一款简单易用、功能强大的分布式日志标记追踪工具，能够帮助用户解决微服务架构下的日志管理和追踪问题。无论是中小型企业还是大型项目，都可以通过TLog实现快速、高效的日志追踪，提升系统的可观测性和调试效率。

通过本文的介绍，相信您已经对TLog有了更深入的了解。如果您对TLog感兴趣，可以访问官网获取更多信息，并通过Gitee参与到TLog的开发和改进中。

🌐相关链接

• 官网：https://tlog.yomahub.com/
• 项目地址：https://gitee.com/dromara/TLog
• 开发手册：https://tlog.yomahub.com/pages/5b7bd2/
• 最新 tlog-agent.jar 下载地址：https://gitee.com/dromara/TLog/releases/v1.5.0