gRPC Reference

MuninnDB exposes a gRPC interface on port 8748. The Protobuf definitions are in proto/muninn.proto in the repository.

Note: For most Go applications, use the Go SDK which connects via MBP (binary protocol) by default. gRPC is recommended for polyglot teams or when standardizing on gRPC infrastructure.

Service Definition

proto/muninn.proto (abbreviated)

syntax = "proto3";
package muninn.v1;

service MuninnService {"
  rpc Store(StoreRequest) returns (StoreResponse);
  rpc Activate(ActivateRequest) returns (ActivateResponse);
  rpc Get(GetRequest) returns (GetResponse);
  rpc Update(UpdateRequest) returns (UpdateResponse);
  rpc Archive(ArchiveRequest) returns (ArchiveResponse);
  rpc List(ListRequest) returns (ListResponse);
  rpc Search(SearchRequest) returns (SearchResponse);
  rpc Subscribe(SubscribeRequest) returns (stream TriggerEvent);
  rpc Health(HealthRequest) returns (HealthResponse);
  rpc Stats(StatsRequest) returns (StatsResponse);
}

Generate client code from the proto file:

bash — Generate Python client

python -m grpc_tools.protoc \
  -I proto \
  --python_out=. \
  --grpc_python_out=. \
  proto/muninn.proto

For the full proto file, see proto/muninn.proto on GitHub →