X-Git-Url: https://git.octo.it/?p=collectd.git;a=blobdiff_plain;f=proto%2Fcollectd.proto;h=83d21282963bdc5b3dc1fee356062e9fad0e5b0c;hp=ba60793b66f1e1e564c1a23918f828fa2c72f050;hb=48efd3deb4c9139fd060ff3d289896e9031bcc7c;hpb=1bdd4bf92c0e54efe40b372cf738527d04f90152 diff --git a/proto/collectd.proto b/proto/collectd.proto index ba60793b..83d21282 100644 --- a/proto/collectd.proto +++ b/proto/collectd.proto @@ -1,5 +1,5 @@ // collectd - proto/collectd.proto -// Copyright (C) 2015 Sebastian Harl +// Copyright (C) 2015-2016 Sebastian Harl // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), @@ -25,37 +25,37 @@ 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); - - // Retrieve a list of all values available in collectd's value cache. - rpc ListValues(ListValuesRequest) returns (ListValuesReply); + // 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 values = 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 DispatchValuesReply { -} +// The response from PutValues. +message PutValuesResponse {} -// The arguments to ListValues. -message ListValuesRequest { +// 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; } -// The response from ListValues. -message ListValuesReply { - message Value { - string name = 1; - google.protobuf.Timestamp time = 2; - } - - repeated Value value = 1; -} +// The response from QueryValues. +message QueryValuesResponse { collectd.types.ValueList value_list = 1; }