Skywalking原理篇(一)：Agent 启动流程解析

最新推荐文章于 2025-05-30 22:40:54 发布
最新推荐文章于 2025-05-30 22:40:54 发布
阅读量5k 收藏 13
点赞数
CC 4.0 BY-SA版权
分类专栏： Skywalking
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/wb4927598/article/details/119192636
本文详细介绍了SkyWalking Agent的启动流程，包括Java Agent的原理、如何实现一个Java Agent、SkyWalking Agent的核心流程。重点讨论了配置加载、插件解析和加载过程，以及BootService的启动和服务扩展。文章揭示了SkyWalking如何借助JVMTI和JPLISAgent对目标代码进行修改，以及在运行时如何进行类加载和增强。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

Java Agent简介

什么是Java Agent

Java Agent本质上可以理解为一个插件，该插件就是一个特制的Jar包。这个Jar包通过JVMTI（JVM Tool Interface）完成加载，最终借助JPLISAgent（Java Programming Language Instrumentation Services Agent）完成对目标代码的修改

如何实现一个Java Agent

实现Agent启动方法

Java Agent 支持目标JVM启动时加载以及JVM运行时加载，这两种不同的加载模式会使用不同的入口函数。
如果需要在目标JVM启动的同时加载 Agent，那么可以选择实现下面的方法

  1. public static void premain(String agentArgs, Instrumentation inst)
  2. public static void premain(String agentArgs)

如果需要在目标JVM运行时加载 Agent，那么可以选择实现下面的方法

  1. public static void agentmain(String agentArgs, Instrumentation inst)
  2. public static void agentmain(String agentArgs)

JVM 将首先寻找1，如果没有发现1，再寻找2。代码中有两个参数需要注意
agentArgs：-javaagent 命令携带的参数。agent.service_name 这个配置项的默认值有三种覆盖方式，其中，使用探针配置进行覆盖，探针配置的值就是通过该参数传入的
inst：java.lang.instrumen.Instrumentation 是 Instrumention 包中定义的一个接口，它提供了操作类定义的相关方法，核心方法如下

  • addTransformer()/removeTransformer()：注册/注销一个 ClassFileTransformer 类的实例，该 Transformer 会在类加载的时候被调用，可用于修改类定义
  • redefineClasses()：该方法针对的是已经加载的类，它会对传入的类进行重新定义
  • getAllLoadedClasses()：返回当前 JVM 已加载的所有类
  • getInitiatedClasses()：返回当前 JVM 已经初始化的类
  • getObjectSize()：获取参数指定的对象的大小

​

指定Main-Class

定义一个 MANIFEST.MF 文件，在其中添加 premain-class 或 Agent-Class 配置项

Manifest-Version: 1.0
PreMain-Class: com.test.AgentClass
Agent-Class: com.test.AgentClass

Agent加载

  • 启动时加载：启动参数增加-javaagent:[path]，其中path为对应的agent的jar包路径
  • 运行中加载：使用com.sun.tools.attach.VirtualMachine加载

​

SkyWalking Agent启动流程

核心流程

skywalking的agent入口函数在org.apache.skywalking.apm.agent.SkywalkingAgent#premain
方法具体实现如下(省略了异常代码块及日志打印)

final PluginFinder pluginFinder;
// 初始化配置信息
SnifferConfigInitializer.initializeCoreConfig(agentArgs);
// 加载agent插件, 并使用PluginFinder为插件进行分类
pluginFinder = new PluginFinder(new PluginBootstrap().loadPlugins());
// 创建一个ByteBuddy对象用于修改字节码
final ByteBuddy byteBuddy = new ByteBuddy().with(TypeValidation.of(Config.Agent.IS_OPEN_DEBUGGING_CLASS));
// 创建一个AgentBuilder对象，详细代码省略...
AgentBuilder agentBuilder = new AgentBuilder(byteBuddy)...
// 使用JDK SPI加载并启动BootService
ServiceManager.INSTANCE.boot();
// 添加一个JVM勾子函数, 在JVM退出时关闭所有BootService服务
Runtime.getRuntime()
    .addShutdownHook(new Thread(ServiceManager.INSTANCE::shutdown, "skywalking service shutdown thread"));

核心启动流程如下图所示
在这里插入图片描述

初始化配置

配置初始化的入口方法在
org.apache.skywalking.apm.agent.core.conf.SnifferConfigInitializer
#initializeCoreConfig
方法的具体实现如下(省略了异常代码块及日志打印)

