如何用vbs编写一个游戏_如何编写一个 SkyWalking 插件
点击上方“开源社”关注我们
| 作者:vcjmhg| 编辑:李明康| 责编:袁睿斌
| 设计:叶修缘丶
1
概述
之前几篇文章,我们着重介绍了在对 SkyWalking 进行二次开发之前的环境搭建问题,因此本篇文章将基于 SkyWalking-8.1.0 版本,以开发 webflux-webclent 插件为例,分享一下对 SkyWalking 插件开发以及贡献 PR 的过程(PR 地址),以期能为大家了解 SkyWalking java agent 插件的开发有所帮助。
2
概念SpanSpan
应该是分布式链路追踪系统一个非常重要而且常见的一个概念。最早源自于Google Dapper 的论文--Dapper, a Large-Scale Distributed Systems Tracing Infrastructure,此处给出论文地址,感兴趣的小伙伴可以深入学习。简单来说,Span可以简单理解成一次服务的调用。只要是一个具有完整时间周期的程序访问,都可以简单看做是一个span。当然SkyWalking
中的span
与论文中的spSan
类似,但同时也进行了一些扩展,具体来说,在SkyWalking
中span分成以下三种:
- EntrySapn:代表服务提供者,也就是服务器的端点。我们可以简单理解成服务的提供方,比如对外提供服务的
Webflux
服务或者MQ的消费则都是EntrySpan。 - ExitSpan:代表服务的消费者,比如一个服务的客户端或者消息队列的生产者都可以理解成一个ExitSpan。
- LocalSpan:与前边的EntrySpan和ExitSpan相比,LocalSpan的概念就比较特殊了,它其实本身与远程服务调用没有任何关系,它更多的可能指代的的本地的java方法。它的出现可能是为了解决
SkyWalking
监控本地方法调用的问题。比如说,我们想知道某个本地方法的调用请求,我们便可以将该方法定义成一个LocalSpan
,然后OAP
端便可以收集到对应的span信息,然后在web端清晰的展示该方法的调用情况。
上下文载体(ContextCarrier)因为分布式追踪,大部分情况下都是跨进程的,因此为了解决跨进程的链路绑定问题,SkyWalking
引入了ContextCarrier
的概念。以下是有关如何在 A -> B 分布式调用中使用 ContextCarrier
的步骤.
- 在客户端, 创建一个新的空的 ContextCarrier.
- 通过
ContextManager#createExitSpan
创建一个ExitSpan
或者使用ContextManager#inject
来初始化ContextCarrier
. - 将
ContextCarrier
所有信息放到请求头 (如 HTTP HEAD), 附件(如 Dubbo RPC 框架), 或者消息 (如 Kafka) 中 - 通过服务调用, 将
ContextCarrier
传递到服务端.在服务端, 在对应组件的头部, 附件或消息中获取ContextCarrier
所有内容. - 通过
ContestManager#createEntrySpan
创建EntrySpan
或者使用ContextManager#extract
来绑定服务端和客户端.
异步API
因为官方关于插件具体的开发是给了比较详细的开发文档的
https://skyapm.github.io/document-cn-translation-of-skywalking/zh/6.2.0/guides/Java-Plugin-Development-Guide.html
因此我在此时针对API部分就不详细来说了,我会重点介绍几个自己在开发webflux webclient
的过程中用到的异步API。
因为此次是对webflux WebClient
来开发插件,许多方法的调用都需要时跨线程的因此,我们需要使用异步API。
简单来说异步API的使用步骤如下:
在原始上下文中调用
AsyncSpan#PrepareForAsync
;将该Span传递到其他线程,并江湾城相关属性比如tag、log、status code等属性进行设置;
全部操作就绪之后,可在任意线程中调用
#asyncFinish
结束调用当所有的
#prepareForAsync
完成之后,追踪上下文就会结束,并一起被会传到后端服务(根据API的执行次数来进行判断)。
3
插件编写确定拦截点
插件本身的开发肯定有一定的业务的逻辑,因此我们在开发之前需要根据插件的业务逻辑的确定合适的插入点位置。以webflux-webclient-plugin
为例,因为该插件本质上是为了获取webclient在发起请求时的调用信息,因此在确定插入点之前我们首先要分析,它整个的调用过程是怎么的。
因此我对WebClient从发起请求到获得相应整个过程进行了分析,画出了如下的:
分析整个过程,我发现,无论 WebClient 调用的是 retrieve( )
方法还是调用的 exchange()方法,最终在发起请求的时候都是通过 org.springframework.web.reactive.function.client.ExchangeFunctions$DefaultExchangeFunction
的 exchange( )
方法实际执行异步请求,并且返回一个 Mono
类型的响应结果。
因此我们考虑使用 DefalutExchangeFunction#exchange( )
方法作为插入点方法,但仅仅使用这一个插入点是否是足够的哪?
这里我们先留下一个小小的悬念,在业务代码开发部分,我会详细讲解自己在开发过程中所遇到的坑!!
拦截与业务代码开发
在插入点进行确定之后,我们便可以结合业务逻辑开始代码部分的开发。
在创建的插件目录的Resourse
目录,定义一个skywalking-plugin.def
文件,添加插件定义:
spring-webflux-5.x-webclient=org.apache.skywalking.apm.plugin.spring.webflux.v5.webclient.define.BodyInserterRequestInstrumentation
在define
目录下创建Instrumentation
类,以webflux-webclient插件为例,我创建了一个WebFluxWebClientInterceptor
类,用来指定拦截点的具体方法。
具体代码如下所示:
public class WebFluxWebClientInstrumentation extends ClassEnhancePluginDefine { private static final String ENHANCE_CLASS = "org.springframework.web.reactive.function.client.ExchangeFunctions$DefaultExchangeFunction"; private static final String INTERCEPT_CLASS = "org.apache.skywalking.apm.plugin.spring.webflux.v5.webclient.WebFluxWebClientInterceptor"; @Override protected ClassMatch enhanceClass() { return NameMatch.byName(ENHANCE_CLASS); } @Override public ConstructorInterceptPoint[] getConstructorsInterceptPoints() { return new ConstructorInterceptPoint[0]; } @Override public InstanceMethodsInterceptPoint[] getInstanceMethodsInterceptPoints() { return new InstanceMethodsInterceptPoint[]{ new InstanceMethodsInterceptPoint() { @Override public ElementMatcher getMethodsMatcher() { return named("exchange"); } @Override public String getMethodsInterceptor() { return INTERCEPT_CLASS; } @Override public boolean isOverrideArgs() { return false; } } }; } @Override public StaticMethodsInterceptPoint[] getStaticMethodsInterceptPoints() { return new StaticMethodsInterceptPoint[0]; }
实现对应的Interceptor
有了插入点之后,我们还需要通过一个类来对插入点方法做具体增强的工作,因此我们定义了一个WebFluxWebClientInstrumentation
类用来做具体的方法增强工作。
具体来说,在该类中做了如下操作:
获取请求参数,收集链路信息
创建ContextCarrier,为进程的数据管理做准备。
创建ExitSpan
设置span相关信息,比如请求方法的类型、访问的url等内容
将ContextCarrier对象进行动态传递,传递给第二个插入点增强类
将当前span进行传递,便于后续对响应信息进行判断和设置
具体代码如下(org.apache.skywalking.apm.plugin.spring.webflux.v5.webclient
包下WebFluxWebClientInterceptor类)。
同时,我在后续调试的过程中发现,只定义一个拦截点是不够的,因为request只有在初始化的过程中才能被操作,也就是是说,在该位置违法将span的相关信息放置到request的头文件中,进行跨链传输。
因此我在org.springframework.http.client.reactive.ClientHttpRequest
的构造方法处也设置了一个拦截点,负责讲span信息放置到request中进行跨链传输。
具体实现如下所示:
public void beforeMethod(EnhancedInstance objInst, Method method, Object[] allArguments, Class>[] argumentsTypes, MethodInterceptResult result) throws Throwable { ClientHttpRequest clientHttpRequest = (ClientHttpRequest) allArguments[0]; ContextCarrier contextCarrier = (ContextCarrier) objInst.getSkyWalkingDynamicField(); CarrierItem next = contextCarrier.items(); while (next.hasNext()) { next = next.next(); clientHttpRequest.getHeaders().set(next.getHeadKey(), next.getHeadValue());
编写测试用例
在插件编写完成之后,我们还需要编写一个测试用例用来做CI测试。插件开发的详细文档可以参考戳一下?
此处我就简单说一下用例的编写流程。
用例工程是一个独立的Maven工程。该工程能将工程打包镜像, 并要求提供一个外部能够访问的Web服务用例测试调用链追踪。
用例工程的目录图如下所示:
[plugin_testcase] |__ [config] | |__ docker-compse.yml | |__ expectedData.yaml |__ [src] | |__ [main] | | ... | |__ [resources] | | ... |__ pom.xml |__ testcase.yml[] = directory
文件用途说明
以下是用例工程中配置文件的说明:
文件 | 用途 |
---|---|
docker-compose.xml | 定义用例的docker运行容器环境 |
expectedData.yaml | 定义用例期望生成的Segment的数据 |
testcase.yml | 定义用例的基本信息,如: 被测试框架名称、版本号 |
测试用例编写流程
编写用例代码
打包并测试用例镜像,确保在没有加载探针时的用例镜像能够正常运行
编写期望数据文件
编写用例配置文件
测试用例
4
Pull Request提交前的检查
在正式提交以前一定要保证集成测试在本地通过
更新插件文档
插件文档需要更新:Supported-list.md相关插件信息的支持。
插件如果为可选插件需要在agent-optional-plugins可选插件文档中增加对应的描述。
提交PR
在提交PR时,一定要简要描述个人对插件的设计思路,这样有助于社区贡献者讨论完成codereview。
申请自动化测试
测试用例编写完成后,可以申请自动化测试,了解插件的兼容性等问题
在自动化测试完成之后,会有社区成员进行代码审查,审查通过后,不出意外最终会被合并到主分支上。
5
自己开发中遇到的问题
在搭建开发环境,完成项目的导入工作之后,maven总报错。
解决方法:增加了国内的多个maven源之后该问题被解决
在确定插入点exchange()方法之后,在调试过程中无法被拦截。
解决方法:由于选择的增强类属于内部类,因此在
DefaultExchangeFunction
,因此在选择该类作为内部类的时候应该使用#
进行连接,而不是通过.
。即应该写成org.springframework.web.reactive.function.client.ExchangeFunctions$DefaultExchangeFunction
的形式。在插件基本功能编写完成后,OAP端却无法收集到链路信息。
解决方法:使用最新的OAP收集端程序来进行接收。之前一直使用的本地直接编译的OAP端,发现不能工作,使用编译好的OAP端代码版本过低时也不能使用。
同一服务的两个span不能够串联。
原因分析:经过分析出现该问题的原因主要是关闭span的时机不对。由于使用的是异步接口,因此在关闭span的时候必须在
doFinally()
方法体内进行关闭。防治span提前关闭,从而出现同一服务的span不能串联的情况发成解决方法:修改span的关闭时机,在
doFinally()
方法体中执行span.asyncFinish()
方法在本地跑集成测试时,遇到无法启动docker的问题。
原因分析:根据保存内容发现是测试脚本在启动docker的过程中出现权限不足的问题,可能是docker的使用需要用的root的权限。
解决方法:将当前用户增加到docker的用户组中,从而使得当前的用户具有操作docker的权限。
在集成测试阶段出现SegementNotFoundException问题
原因分析:该问题的出现主要是在对Segment进行验证的过程中,发现Segement丢失的情况发生
解决方法:该问题在经过深入分析之后发现,实际上就是因为在编写插件的时候,插入点选择不充分导致的。
exchange
()这个插入点可以用来收集信息,但却无法用来进行链路信息绑定。因此后续重新设计了插件的插入点,增加了第二个插入点,并且在第二个插入点位置进行链路的绑定,至此问题解决。
开源社简介
开源社是由国内外支持开源的企业,社区及个人,依“贡献,共识,共治”原则,所组织的厂商中立、纯志愿者、非营利的开源联盟,旨在共创健康可持续发展的开源生态体系,并推动中国开源社区成为全球开源软件的积极参与及贡献者。我们专注于开源治理、国际接轨、社区发展和开源项目。
相关阅读 | Related Reading
开源特训营 - Lesson 1 - 开源基础
他们隔空协作,打造出懂医学、知开源的智能机器人
发起 Wuhan 2020,他是高校开源创新首批「吃螃蟹的人」
如何用vbs编写一个游戏_如何编写一个 SkyWalking 插件相关推荐
- 在编写flash游戏播放声音时的一个要注意的地方
在编写flash游戏播放声音时的一个要注意的地方 如果该机子没有装声卡,或是声卡有问题,或操作系统如win 2003 server禁用了声卡,或提示没有活动混音器设备可用 播放声音得不到channel ...
- python编写剪刀石头布游戏_闲着也是闲着:PYTHON 编写剪刀石头布游戏
闲着也是闲着:PYTHON 编写剪刀石头布游戏 突如其来的一场变故,使得这个假期尤为的漫长,特别是不知什么时候终结的假期,尤其的漫长.闲着也是闲着,不如来学习学习Python吧. 我学习新的语言,不喜 ...
- java如何编写windows木马_如何编写可怕的 Java 代码?
原标题:如何编写可怕的 Java 代码? 作者:武培轩 我决定告诉你如何编写可怕的Java代码.如果你厌倦了所有这些美丽的设计模式和最佳实践,并且想写些疯狂的东西,请继续阅读. 如果你正在寻找有关如何 ...
- c语言把一个数组赋值给另一个数组_如何把一个固定数组的值传递给另外一个数组...
大家好,今日我们继续讲解VBA数组与字典解决方案,今日讲解的是第34讲:数组的传递.在应用数组的时候,我们往往需要要把数组的值由一个数组传递给另外一个数组,就如同变量的传递一样: A=B '把B值赋给 ...
- 编写react组件_如何编写第一个React.js组件
编写react组件 React的函数和类组件,道具,状态和事件处理程序 (React's function and class components, props, state, and event ...
- python输入数字是什么类型的游戏_“数字炸弹”——一个练习Python基础知识的小游戏...
数字"炸弹" 数字炸弹小游戏,平时可以多个人一块玩.游戏规则也很简单:从0~100之间选一个数字,作为"炸弹".每人轮流猜,数字的范围不断缩小,直到有人&quo ...
- 用记事本编写小游戏_记事本3分钟编写放置小游戏(v0.4 土豪情趣屋与大型灵石盾构)...
------------------------- v0.4新增问山村的土豪情趣屋(大量生产人口),新增灵石盾构(提升灵石产量)! ------------------------- 说明: 本教程无 ...
- c++飞扬的小鸟游戏_通过建立一个飞扬的鸟游戏来学习从头开始
c++飞扬的小鸟游戏 Learn how to use Scratch 3.0 by building a flappy bird game in this course developed by W ...
- 用记事本编写小游戏_一款适合你的记事本——提高你工作的效率!
本文转至微信公众号HelpToMe 背景 我们常常会因为忘掉一个思路,想法,灵感懊恼不已.常常会因为忘掉一些事情,而重复的去做一些没有意义的事情.俗话说:"好记性不如烂笔头".养成 ...
最新文章
- Spring Boot + EasyExcel 导入导出,好用到爆,可以扔掉 POI 了!
- 微软全球执行副总裁沈向洋:你给自己的定位是什么,你就会得到什么
- Palindrome Index
- linux 运行jupyter,在 Linux 上安装并运行 Jupyter
- Linux创建SSH信任关系
- Web服务器处理Servlet处理请求过程
- 区块链 以太坊 智能合约 如何销毁 废弃 selfdestruct
- matlab官方中文网站
- flink sql运用入门
- 五步搞定Java性能调优(附超全技能图谱)
- css层叠优先级,css优先级和层叠(示例代码)
- Filter vs Listener
- 智慧城市产业热点板块及产业图谱
- 解决github :error: failed to push some refs to 问题
- app软件开发有哪些方式?
- 如何实现超大文件上传?
- 数学:矩估计和最大似然估计
- 微信公众平台使用百度API查询天气预报
- VIVO Xplay_2.13.2 目前最新ViVo官方固件,完美root,降噪点,完美支持官方OTA升级,稳定,流畅,实用ROM
- 爱奇艺 2021秋招在线笔试