X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=proto%2Fcollectd.proto;h=c706ea11305875022a98e82cd1ba0b231c2ccfcd;hb=75d4c13daf6c1226710b64ff3a793afa31721b81;hp=608fcbb1657e1476d5ca705e18b8c43abe1c54af;hpb=290741f2e6de9e9b467463c1f0c6f031c4036428;p=collectd.git diff --git a/proto/collectd.proto b/proto/collectd.proto index 608fcbb1..c706ea11 100644 --- a/proto/collectd.proto +++ b/proto/collectd.proto @@ -25,36 +25,38 @@ syntax = "proto3"; package collectd; +option go_package = "collectd.org/rpc/proto"; import "types.proto"; -import "google/protobuf/timestamp.proto"; service Collectd { - // Dispatch collected values to collectd. - rpc DispatchValues(DispatchValuesRequest) returns (DispatchValuesReply); - - // Query a list of values available from collectd's value cache. - rpc QueryValues(QueryValuesRequest) returns (QueryValuesReply); + // DispatchValues reads the value lists from the DispatchValuesRequest stream. + // The gRPC server embedded into collectd will inject them into the system + // just like the network plugin. + rpc DispatchValues(stream DispatchValuesRequest) + returns(DispatchValuesResponse); + + // QueryValues returns a stream of matching value lists from collectd's + // internal cache. + rpc QueryValues(QueryValuesRequest) returns(stream QueryValuesResponse); } // The arguments to DispatchValues. message DispatchValuesRequest { - collectd.types.ValueList values = 1; + // value_list is the metric to be sent to the server. + collectd.types.ValueList value_list = 1; } // The response from DispatchValues. -message DispatchValuesReply { -} +message DispatchValuesResponse {} // The arguments to QueryValues. message QueryValuesRequest { - // Query by the fields of the identifier. Only return values matching the - // specified shell wildcard patterns (see fnmatch(3)). Use '*' to match - // any value. - collectd.types.Identifier identifier = 1; + // Query by the fields of the identifier. Only return values matching the + // specified shell wildcard patterns (see fnmatch(3)). Use '*' to match + // any value. + collectd.types.Identifier identifier = 1; } // The response from QueryValues. -message QueryValuesReply { - repeated collectd.types.ValueList values = 1; -} +message QueryValuesResponse { collectd.types.ValueList value_list = 1; }