ianko/grpc-reflection

elixir graph reflection support

GrpcReflection

GrpcReclection is a grpc server built using grpc-elixir. This server adds grpc reflection support to a grpc-elixir based application.

Installation

If available in Hex, the package can be installed by adding grpc_reflection to your list of dependencies in mix.exs:

def deps do
  [
    {:grpc_reflection, "~> 0.1.0"}
  ]
end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/grpc_reflection.

Reflection

This is written and tested using grpcurl and postman. It supports both v1alpha and v1 reflection by using one or both of the provided servers: rpcReflection.V1.Server or rpcReflection.V1alpha.Server

Enable reflection on your application

1. Rebuild your protos with descriptors on. Each module and/or service that you would like to expose through reflection must use the protoc elixir-out option gen_descriptors=true
2. Create a reflection server

defmodule Helloworld.Reflection.Server do
  use GrpcReflection,
    version: :v1,
    services: [Helloworld.Greeter.Service]
end

or

defmodule Helloworld.Reflection.Server2 do
  use GrpcReflection,
    version: :v1alpha,
    services: [Helloworld.Greeter.Service]
end

or both as desired. version is the grpc reflection spec, which can be v1 or v1alpha. services is the services that will be exposed by that server by reflection. You can expose a service through both services if desired.

1. Add the reflection supervisor to your supervision tree to host the cached reflection state

children = [
  ...other children,
  GrpcReflection
]

1. Add your servers to your grpc endpoint

interacting with your reflection server

Here are some example grpcurl commands and responses excersizing the reflection capabilities

$ grpcurl -v -plaintext 127.0.0.1:50051 list
grpc.reflection.v1.ServerReflection
helloworld.Greeter

$ grpcurl -v -plaintext 127.0.0.1:50051 list helloworld.Greeter
helloworld.Greeter.SayHello

$ grpcurl -v -plaintext 127.0.0.1:50051 describe helloworld.Greeter.SayHello
helloworld.Greeter.SayHello is a method:
rpc SayHello ( .helloworld.HelloRequest ) returns ( .helloworld.HelloReply );

$ grpcurl -v -plaintext 127.0.0.1:50051 describe .helloworld.HelloReply
helloworld.HelloReply is a message:
message HelloReply {
  optional string message = 1;
  optional .google.protobuf.Timestamp today = 2;
}

Protobuf Version Support

This utility currently only supports proto3. It does not support some of the features of proto2, including extensions.

Application Support

This is not an exhaustive list

Application	Reflection version required
grpcurl	V1
postman	V1alpha