AGENT_SETTINGS = new Properties();
// 1.加载agent.config配置文件
final InputStreamReader configFileStream = loadConfig();
AGENT_SETTINGS.load(configFileStream);
for (String key : AGENT_SETTINGS.stringPropertyNames()) {
   
   
    String value = (String) AGENT_SETTINGS.get(key);
    // 2.解析agent.config文件中的配置
    AGENT_SETTINGS.put(key, PropertyPlaceholderHelper.INSTANCE.replacePlaceholders(value, AGENT_SETTINGS));
}
// 3.解析skywalking.开头的系统参数，截取后写入配置类
overrideConfigBySystemProp();
agentOptions = StringUtil.trim(agentOptions, ',');
if (!StringUtil.isEmpty(agentOptions)) {
   
   
	agentOptions = agentOptions.trim();
    // 4.解析Java Agent参数, 写入配置类
    overrideConfigByAgentOptions(agentOptions);
}
// 5.将配置类中的信息填充到Config类对应的静态字段中
initializeConfig(Config.class);
IS_INIT_COMPLETED = true;

可以看到配置信息会依次从三个地方进行获取并覆盖

  • agent.config 文件
  • 系统参数
  • javaagent options

所以，配置参数的优先级为 javaagent options > 系统参数 > agent.config文件
下面通过在3个地方同时配置 agent.service_name 参数来验证一下配置加载流程
以 Live-Demo + skywalking源码 项目为例
修改项目 ProjectB 的JVM启动参数，同时配置 javaagent options、系统参数

-javaagent:/Users/wangbo/Documents/Study_Workspace/skywalking/skywalking-agent/skywalking-agent.jar=agent.service_name=Project_Options
-Dskywalking.agent.service_name=Project_Env

覆盖 agent.config 中指定参数的的环境变量

SW_AGENT_NAME=Project_Config

在这里插入图片描述

然后debug启动 projectB 进行源码调试

加载agent.config配置文件

private static final String SPECIFIED_CONFIG_PATH = "skywalking_config";
private static final String DEFAULT_CONFIG_FILE_NAME = "/config/agent.config";
String specifiedConfigPath = System.getProperty(SPECIFIED_CONFIG_PATH);
File configFile = StringUtil.isEmpty(specifiedConfigPath) ? new File(
    AgentPackagePath.getPath(), DEFAULT_CONFIG_FILE_NAME) : new File(specifiedConfigPath);

源码中第一步为加载 agent.config 配置文件，可以看出agent.config 文件加载的优先级为
环境变量 skywalking_config 指定的路径 > skywalking-agent.jar 同级的config目录
​

解析agent.config配置

在这里插入图片描述
第一步agent.config文件加载到properties后，默认的配置格式都是 **配置项 = ${环境变量:配置默认值}**
第二步将对具体的值进行解析，首先判断环境变量中是否包含该配置，有则替换，无则使用默认值，所以解析后的配置格式变为 **配置项 = 配置值** 。可以看到 agent.service_name 对应的值为Project_Config
​

解析系统参数配置在这里插入图片描述

第三步为解析系统参数，可以看到 agent.service_name 被覆盖为 Project_Env
​

解析javaagent options配置

在这里插入图片描述
第四步为解析javaagent options参数，可以看到agent.service_name被覆盖为Project_Options
​

将解析出来的配置全部填充到Conig静态配置类中

在这里插入图片描述
配置加载的最终目的就是将配置项全部填充到Config配置类的各个静态字段中，这样后续使用配置信息时直接通过Config类进行获取即可，可以看到之前配置的 agent.service_name 在最后一步被确定为 Project_Options
​

插件加载

加载插件的入口方法在
org.apache.skywalking.apm.agent.core.plugin.PluginBootstrap#loadPlugins
方法的具体实现如下

