SkyWalking Agent 8.13.0不支持高版本Java gRPC追踪上报咨询

问题背景 #

使用SkyWalking Agent 8.13.0时，发现Java gRPC 1.43.2或1.51.0版本无法上报追踪Span，但1.29.0版本可正常上报。测试环境为官方Java gRPC示例项目HelloworldServer和HelloWorldClient，调用SayHello接口后在SkyWalking页面无法看到追踪结果。

查看Agent源码发现NettyClientStreamInstrumentation类的注释提到：

/**

• Intercept constructor to obtain server IP.
• grpc Low version(eg:1.6.0): use io.grpc.netty.NettyClientStream.
• grpc High version(eg:1.33.1): use io.grpc.netty.shaded.io.grpc.netty.NettyClientStream.
  */

针对该场景的三个问题解答如下：

1. 上述代码是否限制了gRPC的追踪上报？ #

是的，这段适配逻辑可能导致高版本gRPC无法正常上报追踪。
gRPC从1.33.x版本开始将Netty相关类迁移到io.grpc.netty.shaded包下，NettyClientStreamInstrumentation的设计仅适配了这一版本的包结构变化，但1.43.2、1.51.0等更高版本的gRPC可能在NettyClientStream的构造逻辑、类依赖或包结构上又有变更，导致Agent的增强代码无法拦截到目标类/方法，最终无法生成和上报Span。

2. 已测试支持哪些Java gRPC版本？ #

SkyWalking Agent 8.13.0官方测试覆盖的Java gRPC版本包括：

• 低版本：1.6.0及同系列非shaded包版本
• 过渡版本：1.33.x系列shaded包版本
  此外社区实际验证的还包括1.2x系列（如你测试的1.29.0），但1.40+以上的高版本未被纳入官方测试支持范围，存在适配缺失问题。

3. 如何确认Agent是否上报追踪Span？ #

可以通过以下几种方式验证：

• 查看Agent日志：修改agent/config/agent.config中的logging.level为debug，启动应用后搜索日志中的Span、trace关键词，检查是否有Span生成的记录，以及是否有向OAP服务上报数据的请求日志。
• 调试增强逻辑：若能获取Agent源码，在NettyClientStreamInstrumentation的增强方法中添加日志或断点，确认目标类的构造方法是否被Agent拦截执行。
• 抓包验证：用网络抓包工具捕获Agent与OAP服务器之间的通信，检查是否包含trace数据的上报请求（通常是gRPC或HTTP请求）。
• 查看OAP日志：在OAP服务器的日志中搜索是否接收到该Agent发送的trace数据。

内容的提问来源于stack exchange，提问作者LoranceChen