skywalking从入门到精通(四)-自定义链路追踪

最新推荐文章于 2025-10-28 09:39:00 发布

原创

最新推荐文章于 2025-10-28 09:39:00 发布 · 3.9k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#skywalking #java #spring boot

文章介绍了如何使用SkyWalking进行自定义链路追踪，包括通过@Trace注解和SkyWalkingXML配置两种方式。提供了代码示例，展示了在方法上添加注解和使用编码方式实现链路追踪，以及利用OpenTracingAPI进行更灵活的追踪。同时，文章包含了错误日志记录和如何集成OpenTracing的相关步骤。

一、前言

在上述的示例中，我们都是通过 SkyWalking 提供的插件，实现对指定框架的链路追踪。那么，如果我们希望对项目中的业务方法，实现链路追踪，方便我们排查问题，需要怎么做呢？SkyWalking 提供了两种方式：

方式一，通过 SkyWalking @Trace 注解，可见《Application-toolkit-trace.md》文档。
方式二，通过 SkyWalking XML 配置，可见《Customize-enhance-trace.md》文档。

项目源代码地址: https://gitee.com/T-OPEN/skywalking-demo/tree/dev/
注意切换到dev分支进行调试。

二、自定义链路追踪

2.1 引入依赖jar

在需要进行自定义链路追踪的项目pom文件引入如下依赖，为了更好的兼容性，所以我们引入的apm-toolkit-trace 和我们前面java-agent都是使用 8.9.0版本：

   <dependency>
       <groupId>org.apache.skywalking</groupId>
       <artifactId>apm-toolkit-trace</artifactId>
       <version>8.9.0</version>
   </dependency>

2.2 代码中自定义链路追踪

实现自定义的链路追踪，我们有两种方式，第一种是方式上添加注解，第二种是代码中植入追踪代码

方法一：注解法

这种方案我认为比较适合方法体逻辑不复杂，我们只需要记录方法的出参，入参。需要注意的是 @Trace注解一定不能少，如果需要打印返回结果，一定要重写返回结果的toString方法，否者只会打印出来一个内存地址。

    @Trace
    @Tag(key = "orderId", value = "arg[0]") //固定写法必须写成 arg[0]
    @Tag(key = "userId", value = "arg[1]")
    @Tag(key = "result.orderId", value