https://github.com/rmedvedev/grpcdump

Tool for capture and parse grpc traffic
https://github.com/rmedvedev/grpcdump

golang grpc protobuf sniffer tcpdump

Last synced: 3 months ago
JSON representation

Tool for capture and parse grpc traffic

• Host: GitHub
• URL: https://github.com/rmedvedev/grpcdump
• Owner: rmedvedev
• License: mit
• Created: 2020-01-19T17:13:51.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-06-25T14:13:23.000Z (over 2 years ago)
• Last Synced: 2024-08-04T04:06:19.837Z (6 months ago)
• Topics: golang, grpc, protobuf, sniffer, tcpdump
• Language: Go
• Homepage:
• Size: 464 KB
• Stars: 149
• Watchers: 2
• Forks: 22
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-grpc - grpcdump - Tool for capture and decode GRPC messages from ethernet traffic only for Linux (Tools / Testing)

README

        
# GRPCDump

Tool for capture and decode GRPC messages from ethernet traffic

**Warning: Works only on Linux!**

[![Build Status](https://travis-ci.com/rmedvedev/grpcdump.svg?branch=master)](https://travis-ci.com/rmedvedev/grpcdump) [![Go Report Card](https://goreportcard.com/badge/github.com/rmedvedev/grpcdump)](https://goreportcard.com/report/github.com/rmedvedev/grpcdump) [![codecov](https://codecov.io/gh/rmedvedev/grpcdump/branch/master/graph/badge.svg)](https://codecov.io/gh/rmedvedev/grpcdump)

## Demo

![gif](docs/demo.gif)

## Installation / Getting started

Installation is supported only on Linux and does not require additional dependencies such as libpcap-dev

```bash

go run cmd/grpcdump/main.go

```

### From Source

```bash

go get -u github.com/rmedvedev/grpcdump/...

cp $(go env GOPATH)/bin/grpcdump /usr/local/bin

grpcdump 

```

## Usage 

The next option explains usage doc

```bash

grpcdump -help

```

For example, to capture grpc traffic, parse grpc request and response you need to use this command:

```bash

grpcdump -i lo -p 50051 -proto-path ./grpc/protofiles -proto-files helloworld.proto 

```