Merge pull request #3329 from efuss/fix-3311
[collectd.git] / proto / collectd.proto
index 37df5b6..83d2128 100644 (file)
@@ -30,19 +30,24 @@ 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);
-
-  // DispatchValues sends a stream of ValueLists to the server.
-  rpc DispatchValues(stream DispatchValuesRequest)
-      returns (DispatchValuesResponse);
+  // PutValues reads the value lists from the PutValuesRequest stream.
+  // The gRPC server embedded into collectd will inject them into the system
+  // just like the network plugin.
+  rpc PutValues(stream PutValuesRequest) returns(PutValuesResponse);
+
+  // 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; }
+// The arguments to PutValues.
+message PutValuesRequest {
+  // value_list is the metric to be sent to the server.
+  collectd.types.ValueList value_list = 1;
+}
 
-// The response from DispatchValues.
-message DispatchValuesResponse {}
+// The response from PutValues.
+message PutValuesResponse {}
 
 // The arguments to QueryValues.
 message QueryValuesRequest {