// 自定义类加载器初始化
AgentClassLoader.initDefaultLoader();
// 创建插件定义解析类
PluginResourcesResolver resolver = new PluginResourcesResolver();
// 通过调用AgentClassLoader的资源加载方法解析出所有插件定义文件的路径
List<URL> resources = resolver.getResources();
if (resources == null || resources
最低0.47元/天 解锁文章

200万优质内容无限畅学
一文探索【skywalking】如何通过agent实现启动流程
m0_71777195的博客
07-05 1397
SkyWalking是一个APM(application performance monitor)系统，专门为微服务、云原生和基于容器(Docker、Kubernetes、Mesos)的架构而设计，包含了云原生架构下的分布式系统的监控、跟踪、诊断功能。通过agent的方式，可以做到对代码无侵入式的介入，实时实现整个服务链路的监控。本文的将要介绍的重点是SkyWalking如何通过agent实现如此全面的监控功能。这里提到的agent是在java中使用的agent技术，本文所讲的内容也是依托于java为基础的
Skywalking原理篇(二)：Agent 与 OAP 的通信原理
wb4927598的博客
07-29 4186
GRPC 基础知识 基本介绍 gRPC 是一个高性能、开源和通用的 RPC 框架，面向服务端和移动端，基于 HTTP/2 协议标准而设计，默认使用 ProtoBuf(Protocol Buffers) 序列化协议进行开发，当前支持C、Java、Go等多种语言 gRPC提供了一种简单的方法来精确的定义服务，并且为客户端和服务端自动生成可靠的功能库。与很多RPC系统一样，服务端负责实现定义好的接口并处理客户端的请求，客户端根据接口描述直接本地调用需要的服务而不用去关心具体底层通信细节和调用过程。客户端和服务端
skywalking agent部署
weixin_43745330的博客
04-20 5923
文章目录一 说明二 探针配置方式1 修改catalina.sh（以tomcat为例）方式2 启动命令中添加参数javaagent、Dskwalking.agent.service_name三 展示效果 一 说明 SkyWalking Agent探针有区别于jmx探针，jvm探针的数据是被拉取到的，而SkyWalking Agent探针的数据需要主动推送给SkyWalking的。所以我们需要配置一些东西。 skywalking agent文件夹见附件（agent文件夹里面包含skywalking-agen
skyWalking
2509_90931430的博客
05-30 220
【代码】skyWalking。
第09讲：SkyWalking Agent 启动流程剖析，领略微内核架构之美
Marion的博客
05-27 1931
初始化配置信息。该步骤中会加载 agent.config 配置文件，其中会检测 Java Agent 参数以及环境变量是否覆盖了相应配置项。查找并解析 skywalking-plugin.def 插件文件。AgentClassLoader 加载插件。PluginFinder 对插件进行分类管理。使用 Byte Buddy 库创建 AgentBuilder。这里会根据已加载的插件动态增强目标类，插入埋点逻辑。使用 JDK SPI 加载并启动 BootService 服务。
Skywalking Agent原理剖析
m0_46690280的博客
05-16 6524
Skywalking Agent原理剖析Skywalking Agent原理剖析1 agent原理1.1 Java Agent1.2 定义自己的agent Skywalking Agent原理剖析 1 agent原理 使用Skywalking的时候，并没有修改程序中任何一行 Java 代码，这里便使用到了 Java Agent 技术，我们接下来展开对Java Agent 技术的学习。 1.1 Java Agent Java Agent 是从 JDK1.5 开始引入的，算是一个比较老的技术了。作为 Java
SkyWalking 的 Agent
宽带你的世界
05-23 577
org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.InstanceMethodsEnhancePluginDefine.MethodInterceptor: 这个接口定义了拦截器的基本方法，如 beforeMethod, afterMethod, throwing。org.apache.skywalking.apm.agent.core.boot.ServiceDiscoveryBootStrap: 负责服务发现的初始化。
SkyWalking Agent 实现原理
lewee0215的专栏
11-12 9549
微内核架构 SkyWalking Agent 采用了微内核架构（Microkernel Architecture），那什么是微内核架构呢？微内核架构也被称为插件化架构（Plug-in Architecture），是一种面向功能进行拆分的可扩展性架构。在基于产品的应用中通常会使用微内核架构，例如，IDEA、Eclipse 这类 IDE 开发工具，内核都是非常精简的，对 Maven、Gradle 等新功能的支持都是以插件的形式增加的。 如下图所示，微内核架构分为核心系统和插件模块两大部分。 在上图展
SkyWalking入门之Agent原理初步分析
分享不一样的技术，与你一起共同成长!
09-15 2852
当前稍微上点体量的互联网公司已经逐渐采用微服务的开发模式，将之前早起的单体架构系统拆分为很多的子系统，子系统封装为微服务，彼此间通过HTTP协议RESET API的方式进行相互调用或者gRPC协议进行数据协作。早期微服务之后几个的情况下，我们遇到问题可以直接简单、快速地通过采集日志进行分析，是A服务存在问题或者B服务存在问题等快速恢复服务。但是，如果微服务数量已经到达了几十个、甚至上百个，这些微服务之间的调用关系会变得错综复杂.....
Docker部署SkyWalking+ElasticSearch+Agent
wfw123123的博客
03-12 878
Docker部署SkyWalking+ElasticSearch+Agent 实现对java应用链路监控
# 分布式链路追踪_skywalking_学习（4）
段子手168的博客
05-22 1799
分布式链路追踪_skywalking_学习（4） 一、分布式链路追踪_skywalking ：java-agent 环境搭建 二、分布式链路追踪_skywalking ：javaagent 原理-统计方法调用时间 三、分布式链路追踪_skywalking ：OpenTracing 介绍
skywalking-agent-java-8.3.0
09-01
skywalking-agent-java-8.3.0
skywalking源码1---分布式追踪原理
piliang719719的博客
03-06 1914
skywalking源码，http分布式链路追踪原理
SpringCloud(20)之Skywalking Agent原理剖析
jokeMqc的博客
03-06 1748
1）探针工程创建工程hailtaxiagent用来编写agent包，该类需要用mavenassemblyplugin打包，我们先引入--自动添加META-INF/MANIFEST.MF -->-- 添加 mplementation-*和Specification-*配置项-->-- 将 premain-class 配置项设置为com.jokermqc.LoginAgent-->
skywalking源码--agent启动流程
SO_zxn的博客
11-08 840
skywalking-agent启动流程
SkyWalking Agent数据采集和上报原理浅析
徐小陌的博客
03-25 7203
Skywalking是一款云原生的APM（应用性能管理）系统。包含了事件日志、链路追踪、指标监控能力，同时提供了数据的采集、数据存储以及数据展示三个先对独立的子系统。是一款“广义的”分布式链路追踪系统。 上一篇文章《SkyWalking如何通过修改字节码让插件生效》讲了SkyWalking的插件工作原理，这篇文章就来探索一下SkyWalking到底是如何实现链路追踪和指标监控的功能的。 整体工作原理 采集数据过程分析 链路追踪核心概念：Trace、Span。 具体在这里不展开，可以自行参考《Ope.
SkyWalking8.7源码解析（一）：Agent启动流程、Agent配置加载流程、自定义类加载器AgentClassLoader、插件定义体系、插件加载
热门推荐
hxt的博客
12-12 1万+
1、Agent启动流程 找到入口方法SkyWalkingAgent的premain()方法，源码如下： public class SkyWalkingAgent { /** * Main entrance. Use byte-buddy transform to enhance all classes, which define in plugins. * -javaagent:/path/to/agent.jar=agentArgs * -javaagent:
Skywalking应用
m0_46690280的博客
05-12 1090
Skywalking应用Skywalking应用1 Skywalking概述1.1 微服务系统监控三要素1.2 什么是链路追踪1.2.1 链路追踪1.2.2 OpenTracing1.3 常见APM系统1.4 Skywalking介绍2 Skywalking安装2.1 elasticsearch安装2.2 Skywalking安装3 Skywalking应用3.1 agent下载 Skywalking应用 1 Skywalking概述 随着互联网架构的扩张，分布式系统变得日趋复杂，越来越多的组件开始走向分
skywalking agent实现原理
最新发布
06-01
<think>嗯，用户想了解SkyWalkingAgent的实现原理，特别是它如何与Java字节码插桩技术相关。首先，我需要回忆一下之前讨论过的字节码插桩技术，比如Javassist和ASM的区别，以及如何在Android项目中应用。用户现在提到的SkyWalking，是一个APM系统，它通过JavaAgent机制进行监控，所以需要结合Java Agent和字节码插桩来解释。用户提供的引用中提到了SkyWalking使用字节码增强，通过premain方法加载插件，拦截目标类的方法。引用[3]详细描述了SkyWalking Agent的加载过程，包括如何通过InstrumentationAPI修改类的字节码。这应该和Java的Instrumentation机制有关，也就是javaagent如何在JVM启动时加载并修改类。接下来，需要将SkyWalking Agent的工作流程分步骤解释。首先，用户需要了解Java Agent的机制，即通过-javaagent参数指定agentjar，在应用启动前执行premain方法。然后，SkyWalking利用Instrumentation API注册类转换器，在类加载时进行字节码修改。这里可能涉及到ASM或Javassist这样的字节码操作库，但根据引用中的信息，SkyWalking可能使用自己的方式或基于这些库。然后，需要说明插桩的具体过程，比如如何定位目标方法，插入监控代码，例如记录方法耗时，并通过gRPC发送数据到OAP。这部分需要结合字节码插桩的步骤，比如访问方法入口和出口，插入前后逻辑。还要注意用户提到的引用中的内容，比如插件加载、配置文件的解析，以及如何避免与混淆工具冲突。不过用户现在的问题集中在实现原理，可能需要先聚焦在Agent启动、字节码修改和数据上报流程。另外，用户之前的问题涉及Javassist和ASM的区别，这里可能需要提到SkyWalking使用的是哪种工具。根据引用中的描述，可能更偏向于ASM，因为需要高性能和细粒度控制，但需要确认。 最后，生成相关问题时要考虑用户可能进一步想了解如何自定义插件、性能影响，或者与其他监控工具的区别。需要确保回答结构清晰，分点说明，并正确引用提供的资料中的信息。</think>### SkyWalking Agent实现原理（基于Java字节码插桩） #### 一、核心机制 SkyWalking Agent通过**Java Agent机制**实现字节码插桩，其核心流程可分为三个阶段： 1. **Agent加载** JVM启动时通过`-javaagent`参数加载Agent，触发`premain`方法[^2][^3]。 ```bash java -javaagent:/path/skywalking-agent.jar -jar app.jar ``` 2. **字节码增强** - 使用`Instrumentation` API注册`ClassFileTransformer`，拦截类加载过程[^3]。 - 通过**ASM**库解析目标类的字节码，在方法入口/出口插入监控逻辑（如记录耗时）[^1][^3]。 - 示例：拦截Spring MVC Controller方法 ```java public class ControllerInterceptor { @Override public void beforeMethod() { ContextManager.createLocalSpan("HTTP_URI"); //创建跟踪上下文[^1] } @Override public void afterMethod() { ContextManager.stopSpan(); //结束跟踪并上报数据 } } ``` 3. **数据上报** 增强后的代码通过gRPC将监控数据（Trace、Metrics）发送至SkyWalking OAP服务[^3]。 #### 二、关键技术点 | 技术组件 | 作用 | |-------------------|----------------------------------------------------------------------| | Java Agent | 提供JVM级入口，支持类加载拦截[^2] | | ASM字节码操作库 | 高效修改字节码，插入埋点逻辑[^1] | | 插件体系 | 按需加载插件（如MySQL、Redis插件），避免不必要的性能损耗[^1][^3] | | 上下文传播 | 通过ThreadLocal或跨线程包装实现分布式链路跟踪[^1] | #### 三、实现步骤详解 1. **插件定义** 每个插件包含： - `skywalking-plugin.def`：声明拦截的目标类和方法[^3] ```properties tomcat=org.apache.skywalking.apm.plugin.tomcat.TomcatInstrumentation ``` - 拦截器实现类：定义增强逻辑（如记录SQL执行耗时）[^1] 2. **类加载拦截** ```java public class SkyWalkingAgent { public static void premain(String args, Instrumentation inst) { inst.addTransformer((loader, className, classBeingRedefined, protectionDomain, classfileBuffer) -> { // 使用ASM修改classfileBuffer return newByteCode; }); } } ``` 3. **代码增强示例** 原始方法： ```java public void executeQuery(String sql) { connection.query(sql); } ``` 增强后字节码： ```java public void executeQuery(String sql) { Span span = ContextManager.createLocalSpan("SQL"); try { connection.query(sql); } finally { span.tag("sql", sql); span.finish(); } } ``` #### 四、性能优化策略 1. **懒加载机制**：仅在实际调用被监控方法时初始化跟踪上下文[^1] 2. **采样率控制**：通过配置过滤低价值监控数据 3. **本地缓存**：Trace数据先缓存再批量上报，减少网络开销[^3] #### 五、与其他技术的对比 | 对比维度 | SkyWalking Agent | 传统AOP框架 | |----------------|-------------------------|----------------------| | 代码侵入性 | 无侵入 | 需注解或配置切面 | | 监控粒度 | 方法级 | 通常为类级 | | 性能损耗 | <3% | 5%-10% | | 分布式支持 | 内置TraceID传播 | 需手动实现 | ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值