Java 日志记录怎么用 SkyWalking 追踪日志

风雪姑娘_3705

风雪姑娘_3705

2026-11-19

451人浏览

原创

在 java 项目中集成 skywalking 追踪日志,核心做法是引入 skywalking-logback-appender(或对应框架的 appender)并配置日志格式。这样做的结果是,日志中会自动注入 traceid、spanid 等上下文信息,且日志数据会直接发送到 skywalking oap 服务器,从而在 ui 上实现日志与链路的关联。如果未正确配置 mdc 或 appender,日志将缺失链路标识,导致无法在 skywalking 界面中通过 traceid 过滤和查看具体日志。

Java 日志记录怎么用 SkyWalking 追踪日志

如何配置 Logback 以自动注入链路 ID

配置 Logback 的关键在于使用 SkyWalking 提供的 LogbackAppender 替代默认的 ConsoleAppender 或 FileAppender,并在布局中启用 %X{sw} 占位符。SkyWalking Agent 会自动将当前上下文的 TraceID 和 SpanID 放入 MDC(Mapped Diagnostic Context),Appender 负责将其提取并格式化输出。这样做后,控制台或文件中的每一行日志都会包含类似 [traceId: xxx, spanId: yyy] 的前缀,便于后续检索。若应用部署在 Kubernetes 环境中,还需确保 Pod 标签或环境变量正确传递,以便 SkyWalking 能准确识别服务实例。

Java 日志记录怎么用 SkyWalking 追踪日志

import ch.qos.logback.classic.PatternLayout;
import org.apache.skywalking.apm.toolkit.log.logback.v1.x.LogbackAppender;
import org.apache.skywalking.apm.toolkit.log.logback.v1.x.trace.MDCContextInjectConverter;

public class SkyWalkingLogConfig {
    public static void setup() {
        // 1. 创建自定义 Appender
        LogbackAppender appender = new LogbackAppender();
        appender.setName("skywalking");
        
        // 2. 设置布局,包含 %X{sw} 以获取链路信息
        PatternLayout layout = new PatternLayout();
        layout.setPattern("%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - trace:%X{sw} - %msg%n");
        appender.setLayout(layout);
        
        // 3. 启动 Appender
        appender.start();
        
        // 4. 添加到 Logger
        ch.qos.logback.classic.Logger rootLogger = (ch.qos.logback.classic.Logger) 
            org.slf4j.LoggerFactory.getLogger(ch.qos.logback.classic.Logger.ROOT_LOGGER_NAME);
        rootLogger.addAppender(appender);
    }
}

上述代码展示了如何在 Spring Boot 启动时动态注册 SkyWalking Appender。运行该程序后,控制台输出的日志将不再仅仅是普通文本,而是带有 SkyWalking 上下文信息的结构化数据。例如,当处理一个 HTTP 请求时,日志中会显示对应的 traceId,这个 ID 可以在 SkyWalking UI 的 Trace 详情页中直接使用,点击即可跳转到该次调用的完整日志流。这种配置方式确保了日志与分布式追踪数据的天然绑定,无需手动在每个业务方法中传递 ID。

如何在 SkyWalking UI 中关联日志与 Trace

在 SkyWalking UI 中关联日志与 Trace,需要在 OAP 服务端开启日志分析功能,并确保客户端发送的日志携带了正确的 traceId 和 serviceName。SkyWalking 8.x+ 版本默认支持通过 gRPC 接收日志数据,只要客户端配置了 LogbackAppender,日志就会自动上报到 OAP。在 UI 界面上,进入任意一个 Trace 详情页面,底部会出现“Logs”标签页,这里列出了该 Trace 涉及的所有节点日志。用户可以直接在该页面搜索关键字,或者按时间排序查看调用链上的每一步操作。若日志未出现在 UI 中,通常是因为 log.level 未设置为 INFO 以上,或者 traceId 未正确注入 MDC。

Java基础版
Java基础版

编写健壮 Java 代码的基础能力,覆盖空指针防护、相等性判断与基础异常处理。

下载

Java 日志记录怎么用 SkyWalking 追踪日志

// 模拟一个带日志的业务方法
@Service
public class OrderService {
    private static final Logger logger = LoggerFactory.getLogger(OrderService.class);

    public void createOrder(String orderId) {
        logger.info("Creating order: {}", orderId);
        // 业务逻辑...
        logger.debug("Order created successfully with ID: {}", orderId);
    }
}

这段代码演示了如何在业务层记录日志。当 createOrder 被调用时,由于全局配置了 SkyWalking Appender,logger.info 输出的消息会自动附加当前的 traceId。在 SkyWalking UI 中,你可以看到这条日志归属于特定的 Span。如果希望更精细地控制日志级别,可以在 application.yml 中配置 logging.level.root=INFO,这样只有 INFO 及以上级别的日志才会被收集,减少网络开销。此外,SkyWalking 还支持通过注解 @Trace 或 @Log 来增强特定方法的日志采集能力,但基础配置已能满足大多数场景下的链路日志关联需求。

当 TraceID 为空时日志为何无法关联

当 TraceID 为空时,日志无法在 SkyWalking UI 中关联,是因为 SkyWalking 依赖 traceId 作为唯一键值来聚合日志。如果 MDC 中没有 traceId,Appender 输出的日志将缺少关键标识,OAP 服务端无法将其挂载到任何 Trace 上。这种情况通常发生在非入口请求(如定时任务、异步线程池)中,因为 SkyWalking Agent 默认只拦截入口点(如 HTTP、gRPC)并创建新的 Trace。对于内部线程,需要手动传播上下文或使用 ThreadLocal 工具类。若未处理,这些日志虽然会被收集,但在 UI 中表现为孤立记录,无法展示调用关系。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12937

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

10002

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8492

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1344

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1068

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1616

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3389

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20611

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1475

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习