Skip to content

This repository contains all needed protocol definitions (e.x. protobuf)

License

Notifications You must be signed in to change notification settings

go-graphite/protocol

Repository files navigation

go-graphite/protocol

This repository contains protocol definitions for go-graphite services

  • zipper-* - protocols used for reading path
    • carbonapi_v3_pb - new protobuf3-based protocol that's used as a base for gRPC communcation Status: STABLE
    • carbonapi_v2_pb - current production protobuf3-based protocol. Status: STABLE

Historical proto releases (deprecated and removed after v1.0.0 release):

  • carbonapi_v3_grpc - gRPC service definitions for new zipper protocol. Was never used in any known system, might need a redisign if carbonapi or something else will implement gRPC support.
  • carbonapi_v1_pb - protobuf2 protocol, used in carbonzipper 0.6x or earlier. Carbonapi no longer supports that protocol.

Generating Go from *.proto files

We use planetscale/vtprotobuf generator.

To install required generators please use:

$ go install github.com/planetscale/vtprotobuf/cmd/[email protected]

Then generate Go files with:

$ go generate carbonapi_v2_pb/gen.go
$ go generate carbonapi_v3_pb/gen.go