摘要: 原创出处 http://www.iocoder.cn/SkyWalking/build-debugging-environment/ 「芋道源码」欢迎转载,保留摘要,谢谢!
本文主要基于 SkyWalking 3.2.6 正式版
从官方仓库 https://github.com/OpenSkywalking/skywalking Fork
出属于自己的仓库。为什么要 Fork
?既然开始阅读、调试源码,我们可能会写一些注释,有了自己的仓库,可以进行自由的提交。?
使用 IntelliJ IDEA
从 Fork
出来的仓库拉取代码。拉取完成后,Maven
会下载依赖包,可能会花费一些时间,耐心等待下。
本文基于 master
分支。
参考 《官方文档 —— How to build》
mvn compile -Dmaven.test.skip=true
进行编译。grpc-java
和 java
目录grpc-java
和 java
目录org.skywalking.apm.collector.bootCollector.BootStartUp
的 #main(args)
方法,启动 Collector 。http://127.0.0.1:10800/agent/jetty
地址,返回 ["localhost:12800/"]
,说明启动成功。感谢 吴晟 指导如何搭建 Agent 调试环境。
mvn compile -Dmaven.test.skip=true
进行编译。在 /packages/skywalking-agent 目录下,我们可以看到编译出来的 Agent :
友情提示 :这里一定要注意下。创建的 Web 项目,使用 IntelliJ IDEA 的菜单 File / New / Module 或 File / New / Module from Existing Sources ,保证 Web 项目和 skywalking 项目平级。这样,才可以使用 IntelliJ IDEA 调试 Agent 。
org.skywalking.apm.agent.SkyWalkingAgent
的 #premain(…)
方法,打上调试断点。#main(args)
方法,并增加 JVM 启动参数,-javaagent:/path/to/skywalking-agent/skywalking-agent.jar
。/path/to
参数值为上面我们编译出来的 /packages/skywalking-agent 目录的绝对路径。如下图 :
考虑到可能我们会在 Agent 上增加代码注释,这样每次不得不重新编译 Agent 。可以配置如下图,自动编译 Agent :
-T 1C clean package -Dmaven.test.skip=true -Dmaven.compile.fork=true
。另外,使用 IntelliJ IDEA Remote 远程调试,也是可以的。如下图 :
考虑到调试过程中,我们要看下是否收集到追踪日志,可以安装 SkyWalking Web UI 进行查看。
参考 《官方文档 —— Sky Walking Web UI》 安装。
SkyWalking 环境搭建完成,胖友们可以起飞,源码读起来。
这会是个系列文章,笔者会慢慢更新。
如下是笔者对代码量和用途的简单整理,完善度比较低,可能有一丢丢的帮助 :