aboutsummaryrefslogtreecommitdiff
path: root/google/devtools/cloudtrace/v2/tracing.proto
diff options
context:
space:
mode:
Diffstat (limited to 'google/devtools/cloudtrace/v2/tracing.proto')
-rw-r--r--google/devtools/cloudtrace/v2/tracing.proto64
1 files changed, 64 insertions, 0 deletions
diff --git a/google/devtools/cloudtrace/v2/tracing.proto b/google/devtools/cloudtrace/v2/tracing.proto
new file mode 100644
index 000000000..2990d4606
--- /dev/null
+++ b/google/devtools/cloudtrace/v2/tracing.proto
@@ -0,0 +1,64 @@
+// Copyright 2017 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.devtools.cloudtrace.v2;
+
+import "google/api/annotations.proto";
+import "google/devtools/cloudtrace/v2/trace.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Trace.V2";
+option go_package = "google.golang.org/genproto/googleapis/devtools/cloudtrace/v2;cloudtrace";
+option java_multiple_files = true;
+option java_outer_classname = "TracingProto";
+option java_package = "com.google.devtools.cloudtrace.v2";
+option php_namespace = "Google\\Cloud\\Trace\\V2";
+
+// This file describes an API for collecting and viewing traces and spans
+// within a trace. A Trace is a collection of spans corresponding to a single
+// operation or set of operations for an application. A span is an individual
+// timed event which forms a node of the trace tree. A single trace may
+// contain span(s) from multiple services.
+service TraceService {
+ // Sends new spans to new or existing traces. You cannot update
+ // existing spans.
+ rpc BatchWriteSpans(BatchWriteSpansRequest) returns (google.protobuf.Empty) {
+ option (google.api.http) = {
+ post: "/v2/{name=projects/*}/traces:batchWrite"
+ body: "*"
+ };
+ }
+
+ // Creates a new span.
+ rpc CreateSpan(Span) returns (Span) {
+ option (google.api.http) = {
+ post: "/v2/{name=projects/*/traces/*}/spans"
+ body: "*"
+ };
+ }
+}
+
+// The request message for the `BatchWriteSpans` method.
+message BatchWriteSpansRequest {
+ // Required. The name of the project where the spans belong. The format is
+ // `projects/[PROJECT_ID]`.
+ string name = 1;
+
+ // A list of new spans. The span names must not match existing
+ // spans, or the results are undefined.
+ repeated Span spans = 2;
+}