grpcdebug工具对接gRPC-Java服务端报错问题咨询

• 环境：运行非安全的gRPC-Java服务端（监听localhost:50051）及客户端，已从源码编译安装Go语言开发的grpcdebug工具
• 执行命令及报错：
  1. 执行grpcdebug localhost:50051 health，返回<Overall>: SERVICE_UNKNOWN
  2. 执行grpcdebug localhost:50051 channelz channels，返回2024/04/19 17:07:22 failed to fetch top channels: rpc error: code = Unimplemented desc = Method not found: grpc.channelz.v1.Channelz/GetTopChannels

1. 是否需要对服务端（如添加服务）和客户端做代码修改？是否必须实现channelz相关方法（原以为grpcdebug工具会处理）？
2. 该工具基于Go语言，是否与Java服务端客户端不兼容？这是报错的原因吗？
3. 有没有针对gRPC-Java应用运行grpcdebug工具的文档，或是适用于gRPC-Java的内部工具？

问题1 #

• 服务端需要做修改：
  • 健康检查：gRPC的健康检查服务并非默认内置，无论用什么语言实现服务端，都需要显式注册Health服务，才能被grpcdebug的health命令检测到。
  • Channelz：grpc.channelz.v1.Channelz服务同样需要服务端主动注册实现，grpcdebug只是调用该标准服务的客户端工具，不会自动帮服务端完成方法实现。如果仅用grpcdebug查看服务端的channelz信息，客户端无需修改；若要监控客户端自身的channelz数据，则需开启客户端的channelz配置。

问题2 #

• 不存在Go工具与Java服务端的兼容性问题：gRPC是跨语言的标准框架，只要服务端实现了对应的标准服务（如Health、Channelz），任何语言开发的客户端工具都能正常调用。报错的核心原因是Java服务端未注册这些标准服务，和工具的开发语言无关。

问题3 #

• 针对gRPC-Java使用grpcdebug的文档：可参考gRPC官方Java文档中关于Health检查和Channelz的注册配置部分，按标准方式完成服务注册后，即可正常使用grpcdebug工具。
• gRPC-Java的内部调试工具：
  • 内置Channelz支持：gRPC-Java从1.20版本开始支持Channelz，仅需在服务端启动时开启Channelz服务注册即可。
  • 健康检查实现：gRPC-Java提供HealthStatusManager类，可快速完成Health服务的注册。
  • 替代工具：还可使用grpcurl（同样基于Go开发）调用这些标准服务，用法与grpcdebug类似，同样支持跨语言调用。

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