介绍
正好看到董泽润老哥一篇关于使用WireShark分析gRPC流量的文章,学到了。原文地址:小技巧!Wireshark 让调试 grpc 不再困难
那我就介绍使用过的两款gRPC客户端调试工具吧。
Evans
Evans[1]有两种运行模式:REPL和CLI。
比起其他gRPC客户端,Evans更具有表现力,并且它还支持自动补全功能。
Evans的安装非常方便,在Mac上我们只需要执行以下两行命令即可。
我们来学习一下REPL模式。
首先我们需要有一个pb文件,假设你的文件在api/api.proto,我们只需要这样:
默认地址为127.0.0.1:50051,当然你可以通过--host和--port来指定服务器。
上图的命令:
- show package读取pb包名,
- show service显示对应服务列表。
- call xxx调用gRPC服务......
- .....
更多命令可自行查阅官网。
除了上述这种直接引入pb文件外,我们还可以通过gRPC反射包(reflection), 将grpc.Server注册到反射服务中。
这样的话,就可以通过reflection提供的反射服务查询到对应的gRPC服务,或者直接调用gRPC服务。
注册反射服务操作也很简单,
回到Evans工具, 如果一个gRPC服务注册了反射,我们就可以使用-r选项来启动Evans。
比如像下面这样:
对另外一种模式感兴趣的可以自行查看官网,这里不再演示。
BloomRPC
BloomRPC[2]是一个简单的GUI客户端工具,使用这个那就更简单了。
只需要导入pb文件,然后点两下即可。
当然有个不好点在于,每次修改了pb,都不得不重新导入。
总结
以上介绍了两款gRPC客户端工具。不知道你们平常都使用gRPC哪些周边工具,欢迎一起讨论。
附录
[1]https://github.com/ktr0731/evans
[2]https://github.com/uw-labs/bloomrpc