超实用的 gRPC 客户端调试工具

时间:2021-09-05 04:11:00

超实用的 gRPC 客户端调试工具

介绍

正好看到董泽润老哥一篇关于使用WireShark分析gRPC流量的文章,学到了。原文地址:小技巧!Wireshark 让调试 grpc 不再困难

那我就介绍使用过的两款gRPC客户端调试工具吧。

Evans

Evans[1]有两种运行模式:REPL和CLI。

比起其他gRPC客户端,Evans更具有表现力,并且它还支持自动补全功能。

Evans的安装非常方便,在Mac上我们只需要执行以下两行命令即可。

超实用的 gRPC 客户端调试工具

我们来学习一下REPL模式。

首先我们需要有一个pb文件,假设你的文件在api/api.proto,我们只需要这样:

超实用的 gRPC 客户端调试工具

默认地址为127.0.0.1:50051,当然你可以通过--host和--port来指定服务器。

超实用的 gRPC 客户端调试工具

上图的命令:

  • show package读取pb包名,
  • show service显示对应服务列表。
  • call xxx调用gRPC服务......
  • .....

更多命令可自行查阅官网。

除了上述这种直接引入pb文件外,我们还可以通过gRPC反射包(reflection), 将grpc.Server注册到反射服务中。

这样的话,就可以通过reflection提供的反射服务查询到对应的gRPC服务,或者直接调用gRPC服务。

注册反射服务操作也很简单,

超实用的 gRPC 客户端调试工具

回到Evans工具, 如果一个gRPC服务注册了反射,我们就可以使用-r选项来启动Evans。

比如像下面这样:

超实用的 gRPC 客户端调试工具

对另外一种模式感兴趣的可以自行查看官网,这里不再演示。

BloomRPC

BloomRPC[2]是一个简单的GUI客户端工具,使用这个那就更简单了。

只需要导入pb文件,然后点两下即可。

超实用的 gRPC 客户端调试工具

当然有个不好点在于,每次修改了pb,都不得不重新导入。

总结

以上介绍了两款gRPC客户端工具。不知道你们平常都使用gRPC哪些周边工具,欢迎一起讨论。

附录

[1]https://github.com/ktr0731/evans

[2]https://github.com/uw-labs/bloomrpc

原文链接:https://mp.weixin.qq.com/s/Xqbq3lzW1MgSPGMp5oM8Ng