grpc-swift/Examples/Datastore/google/monitoring/v3/agent_service.proto

// Copyright 2016 Google Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

syntax = "proto3";

package google.monitoring.v3;

import "google/api/annotations.proto";
import "google/api/monitored_resource.proto";
import "google/monitoring/v3/agent.proto";
import "google/protobuf/empty.proto";

option java_multiple_files = true;
option java_outer_classname = "AgentServiceProto";
option java_package = "com.google.monitoring.v3";


// The AgentTranslation API allows `collectd`-based agents to
// write time series data to Cloud Monitoring.
// See [google.monitoring.v3.MetricService.CreateTimeSeries] instead.
service AgentTranslationService {
  // **Stackdriver Monitoring Agent only:** Creates a new time series.
  //
  // <aside class="caution">This method is only for use by the Google Monitoring Agent.
  // Use [projects.timeSeries.create][google.monitoring.v3.MetricService.CreateTimeSeries]
  // instead.</aside>
  rpc CreateCollectdTimeSeries(CreateCollectdTimeSeriesRequest) returns (google.protobuf.Empty) {
    option (google.api.http) = { post: "/v3/{name=projects/*}/collectdTimeSeries", body: "*" };
  }
}

// The `CreateCollectdTimeSeries` request.
message CreateCollectdTimeSeriesRequest {
  // The project in which to create the time series. The format is
  // `"projects/PROJECT_ID_OR_NUMBER"`.
  string name = 5;

  // The monitored resource associated with the time series.
  google.api.MonitoredResource resource = 2;

  // The version of `collectd` that collected the data. Example: `"5.3.0-192.el6"`.
  string collectd_version = 3;

  // The `collectd` payloads representing the time series data.
  // You must not include more than a single point for each
  // time series, so no two payloads can have the same values
  // for all of the fields `plugin`, `plugin_instance`, `type`, and `type_instance`.
  repeated CollectdPayload collectd_payloads = 4;
}