diff --git a/proto/collectd.proto b/proto/collectd.proto
index 24aa52b7d1039416e8f967d1e68970eb3dfb553b..917c5deb679985dd90388176f7e9449569e3ef37 100644 (file)
--- a/proto/collectd.proto
+++ b/proto/collectd.proto
syntax = "proto3";
package collectd;
+option go_package = "collectd.org/rpc/proto";
import "types.proto";
service Collectd {
- // Query a list of values available from collectd's value cache.
- rpc QueryValues(QueryValuesRequest) returns (stream QueryValuesResponse);
-}
-
-service Dispatch {
- // DispatchValues sends a stream of ValueLists to the server.
- rpc DispatchValues(stream DispatchValuesRequest) returns (DispatchValuesResponse);
+ // 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 value_list = 1;
+ // value_list is the metric to be sent to the server.
+ collectd.types.ValueList value_list = 1;
}
// The response from DispatchValues.
-message DispatchValuesResponse {
-}
+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 QueryValuesResponse {
- collectd.types.ValueList value_list = 1;
-}
+message QueryValuesResponse { collectd.types.ValueList value_list = 1; }