A trace is a collection of spans corresponding to a single operation or a set of operations in + * an application. + * + *
A span is an individual timed event which forms a node of the trace tree. A single trace can + * contain spans from multiple services. * *
This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: @@ -172,7 +175,7 @@ public TraceServiceStub getStub() { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Sends new spans to new or existing traces. You cannot update existing spans. + * Batch writes new spans to new or existing traces. You cannot update existing spans. * *
Sample code:
*
@@ -191,8 +194,8 @@ public TraceServiceStub getStub() {
*
* @param name Required. The name of the project where the spans belong. The format is
* `projects/[PROJECT_ID]`.
- * @param spans Required. A list of new spans. The span names must not match existing spans, or
- * the results are undefined.
+ * @param spans Required. A list of new spans. The span names must not match existing spans,
+ * otherwise the results are undefined.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final void batchWriteSpans(ProjectName name, List spans) {
@@ -206,7 +209,7 @@ public final void batchWriteSpans(ProjectName name, List spans) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Sends new spans to new or existing traces. You cannot update existing spans.
+ * Batch writes new spans to new or existing traces. You cannot update existing spans.
*
* Sample code:
*
@@ -225,8 +228,8 @@ public final void batchWriteSpans(ProjectName name, List spans) {
*
* @param name Required. The name of the project where the spans belong. The format is
* `projects/[PROJECT_ID]`.
- * @param spans Required. A list of new spans. The span names must not match existing spans, or
- * the results are undefined.
+ * @param spans Required. A list of new spans. The span names must not match existing spans,
+ * otherwise the results are undefined.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final void batchWriteSpans(String name, List spans) {
@@ -237,7 +240,7 @@ public final void batchWriteSpans(String name, List spans) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Sends new spans to new or existing traces. You cannot update existing spans.
+ * Batch writes new spans to new or existing traces. You cannot update existing spans.
*
* Sample code:
*
@@ -266,7 +269,7 @@ public final void batchWriteSpans(BatchWriteSpansRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Sends new spans to new or existing traces. You cannot update existing spans.
+ * Batch writes new spans to new or existing traces. You cannot update existing spans.
*
* Sample code:
*
diff --git a/java-trace/google-cloud-trace/src/main/java/com/google/cloud/trace/v2/package-info.java b/java-trace/google-cloud-trace/src/main/java/com/google/cloud/trace/v2/package-info.java
index 520764c2b90d..162582daf543 100644
--- a/java-trace/google-cloud-trace/src/main/java/com/google/cloud/trace/v2/package-info.java
+++ b/java-trace/google-cloud-trace/src/main/java/com/google/cloud/trace/v2/package-info.java
@@ -15,14 +15,19 @@
*/
/**
- * The interfaces provided are listed below, along with usage samples.
+ * A client to Stackdriver Trace API
+ *
+ * The interfaces provided are listed below, along with usage samples.
*
* ======================= TraceServiceClient =======================
*
- * Service Description: 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 Description: Service for collecting and viewing traces and spans within a trace.
+ *
+ * A trace is a collection of spans corresponding to a single operation or a set of operations in
+ * an application.
+ *
+ * A span is an individual timed event which forms a node of the trace tree. A single trace can
+ * contain spans from multiple services.
*
* Sample for TraceServiceClient:
*
diff --git a/java-trace/google-cloud-trace/src/main/java/com/google/cloud/trace/v2/stub/TraceServiceStubSettings.java b/java-trace/google-cloud-trace/src/main/java/com/google/cloud/trace/v2/stub/TraceServiceStubSettings.java
index bcedafd8be10..d85874d219e0 100644
--- a/java-trace/google-cloud-trace/src/main/java/com/google/cloud/trace/v2/stub/TraceServiceStubSettings.java
+++ b/java-trace/google-cloud-trace/src/main/java/com/google/cloud/trace/v2/stub/TraceServiceStubSettings.java
@@ -227,7 +227,10 @@ public static class Builder extends StubSettings.Builder
- * 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 for collecting and viewing traces and spans within a trace.
+ * A trace is a collection of spans corresponding to a single
+ * operation or a set of operations in an application.
+ * A span is an individual timed event which forms a node of the trace tree.
+ * A single trace can contain spans from multiple services.
*
*/
public abstract static class TraceServiceImplBase implements io.grpc.BindableService {
@@ -181,7 +181,7 @@ public abstract static class TraceServiceImplBase implements io.grpc.BindableSer
*
*
*
- * Sends new spans to new or existing traces. You cannot update
+ * Batch writes new spans to new or existing traces. You cannot update
* existing spans.
*
*/
@@ -228,11 +228,11 @@ public final io.grpc.ServerServiceDefinition bindService() {
*
*
*
- * 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 for collecting and viewing traces and spans within a trace.
+ * A trace is a collection of spans corresponding to a single
+ * operation or a set of operations in an application.
+ * A span is an individual timed event which forms a node of the trace tree.
+ * A single trace can contain spans from multiple services.
*
*/
public static final class TraceServiceStub
@@ -250,7 +250,7 @@ protected TraceServiceStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
*
*
*
- * Sends new spans to new or existing traces. You cannot update
+ * Batch writes new spans to new or existing traces. You cannot update
* existing spans.
*
*/
@@ -282,11 +282,11 @@ public void createSpan(
*
*
*
- * 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 for collecting and viewing traces and spans within a trace.
+ * A trace is a collection of spans corresponding to a single
+ * operation or a set of operations in an application.
+ * A span is an individual timed event which forms a node of the trace tree.
+ * A single trace can contain spans from multiple services.
*
*/
public static final class TraceServiceBlockingStub
@@ -305,7 +305,7 @@ protected TraceServiceBlockingStub build(
*
*
*
- * Sends new spans to new or existing traces. You cannot update
+ * Batch writes new spans to new or existing traces. You cannot update
* existing spans.
*
*/
@@ -333,11 +333,11 @@ public com.google.devtools.cloudtrace.v2.Span createSpan(
*
*
*
- * 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 for collecting and viewing traces and spans within a trace.
+ * A trace is a collection of spans corresponding to a single
+ * operation or a set of operations in an application.
+ * A span is an individual timed event which forms a node of the trace tree.
+ * A single trace can contain spans from multiple services.
*
*/
public static final class TraceServiceFutureStub
@@ -356,7 +356,7 @@ protected TraceServiceFutureStub build(
*
*
*
- * Sends new spans to new or existing traces. You cannot update
+ * Batch writes new spans to new or existing traces. You cannot update
* existing spans.
*
*/
diff --git a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/AttributeValue.java b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/AttributeValue.java
index 6b5f572ab1cf..bf90d9071bba 100644
--- a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/AttributeValue.java
+++ b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/AttributeValue.java
@@ -22,7 +22,7 @@
*
*
*
- * The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
+ * The allowed types for `[VALUE]` in a `[KEY]:[VALUE]` attribute.
*
*
* Protobuf type {@code google.devtools.cloudtrace.v2.AttributeValue}
@@ -444,7 +444,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
+ * The allowed types for `[VALUE]` in a `[KEY]:[VALUE]` attribute.
*
*
* Protobuf type {@code google.devtools.cloudtrace.v2.AttributeValue}
diff --git a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/BatchWriteSpansRequest.java b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/BatchWriteSpansRequest.java
index 7712c7084200..459fd898d602 100644
--- a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/BatchWriteSpansRequest.java
+++ b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/BatchWriteSpansRequest.java
@@ -134,7 +134,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -150,7 +150,7 @@ public java.util.List
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -167,7 +167,7 @@ public java.util.List
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -183,7 +183,7 @@ public int getSpansCount() {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -199,7 +199,7 @@ public com.google.devtools.cloudtrace.v2.Span getSpans(int index) {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -768,7 +768,7 @@ private void ensureSpansIsMutable() {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -787,7 +787,7 @@ public java.util.List
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -806,7 +806,7 @@ public int getSpansCount() {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -825,7 +825,7 @@ public com.google.devtools.cloudtrace.v2.Span getSpans(int index) {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -850,7 +850,7 @@ public Builder setSpans(int index, com.google.devtools.cloudtrace.v2.Span value)
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -873,7 +873,7 @@ public Builder setSpans(
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -898,7 +898,7 @@ public Builder addSpans(com.google.devtools.cloudtrace.v2.Span value) {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -923,7 +923,7 @@ public Builder addSpans(int index, com.google.devtools.cloudtrace.v2.Span value)
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -945,7 +945,7 @@ public Builder addSpans(com.google.devtools.cloudtrace.v2.Span.Builder builderFo
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -968,7 +968,7 @@ public Builder addSpans(
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -991,7 +991,7 @@ public Builder addAllSpans(
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -1013,7 +1013,7 @@ public Builder clearSpans() {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -1035,7 +1035,7 @@ public Builder removeSpans(int index) {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -1050,7 +1050,7 @@ public com.google.devtools.cloudtrace.v2.Span.Builder getSpansBuilder(int index)
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -1069,7 +1069,7 @@ public com.google.devtools.cloudtrace.v2.SpanOrBuilder getSpansOrBuilder(int ind
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -1089,7 +1089,7 @@ public com.google.devtools.cloudtrace.v2.SpanOrBuilder getSpansOrBuilder(int ind
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -1105,7 +1105,7 @@ public com.google.devtools.cloudtrace.v2.Span.Builder addSpansBuilder() {
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -1121,7 +1121,7 @@ public com.google.devtools.cloudtrace.v2.Span.Builder addSpansBuilder(int index)
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
diff --git a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/BatchWriteSpansRequestOrBuilder.java b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/BatchWriteSpansRequestOrBuilder.java
index 4b2627c562d1..95123debfe29 100644
--- a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/BatchWriteSpansRequestOrBuilder.java
+++ b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/BatchWriteSpansRequestOrBuilder.java
@@ -59,7 +59,7 @@ public interface BatchWriteSpansRequestOrBuilder
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -72,7 +72,7 @@ public interface BatchWriteSpansRequestOrBuilder
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -85,7 +85,7 @@ public interface BatchWriteSpansRequestOrBuilder
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -98,7 +98,7 @@ public interface BatchWriteSpansRequestOrBuilder
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
@@ -111,7 +111,7 @@ public interface BatchWriteSpansRequestOrBuilder
*
*
* Required. A list of new spans. The span names must not match existing
- * spans, or the results are undefined.
+ * spans, otherwise the results are undefined.
*
*
*
diff --git a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/Span.java b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/Span.java
index 15c9eaea8281..059d98f3cd89 100644
--- a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/Span.java
+++ b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/Span.java
@@ -25,8 +25,9 @@
* A span represents a single operation within a trace. Spans can be
* nested to form a trace tree. Often, a trace contains a root span
* that describes the end-to-end latency, and one or more subspans for
- * its sub-operations. A trace can also contain multiple root spans,
- * or none at all. Spans do not need to be contiguous—there may be
+ * its sub-operations.
+ * A trace can also contain multiple root spans, or none at all.
+ * Spans do not need to be contiguous. There might be
* gaps or overlaps between spans in a trace.
*
*
@@ -326,9 +327,9 @@ public interface AttributesOrBuilder
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -342,9 +343,9 @@ public interface AttributesOrBuilder
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -362,9 +363,9 @@ public interface AttributesOrBuilder
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -379,9 +380,9 @@ public interface AttributesOrBuilder
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -399,9 +400,9 @@ com.google.devtools.cloudtrace.v2.AttributeValue getAttributeMapOrDefault(
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -431,7 +432,7 @@ com.google.devtools.cloudtrace.v2.AttributeValue getAttributeMapOrDefault(
*
*
*
- * A set of attributes, each in the format `[KEY]:[VALUE]`.
+ * A set of attributes as key-value pairs.
*
*
* Protobuf type {@code google.devtools.cloudtrace.v2.Span.Attributes}
@@ -524,9 +525,9 @@ public int getAttributeMapCount() {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -553,9 +554,9 @@ public boolean containsAttributeMap(java.lang.String key) {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -573,9 +574,9 @@ public boolean containsAttributeMap(java.lang.String key) {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -600,9 +601,9 @@ public boolean containsAttributeMap(java.lang.String key) {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -828,7 +829,7 @@ protected Builder newBuilderForType(
*
*
*
- * A set of attributes, each in the format `[KEY]:[VALUE]`.
+ * A set of attributes as key-value pairs.
*
*
* Protobuf type {@code google.devtools.cloudtrace.v2.Span.Attributes}
@@ -1085,9 +1086,9 @@ public int getAttributeMapCount() {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -1114,9 +1115,9 @@ public boolean containsAttributeMap(java.lang.String key) {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -1134,9 +1135,9 @@ public boolean containsAttributeMap(java.lang.String key) {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -1162,9 +1163,9 @@ public boolean containsAttributeMap(java.lang.String key) {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -1196,9 +1197,9 @@ public Builder clearAttributeMap() {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -1225,9 +1226,9 @@ public Builder removeAttributeMap(java.lang.String key) {
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -1252,9 +1253,9 @@ public Builder putAttributeMap(
*
*
*
- * The set of attributes. Each attribute's key can be up to 128 bytes
+ * A set of attributes. Each attribute's key can be up to 128 bytes
* long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- * or the Boolean values `true` and `false`. For example:
+ * or the boolean values `true` or `false`. For example:
* "/instance_id": { "string_value": { "value": "my-instance" } }
* "/http/request_bytes": { "int_value": 300 }
* "abc.com/myattribute": { "bool_value": false }
@@ -2673,8 +2674,7 @@ public interface MessageEventOrBuilder
*
*
* An identifier for the MessageEvent's message that can be used to match
- * SENT and RECEIVED MessageEvents. It is recommended to be unique within
- * a Span.
+ * `SENT` and `RECEIVED` MessageEvents.
*
*
* int64 id = 2;
@@ -2700,8 +2700,9 @@ public interface MessageEventOrBuilder
*
*
*
- * The number of compressed bytes sent or received. If missing assumed to
- * be the same size as uncompressed.
+ * The number of compressed bytes sent or received. If missing, the
+ * compressed size is assumed to be the same size as the uncompressed
+ * size.
*
*
* int64 compressed_size_bytes = 4;
@@ -2965,8 +2966,7 @@ public com.google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent.Type getTyp
*
*
* An identifier for the MessageEvent's message that can be used to match
- * SENT and RECEIVED MessageEvents. It is recommended to be unique within
- * a Span.
+ * `SENT` and `RECEIVED` MessageEvents.
*
*
* int64 id = 2;
@@ -3002,8 +3002,9 @@ public long getUncompressedSizeBytes() {
*
*
*
- * The number of compressed bytes sent or received. If missing assumed to
- * be the same size as uncompressed.
+ * The number of compressed bytes sent or received. If missing, the
+ * compressed size is assumed to be the same size as the uncompressed
+ * size.
*
*
* int64 compressed_size_bytes = 4;
@@ -3541,8 +3542,7 @@ public Builder clearType() {
*
*
* An identifier for the MessageEvent's message that can be used to match
- * SENT and RECEIVED MessageEvents. It is recommended to be unique within
- * a Span.
+ * `SENT` and `RECEIVED` MessageEvents.
*
*
* int64 id = 2;
@@ -3558,8 +3558,7 @@ public long getId() {
*
*
* An identifier for the MessageEvent's message that can be used to match
- * SENT and RECEIVED MessageEvents. It is recommended to be unique within
- * a Span.
+ * `SENT` and `RECEIVED` MessageEvents.
*
*
* int64 id = 2;
@@ -3579,8 +3578,7 @@ public Builder setId(long value) {
*
*
* An identifier for the MessageEvent's message that can be used to match
- * SENT and RECEIVED MessageEvents. It is recommended to be unique within
- * a Span.
+ * `SENT` and `RECEIVED` MessageEvents.
*
*
* int64 id = 2;
@@ -3652,8 +3650,9 @@ public Builder clearUncompressedSizeBytes() {
*
*
*
- * The number of compressed bytes sent or received. If missing assumed to
- * be the same size as uncompressed.
+ * The number of compressed bytes sent or received. If missing, the
+ * compressed size is assumed to be the same size as the uncompressed
+ * size.
*
*
* int64 compressed_size_bytes = 4;
@@ -3668,8 +3667,9 @@ public long getCompressedSizeBytes() {
*
*
*
- * The number of compressed bytes sent or received. If missing assumed to
- * be the same size as uncompressed.
+ * The number of compressed bytes sent or received. If missing, the
+ * compressed size is assumed to be the same size as the uncompressed
+ * size.
*
*
* int64 compressed_size_bytes = 4;
@@ -3688,8 +3688,9 @@ public Builder setCompressedSizeBytes(long value) {
*
*
*
- * The number of compressed bytes sent or received. If missing assumed to
- * be the same size as uncompressed.
+ * The number of compressed bytes sent or received. If missing, the
+ * compressed size is assumed to be the same size as the uncompressed
+ * size.
*
*
* int64 compressed_size_bytes = 4;
@@ -6328,7 +6329,7 @@ public interface LinkOrBuilder
*
*
*
- * The [TRACE_ID] for a trace within a project.
+ * The `[TRACE_ID]` for a trace within a project.
*
*
* string trace_id = 1;
@@ -6340,7 +6341,7 @@ public interface LinkOrBuilder
*
*
*
- * The [TRACE_ID] for a trace within a project.
+ * The `[TRACE_ID]` for a trace within a project.
*
*
* string trace_id = 1;
@@ -6353,7 +6354,7 @@ public interface LinkOrBuilder
*
*
*
- * The [SPAN_ID] for a span within a trace.
+ * The `[SPAN_ID]` for a span within a trace.
*
*
* string span_id = 2;
@@ -6365,7 +6366,7 @@ public interface LinkOrBuilder
*
*
*
- * The [SPAN_ID] for a span within a trace.
+ * The `[SPAN_ID]` for a span within a trace.
*
*
* string span_id = 2;
@@ -6403,8 +6404,8 @@ public interface LinkOrBuilder
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -6416,8 +6417,8 @@ public interface LinkOrBuilder
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -6429,8 +6430,8 @@ public interface LinkOrBuilder
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -6657,7 +6658,7 @@ private Type(int value) {
*
*
*
- * The [TRACE_ID] for a trace within a project.
+ * The `[TRACE_ID]` for a trace within a project.
*
*
* string trace_id = 1;
@@ -6680,7 +6681,7 @@ public java.lang.String getTraceId() {
*
*
*
- * The [TRACE_ID] for a trace within a project.
+ * The `[TRACE_ID]` for a trace within a project.
*
*
* string trace_id = 1;
@@ -6708,7 +6709,7 @@ public com.google.protobuf.ByteString getTraceIdBytes() {
*
*
*
- * The [SPAN_ID] for a span within a trace.
+ * The `[SPAN_ID]` for a span within a trace.
*
*
* string span_id = 2;
@@ -6731,7 +6732,7 @@ public java.lang.String getSpanId() {
*
*
*
- * The [SPAN_ID] for a span within a trace.
+ * The `[SPAN_ID]` for a span within a trace.
*
*
* string span_id = 2;
@@ -6794,8 +6795,8 @@ public com.google.devtools.cloudtrace.v2.Span.Link.Type getType() {
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -6810,8 +6811,8 @@ public boolean hasAttributes() {
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -6828,8 +6829,8 @@ public com.google.devtools.cloudtrace.v2.Span.Attributes getAttributes() {
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -7272,7 +7273,7 @@ public Builder mergeFrom(
*
*
*
- * The [TRACE_ID] for a trace within a project.
+ * The `[TRACE_ID]` for a trace within a project.
*
*
* string trace_id = 1;
@@ -7294,7 +7295,7 @@ public java.lang.String getTraceId() {
*
*
*
- * The [TRACE_ID] for a trace within a project.
+ * The `[TRACE_ID]` for a trace within a project.
*
*
* string trace_id = 1;
@@ -7316,7 +7317,7 @@ public com.google.protobuf.ByteString getTraceIdBytes() {
*
*
*
- * The [TRACE_ID] for a trace within a project.
+ * The `[TRACE_ID]` for a trace within a project.
*
*
* string trace_id = 1;
@@ -7337,7 +7338,7 @@ public Builder setTraceId(java.lang.String value) {
*
*
*
- * The [TRACE_ID] for a trace within a project.
+ * The `[TRACE_ID]` for a trace within a project.
*
*
* string trace_id = 1;
@@ -7354,7 +7355,7 @@ public Builder clearTraceId() {
*
*
*
- * The [TRACE_ID] for a trace within a project.
+ * The `[TRACE_ID]` for a trace within a project.
*
*
* string trace_id = 1;
@@ -7378,7 +7379,7 @@ public Builder setTraceIdBytes(com.google.protobuf.ByteString value) {
*
*
*
- * The [SPAN_ID] for a span within a trace.
+ * The `[SPAN_ID]` for a span within a trace.
*
*
* string span_id = 2;
@@ -7400,7 +7401,7 @@ public java.lang.String getSpanId() {
*
*
*
- * The [SPAN_ID] for a span within a trace.
+ * The `[SPAN_ID]` for a span within a trace.
*
*
* string span_id = 2;
@@ -7422,7 +7423,7 @@ public com.google.protobuf.ByteString getSpanIdBytes() {
*
*
*
- * The [SPAN_ID] for a span within a trace.
+ * The `[SPAN_ID]` for a span within a trace.
*
*
* string span_id = 2;
@@ -7443,7 +7444,7 @@ public Builder setSpanId(java.lang.String value) {
*
*
*
- * The [SPAN_ID] for a span within a trace.
+ * The `[SPAN_ID]` for a span within a trace.
*
*
* string span_id = 2;
@@ -7460,7 +7461,7 @@ public Builder clearSpanId() {
*
*
*
- * The [SPAN_ID] for a span within a trace.
+ * The `[SPAN_ID]` for a span within a trace.
*
*
* string span_id = 2;
@@ -7581,8 +7582,8 @@ public Builder clearType() {
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -7596,8 +7597,8 @@ public boolean hasAttributes() {
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -7617,8 +7618,8 @@ public com.google.devtools.cloudtrace.v2.Span.Attributes getAttributes() {
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -7640,8 +7641,8 @@ public Builder setAttributes(com.google.devtools.cloudtrace.v2.Span.Attributes v
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -7661,8 +7662,8 @@ public Builder setAttributes(
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -7688,8 +7689,8 @@ public Builder mergeAttributes(com.google.devtools.cloudtrace.v2.Span.Attributes
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -7708,8 +7709,8 @@ public Builder clearAttributes() {
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -7723,8 +7724,8 @@ public com.google.devtools.cloudtrace.v2.Span.Attributes.Builder getAttributesBu
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -7742,8 +7743,8 @@ public com.google.devtools.cloudtrace.v2.Span.AttributesOrBuilder getAttributesO
*
*
*
- * A set of attributes on the link. You have have up to 32 attributes per
- * link.
+ * A set of attributes on the link. Up to 32 attributes can be
+ * specified per link.
*
*
* .google.devtools.cloudtrace.v2.Span.Attributes attributes = 4;
@@ -8933,11 +8934,14 @@ public com.google.devtools.cloudtrace.v2.Span.Links getDefaultInstanceForType()
*
*
* Required. The resource name of the span in the following format:
- * projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
- * [TRACE_ID] is a unique identifier for a trace within a project;
- * it is a 32-character hexadecimal encoding of a 16-byte array.
- * [SPAN_ID] is a unique identifier for a span within a trace; it
- * is a 16-character hexadecimal encoding of an 8-byte array.
+ * * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
+ * `[TRACE_ID]` is a unique identifier for a trace within a project;
+ * it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ * not be zero.
+ * `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ * is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ * be zero.
+ * .
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -8961,11 +8965,14 @@ public java.lang.String getName() {
*
*
* Required. The resource name of the span in the following format:
- * projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
- * [TRACE_ID] is a unique identifier for a trace within a project;
- * it is a 32-character hexadecimal encoding of a 16-byte array.
- * [SPAN_ID] is a unique identifier for a span within a trace; it
- * is a 16-character hexadecimal encoding of an 8-byte array.
+ * * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
+ * `[TRACE_ID]` is a unique identifier for a trace within a project;
+ * it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ * not be zero.
+ * `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ * is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ * be zero.
+ * .
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -8993,7 +9000,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
*
- * Required. The [SPAN_ID] portion of the span's resource name.
+ * Required. The `[SPAN_ID]` portion of the span's resource name.
*
*
* string span_id = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -9016,7 +9023,7 @@ public java.lang.String getSpanId() {
*
*
*
- * Required. The [SPAN_ID] portion of the span's resource name.
+ * Required. The `[SPAN_ID]` portion of the span's resource name.
*
*
* string span_id = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -9044,7 +9051,7 @@ public com.google.protobuf.ByteString getSpanIdBytes() {
*
*
*
- * The [SPAN_ID] of this span's parent span. If this is a root span,
+ * The `[SPAN_ID]` of this span's parent span. If this is a root span,
* then this field must be empty.
*
*
@@ -9068,7 +9075,7 @@ public java.lang.String getParentSpanId() {
*
*
*
- * The [SPAN_ID] of this span's parent span. If this is a root span,
+ * The `[SPAN_ID]` of this span's parent span. If this is a root span,
* then this field must be empty.
*
*
@@ -9096,8 +9103,8 @@ public com.google.protobuf.ByteString getParentSpanIdBytes() {
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -9119,8 +9126,8 @@ public boolean hasDisplayName() {
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -9144,8 +9151,8 @@ public com.google.devtools.cloudtrace.v2.TruncatableString getDisplayName() {
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -9169,9 +9176,10 @@ public com.google.devtools.cloudtrace.v2.TruncatableStringOrBuilder getDisplayNa
*
*
*
*
@@ -10430,11 +10438,14 @@ public Builder mergeFrom(
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -9187,9 +9195,10 @@ public boolean hasStartTime() {
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -9205,9 +9214,10 @@ public com.google.protobuf.Timestamp getStartTime() {
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -9224,9 +9234,9 @@ public com.google.protobuf.TimestampOrBuilder getStartTimeOrBuilder() {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -9241,9 +9251,9 @@ public boolean hasEndTime() {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -9258,9 +9268,9 @@ public com.google.protobuf.Timestamp getEndTime() {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -9530,8 +9540,7 @@ public com.google.rpc.StatusOrBuilder getStatusOrBuilder() {
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -9550,8 +9559,7 @@ public boolean hasSameProcessAsParentSpan() {
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -9572,8 +9580,7 @@ public com.google.protobuf.BoolValue getSameProcessAsParentSpan() {
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -9652,9 +9659,9 @@ public com.google.protobuf.Int32ValueOrBuilder getChildSpanCountOrBuilder() {
*
*
*
- * Optional. Distinguishes between spans generated in a particular context. For example,
- * two spans with the same name may be distinguished using `CLIENT` (caller)
- * and `SERVER` (callee) to identify an RPC call.
+ * Optional. Distinguishes between spans generated in a particular context.
+ * For example, two spans with the same name may be distinguished using
+ * `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
*
*
*
@@ -9671,9 +9678,9 @@ public int getSpanKindValue() {
*
*
*
- * Optional. Distinguishes between spans generated in a particular context. For example,
- * two spans with the same name may be distinguished using `CLIENT` (caller)
- * and `SERVER` (callee) to identify an RPC call.
+ * Optional. Distinguishes between spans generated in a particular context.
+ * For example, two spans with the same name may be distinguished using
+ * `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
*
*
*
@@ -10025,8 +10032,9 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
* A span represents a single operation within a trace. Spans can be
* nested to form a trace tree. Often, a trace contains a root span
* that describes the end-to-end latency, and one or more subspans for
- * its sub-operations. A trace can also contain multiple root spans,
- * or none at all. Spans do not need to be contiguous—there may be
+ * its sub-operations.
+ * A trace can also contain multiple root spans, or none at all.
+ * Spans do not need to be contiguous. There might be
* gaps or overlaps between spans in a trace.
*
* Required. The resource name of the span in the following format:
- * projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
- * [TRACE_ID] is a unique identifier for a trace within a project;
- * it is a 32-character hexadecimal encoding of a 16-byte array.
- * [SPAN_ID] is a unique identifier for a span within a trace; it
- * is a 16-character hexadecimal encoding of an 8-byte array.
+ * * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
+ * `[TRACE_ID]` is a unique identifier for a trace within a project;
+ * it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ * not be zero.
+ * `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ * is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ * be zero.
+ * .
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -10457,11 +10468,14 @@ public java.lang.String getName() {
*
*
* Required. The resource name of the span in the following format:
- * projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
- * [TRACE_ID] is a unique identifier for a trace within a project;
- * it is a 32-character hexadecimal encoding of a 16-byte array.
- * [SPAN_ID] is a unique identifier for a span within a trace; it
- * is a 16-character hexadecimal encoding of an 8-byte array.
+ * * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
+ * `[TRACE_ID]` is a unique identifier for a trace within a project;
+ * it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ * not be zero.
+ * `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ * is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ * be zero.
+ * .
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -10484,11 +10498,14 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* Required. The resource name of the span in the following format:
- * projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
- * [TRACE_ID] is a unique identifier for a trace within a project;
- * it is a 32-character hexadecimal encoding of a 16-byte array.
- * [SPAN_ID] is a unique identifier for a span within a trace; it
- * is a 16-character hexadecimal encoding of an 8-byte array.
+ * * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
+ * `[TRACE_ID]` is a unique identifier for a trace within a project;
+ * it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ * not be zero.
+ * `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ * is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ * be zero.
+ * .
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -10510,11 +10527,14 @@ public Builder setName(java.lang.String value) {
*
*
* Required. The resource name of the span in the following format:
- * projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
- * [TRACE_ID] is a unique identifier for a trace within a project;
- * it is a 32-character hexadecimal encoding of a 16-byte array.
- * [SPAN_ID] is a unique identifier for a span within a trace; it
- * is a 16-character hexadecimal encoding of an 8-byte array.
+ * * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
+ * `[TRACE_ID]` is a unique identifier for a trace within a project;
+ * it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ * not be zero.
+ * `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ * is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ * be zero.
+ * .
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -10532,11 +10552,14 @@ public Builder clearName() {
*
*
* Required. The resource name of the span in the following format:
- * projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
- * [TRACE_ID] is a unique identifier for a trace within a project;
- * it is a 32-character hexadecimal encoding of a 16-byte array.
- * [SPAN_ID] is a unique identifier for a span within a trace; it
- * is a 16-character hexadecimal encoding of an 8-byte array.
+ * * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
+ * `[TRACE_ID]` is a unique identifier for a trace within a project;
+ * it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ * not be zero.
+ * `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ * is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ * be zero.
+ * .
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -10560,7 +10583,7 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
*
*
*
- * Required. The [SPAN_ID] portion of the span's resource name.
+ * Required. The `[SPAN_ID]` portion of the span's resource name.
*
*
* string span_id = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -10582,7 +10605,7 @@ public java.lang.String getSpanId() {
*
*
*
- * Required. The [SPAN_ID] portion of the span's resource name.
+ * Required. The `[SPAN_ID]` portion of the span's resource name.
*
*
* string span_id = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -10604,7 +10627,7 @@ public com.google.protobuf.ByteString getSpanIdBytes() {
*
*
*
- * Required. The [SPAN_ID] portion of the span's resource name.
+ * Required. The `[SPAN_ID]` portion of the span's resource name.
*
*
* string span_id = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -10625,7 +10648,7 @@ public Builder setSpanId(java.lang.String value) {
*
*
*
- * Required. The [SPAN_ID] portion of the span's resource name.
+ * Required. The `[SPAN_ID]` portion of the span's resource name.
*
*
* string span_id = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -10642,7 +10665,7 @@ public Builder clearSpanId() {
*
*
*
- * Required. The [SPAN_ID] portion of the span's resource name.
+ * Required. The `[SPAN_ID]` portion of the span's resource name.
*
*
* string span_id = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -10666,7 +10689,7 @@ public Builder setSpanIdBytes(com.google.protobuf.ByteString value) {
*
*
*
- * The [SPAN_ID] of this span's parent span. If this is a root span,
+ * The `[SPAN_ID]` of this span's parent span. If this is a root span,
* then this field must be empty.
*
*
@@ -10689,7 +10712,7 @@ public java.lang.String getParentSpanId() {
*
*
*
- * The [SPAN_ID] of this span's parent span. If this is a root span,
+ * The `[SPAN_ID]` of this span's parent span. If this is a root span,
* then this field must be empty.
*
*
@@ -10712,7 +10735,7 @@ public com.google.protobuf.ByteString getParentSpanIdBytes() {
*
*
*
- * The [SPAN_ID] of this span's parent span. If this is a root span,
+ * The `[SPAN_ID]` of this span's parent span. If this is a root span,
* then this field must be empty.
*
*
@@ -10734,7 +10757,7 @@ public Builder setParentSpanId(java.lang.String value) {
*
*
*
- * The [SPAN_ID] of this span's parent span. If this is a root span,
+ * The `[SPAN_ID]` of this span's parent span. If this is a root span,
* then this field must be empty.
*
*
@@ -10752,7 +10775,7 @@ public Builder clearParentSpanId() {
*
*
*
- * The [SPAN_ID] of this span's parent span. If this is a root span,
+ * The `[SPAN_ID]` of this span's parent span. If this is a root span,
* then this field must be empty.
*
*
@@ -10783,8 +10806,8 @@ public Builder setParentSpanIdBytes(com.google.protobuf.ByteString value) {
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -10805,8 +10828,8 @@ public boolean hasDisplayName() {
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -10833,8 +10856,8 @@ public com.google.devtools.cloudtrace.v2.TruncatableString getDisplayName() {
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -10863,8 +10886,8 @@ public Builder setDisplayName(com.google.devtools.cloudtrace.v2.TruncatableStrin
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -10891,8 +10914,8 @@ public Builder setDisplayName(
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -10925,8 +10948,8 @@ public Builder mergeDisplayName(com.google.devtools.cloudtrace.v2.TruncatableStr
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -10952,8 +10975,8 @@ public Builder clearDisplayName() {
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -10974,8 +10997,8 @@ public com.google.devtools.cloudtrace.v2.TruncatableString.Builder getDisplayNam
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -11000,8 +11023,8 @@ public com.google.devtools.cloudtrace.v2.TruncatableStringOrBuilder getDisplayNa
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -11039,9 +11062,10 @@ public com.google.devtools.cloudtrace.v2.TruncatableStringOrBuilder getDisplayNa
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -11056,9 +11080,10 @@ public boolean hasStartTime() {
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -11077,9 +11102,10 @@ public com.google.protobuf.Timestamp getStartTime() {
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -11102,9 +11128,10 @@ public Builder setStartTime(com.google.protobuf.Timestamp value) {
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -11124,9 +11151,10 @@ public Builder setStartTime(com.google.protobuf.Timestamp.Builder builderForValu
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -11152,9 +11180,10 @@ public Builder mergeStartTime(com.google.protobuf.Timestamp value) {
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -11174,9 +11203,10 @@ public Builder clearStartTime() {
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -11191,9 +11221,10 @@ public com.google.protobuf.Timestamp.Builder getStartTimeBuilder() {
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -11210,9 +11241,10 @@ public com.google.protobuf.TimestampOrBuilder getStartTimeOrBuilder() {
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -11245,9 +11277,9 @@ public com.google.protobuf.TimestampOrBuilder getStartTimeOrBuilder() {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -11262,9 +11294,9 @@ public boolean hasEndTime() {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -11283,9 +11315,9 @@ public com.google.protobuf.Timestamp getEndTime() {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -11308,9 +11340,9 @@ public Builder setEndTime(com.google.protobuf.Timestamp value) {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -11330,9 +11362,9 @@ public Builder setEndTime(com.google.protobuf.Timestamp.Builder builderForValue)
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -11358,9 +11390,9 @@ public Builder mergeEndTime(com.google.protobuf.Timestamp value) {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -11380,9 +11412,9 @@ public Builder clearEndTime() {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -11397,9 +11429,9 @@ public com.google.protobuf.Timestamp.Builder getEndTimeBuilder() {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -11416,9 +11448,9 @@ public com.google.protobuf.TimestampOrBuilder getEndTimeOrBuilder() {
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -12382,8 +12414,7 @@ public com.google.rpc.StatusOrBuilder getStatusOrBuilder() {
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -12401,8 +12432,7 @@ public boolean hasSameProcessAsParentSpan() {
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -12426,8 +12456,7 @@ public com.google.protobuf.BoolValue getSameProcessAsParentSpan() {
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -12453,8 +12482,7 @@ public Builder setSameProcessAsParentSpan(com.google.protobuf.BoolValue value) {
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -12478,8 +12506,7 @@ public Builder setSameProcessAsParentSpan(
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -12508,8 +12535,7 @@ public Builder mergeSameProcessAsParentSpan(com.google.protobuf.BoolValue value)
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -12532,8 +12558,7 @@ public Builder clearSameProcessAsParentSpan() {
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -12551,8 +12576,7 @@ public com.google.protobuf.BoolValue.Builder getSameProcessAsParentSpanBuilder()
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -12574,8 +12598,7 @@ public com.google.protobuf.BoolValueOrBuilder getSameProcessAsParentSpanOrBuilde
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -12814,9 +12837,9 @@ public com.google.protobuf.Int32ValueOrBuilder getChildSpanCountOrBuilder() {
*
*
*
- * Optional. Distinguishes between spans generated in a particular context. For example,
- * two spans with the same name may be distinguished using `CLIENT` (caller)
- * and `SERVER` (callee) to identify an RPC call.
+ * Optional. Distinguishes between spans generated in a particular context.
+ * For example, two spans with the same name may be distinguished using
+ * `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
*
*
*
@@ -12833,9 +12856,9 @@ public int getSpanKindValue() {
*
*
*
- * Optional. Distinguishes between spans generated in a particular context. For example,
- * two spans with the same name may be distinguished using `CLIENT` (caller)
- * and `SERVER` (callee) to identify an RPC call.
+ * Optional. Distinguishes between spans generated in a particular context.
+ * For example, two spans with the same name may be distinguished using
+ * `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
*
*
*
@@ -12855,9 +12878,9 @@ public Builder setSpanKindValue(int value) {
*
*
*
- * Optional. Distinguishes between spans generated in a particular context. For example,
- * two spans with the same name may be distinguished using `CLIENT` (caller)
- * and `SERVER` (callee) to identify an RPC call.
+ * Optional. Distinguishes between spans generated in a particular context.
+ * For example, two spans with the same name may be distinguished using
+ * `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
*
*
*
@@ -12876,9 +12899,9 @@ public com.google.devtools.cloudtrace.v2.Span.SpanKind getSpanKind() {
*
*
*
- * Optional. Distinguishes between spans generated in a particular context. For example,
- * two spans with the same name may be distinguished using `CLIENT` (caller)
- * and `SERVER` (callee) to identify an RPC call.
+ * Optional. Distinguishes between spans generated in a particular context.
+ * For example, two spans with the same name may be distinguished using
+ * `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
*
*
*
@@ -12901,9 +12924,9 @@ public Builder setSpanKind(com.google.devtools.cloudtrace.v2.Span.SpanKind value
*
*
*
- * Optional. Distinguishes between spans generated in a particular context. For example,
- * two spans with the same name may be distinguished using `CLIENT` (caller)
- * and `SERVER` (callee) to identify an RPC call.
+ * Optional. Distinguishes between spans generated in a particular context.
+ * For example, two spans with the same name may be distinguished using
+ * `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
*
*
*
diff --git a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/SpanOrBuilder.java b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/SpanOrBuilder.java
index 1c5f1f8aac07..aeedba58a286 100644
--- a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/SpanOrBuilder.java
+++ b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/SpanOrBuilder.java
@@ -28,11 +28,14 @@ public interface SpanOrBuilder
*
*
* Required. The resource name of the span in the following format:
- * projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
- * [TRACE_ID] is a unique identifier for a trace within a project;
- * it is a 32-character hexadecimal encoding of a 16-byte array.
- * [SPAN_ID] is a unique identifier for a span within a trace; it
- * is a 16-character hexadecimal encoding of an 8-byte array.
+ * * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
+ * `[TRACE_ID]` is a unique identifier for a trace within a project;
+ * it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ * not be zero.
+ * `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ * is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ * be zero.
+ * .
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -45,11 +48,14 @@ public interface SpanOrBuilder
*
*
* Required. The resource name of the span in the following format:
- * projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
- * [TRACE_ID] is a unique identifier for a trace within a project;
- * it is a 32-character hexadecimal encoding of a 16-byte array.
- * [SPAN_ID] is a unique identifier for a span within a trace; it
- * is a 16-character hexadecimal encoding of an 8-byte array.
+ * * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
+ * `[TRACE_ID]` is a unique identifier for a trace within a project;
+ * it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ * not be zero.
+ * `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ * is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ * be zero.
+ * .
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -62,7 +68,7 @@ public interface SpanOrBuilder
*
*
*
- * Required. The [SPAN_ID] portion of the span's resource name.
+ * Required. The `[SPAN_ID]` portion of the span's resource name.
*
*
* string span_id = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -74,7 +80,7 @@ public interface SpanOrBuilder
*
*
*
- * Required. The [SPAN_ID] portion of the span's resource name.
+ * Required. The `[SPAN_ID]` portion of the span's resource name.
*
*
* string span_id = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -87,7 +93,7 @@ public interface SpanOrBuilder
*
*
*
- * The [SPAN_ID] of this span's parent span. If this is a root span,
+ * The `[SPAN_ID]` of this span's parent span. If this is a root span,
* then this field must be empty.
*
*
@@ -100,7 +106,7 @@ public interface SpanOrBuilder
*
*
*
- * The [SPAN_ID] of this span's parent span. If this is a root span,
+ * The `[SPAN_ID]` of this span's parent span. If this is a root span,
* then this field must be empty.
*
*
@@ -115,8 +121,8 @@ public interface SpanOrBuilder
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -135,8 +141,8 @@ public interface SpanOrBuilder
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -155,8 +161,8 @@ public interface SpanOrBuilder
*
*
* Required. A description of the span's operation (up to 128 bytes).
- * Stackdriver Trace displays the description in the
- * Google Cloud Platform Console.
+ * Cloud Trace displays the description in the
+ * Cloud console.
* For example, the display name can be a qualified method name or a file name
* and a line number where the operation is called. A best practice is to use
* the same display name within an application and at the same call point.
@@ -173,9 +179,10 @@ public interface SpanOrBuilder
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -188,9 +195,10 @@ public interface SpanOrBuilder
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -203,9 +211,10 @@ public interface SpanOrBuilder
*
*
*
- * Required. The start time of the span. On the client side, this is the time kept by
- * the local machine where the span execution starts. On the server side, this
- * is the time when the server's application handler starts running.
+ * Required. The start time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution starts. On the server
+ * side, this is the time when the server's application handler starts
+ * running.
*
*
* .google.protobuf.Timestamp start_time = 5 [(.google.api.field_behavior) = REQUIRED];
@@ -217,9 +226,9 @@ public interface SpanOrBuilder
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -231,9 +240,9 @@ public interface SpanOrBuilder
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -245,9 +254,9 @@ public interface SpanOrBuilder
*
*
*
- * Required. The end time of the span. On the client side, this is the time kept by
- * the local machine where the span execution ends. On the server side, this
- * is the time when the server application handler stops running.
+ * Required. The end time of the span. On the client side, this is the time
+ * kept by the local machine where the span execution ends. On the server
+ * side, this is the time when the server application handler stops running.
*
*
* .google.protobuf.Timestamp end_time = 6 [(.google.api.field_behavior) = REQUIRED];
@@ -441,8 +450,7 @@ public interface SpanOrBuilder
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -458,8 +466,7 @@ public interface SpanOrBuilder
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -475,8 +482,7 @@ public interface SpanOrBuilder
*
* Optional. Set this parameter to indicate whether this span is in
* the same process as its parent. If you do not set this parameter,
- * Stackdriver Trace is unable to take advantage of this helpful
- * information.
+ * Trace is unable to take advantage of this helpful information.
*
*
*
@@ -533,9 +539,9 @@ public interface SpanOrBuilder
*
*
*
- * Optional. Distinguishes between spans generated in a particular context. For example,
- * two spans with the same name may be distinguished using `CLIENT` (caller)
- * and `SERVER` (callee) to identify an RPC call.
+ * Optional. Distinguishes between spans generated in a particular context.
+ * For example, two spans with the same name may be distinguished using
+ * `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
*
*
*
@@ -549,9 +555,9 @@ public interface SpanOrBuilder
*
*
*
- * Optional. Distinguishes between spans generated in a particular context. For example,
- * two spans with the same name may be distinguished using `CLIENT` (caller)
- * and `SERVER` (callee) to identify an RPC call.
+ * Optional. Distinguishes between spans generated in a particular context.
+ * For example, two spans with the same name may be distinguished using
+ * `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
*
*
*
diff --git a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/StackTrace.java b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/StackTrace.java
index 4b35fa3e577d..86d7bd23fde0 100644
--- a/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/StackTrace.java
+++ b/java-trace/proto-google-cloud-trace-v2/src/main/java/com/google/devtools/cloudtrace/v2/StackTrace.java
@@ -112,9 +112,10 @@ public interface StackFrameOrBuilder
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -126,9 +127,10 @@ public interface StackFrameOrBuilder
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -140,9 +142,10 @@ public interface StackFrameOrBuilder
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -390,9 +393,10 @@ public com.google.devtools.cloudtrace.v2.TruncatableStringOrBuilder getFunctionN
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -407,9 +411,10 @@ public boolean hasOriginalFunctionName() {
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -426,9 +431,10 @@ public com.google.devtools.cloudtrace.v2.TruncatableString getOriginalFunctionNa
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -1367,9 +1373,10 @@ public com.google.devtools.cloudtrace.v2.TruncatableString.Builder getFunctionNa
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -1383,9 +1390,10 @@ public boolean hasOriginalFunctionName() {
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -1405,9 +1413,10 @@ public com.google.devtools.cloudtrace.v2.TruncatableString getOriginalFunctionNa
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -1430,9 +1439,10 @@ public Builder setOriginalFunctionName(
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -1452,9 +1462,10 @@ public Builder setOriginalFunctionName(
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -1481,9 +1492,10 @@ public Builder mergeOriginalFunctionName(
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -1502,9 +1514,10 @@ public Builder clearOriginalFunctionName() {
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -1519,9 +1532,10 @@ public Builder clearOriginalFunctionName() {
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
@@ -1540,9 +1554,10 @@ public Builder clearOriginalFunctionName() {
*
*
*
- * An un-mangled function name, if `function_name` is
- * [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- * be fully-qualified (up to 1024 bytes).
+ * An un-mangled function name, if `function_name` is mangled.
+ * To get information about name mangling, run
+ * [this search](https://www.google.com/search?q=cxx+name+mangling).
+ * The name can be fully-qualified (up to 1024 bytes).
*
*
* .google.devtools.cloudtrace.v2.TruncatableString original_function_name = 2;
diff --git a/java-trace/proto-google-cloud-trace-v2/src/main/proto/google/devtools/cloudtrace/v2/trace.proto b/java-trace/proto-google-cloud-trace-v2/src/main/proto/google/devtools/cloudtrace/v2/trace.proto
index 2a3f1e31df67..f2b4b481c66a 100644
--- a/java-trace/proto-google-cloud-trace-v2/src/main/proto/google/devtools/cloudtrace/v2/trace.proto
+++ b/java-trace/proto-google-cloud-trace-v2/src/main/proto/google/devtools/cloudtrace/v2/trace.proto
@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -33,8 +33,10 @@ option ruby_package = "Google::Cloud::Trace::V2";
// A span represents a single operation within a trace. Spans can be
// nested to form a trace tree. Often, a trace contains a root span
// that describes the end-to-end latency, and one or more subspans for
-// its sub-operations. A trace can also contain multiple root spans,
-// or none at all. Spans do not need to be contiguous—there may be
+// its sub-operations.
+//
+// A trace can also contain multiple root spans, or none at all.
+// Spans do not need to be contiguous. There might be
// gaps or overlaps between spans in a trace.
message Span {
option (google.api.resource) = {
@@ -42,11 +44,11 @@ message Span {
pattern: "projects/{project}/traces/{trace}/spans/{span}"
};
- // A set of attributes, each in the format `[KEY]:[VALUE]`.
+ // A set of attributes as key-value pairs.
message Attributes {
- // The set of attributes. Each attribute's key can be up to 128 bytes
+ // A set of attributes. Each attribute's key can be up to 128 bytes
// long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- // or the Boolean values `true` and `false`. For example:
+ // or the boolean values `true` or `false`. For example:
//
// "/instance_id": { "string_value": { "value": "my-instance" } }
// "/http/request_bytes": { "int_value": 300 }
@@ -91,15 +93,15 @@ message Span {
Type type = 1;
// An identifier for the MessageEvent's message that can be used to match
- // SENT and RECEIVED MessageEvents. It is recommended to be unique within
- // a Span.
+ // `SENT` and `RECEIVED` MessageEvents.
int64 id = 2;
// The number of uncompressed bytes sent or received.
int64 uncompressed_size_bytes = 3;
- // The number of compressed bytes sent or received. If missing assumed to
- // be the same size as uncompressed.
+ // The number of compressed bytes sent or received. If missing, the
+ // compressed size is assumed to be the same size as the uncompressed
+ // size.
int64 compressed_size_bytes = 4;
}
@@ -151,17 +153,17 @@ message Span {
PARENT_LINKED_SPAN = 2;
}
- // The [TRACE_ID] for a trace within a project.
+ // The `[TRACE_ID]` for a trace within a project.
string trace_id = 1;
- // The [SPAN_ID] for a span within a trace.
+ // The `[SPAN_ID]` for a span within a trace.
string span_id = 2;
// The relationship of the current span relative to the linked span.
Type type = 3;
- // A set of attributes on the link. You have have up to 32 attributes per
- // link.
+ // A set of attributes on the link. Up to 32 attributes can be
+ // specified per link.
Attributes attributes = 4;
}
@@ -209,40 +211,46 @@ message Span {
// Required. The resource name of the span in the following format:
//
- // projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+ // * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
//
- // [TRACE_ID] is a unique identifier for a trace within a project;
- // it is a 32-character hexadecimal encoding of a 16-byte array.
+ // `[TRACE_ID]` is a unique identifier for a trace within a project;
+ // it is a 32-character hexadecimal encoding of a 16-byte array. It should
+ // not be zero.
//
- // [SPAN_ID] is a unique identifier for a span within a trace; it
- // is a 16-character hexadecimal encoding of an 8-byte array.
+ // `[SPAN_ID]` is a unique identifier for a span within a trace; it
+ // is a 16-character hexadecimal encoding of an 8-byte array. It should not
+ // be zero.
+ // .
string name = 1 [(google.api.field_behavior) = REQUIRED];
- // Required. The [SPAN_ID] portion of the span's resource name.
+ // Required. The `[SPAN_ID]` portion of the span's resource name.
string span_id = 2 [(google.api.field_behavior) = REQUIRED];
- // The [SPAN_ID] of this span's parent span. If this is a root span,
+ // The `[SPAN_ID]` of this span's parent span. If this is a root span,
// then this field must be empty.
string parent_span_id = 3;
// Required. A description of the span's operation (up to 128 bytes).
- // Stackdriver Trace displays the description in the
- // Google Cloud Platform Console.
+ // Cloud Trace displays the description in the
+ // Cloud console.
// For example, the display name can be a qualified method name or a file name
// and a line number where the operation is called. A best practice is to use
// the same display name within an application and at the same call point.
// This makes it easier to correlate spans in different traces.
TruncatableString display_name = 4 [(google.api.field_behavior) = REQUIRED];
- // Required. The start time of the span. On the client side, this is the time kept by
- // the local machine where the span execution starts. On the server side, this
- // is the time when the server's application handler starts running.
- google.protobuf.Timestamp start_time = 5 [(google.api.field_behavior) = REQUIRED];
+ // Required. The start time of the span. On the client side, this is the time
+ // kept by the local machine where the span execution starts. On the server
+ // side, this is the time when the server's application handler starts
+ // running.
+ google.protobuf.Timestamp start_time = 5
+ [(google.api.field_behavior) = REQUIRED];
- // Required. The end time of the span. On the client side, this is the time kept by
- // the local machine where the span execution ends. On the server side, this
- // is the time when the server application handler stops running.
- google.protobuf.Timestamp end_time = 6 [(google.api.field_behavior) = REQUIRED];
+ // Required. The end time of the span. On the client side, this is the time
+ // kept by the local machine where the span execution ends. On the server
+ // side, this is the time when the server application handler stops running.
+ google.protobuf.Timestamp end_time = 6
+ [(google.api.field_behavior) = REQUIRED];
// A set of attributes on the span. You can have up to 32 attributes per
// span.
@@ -263,21 +271,22 @@ message Span {
// Optional. Set this parameter to indicate whether this span is in
// the same process as its parent. If you do not set this parameter,
- // Stackdriver Trace is unable to take advantage of this helpful
- // information.
- google.protobuf.BoolValue same_process_as_parent_span = 12 [(google.api.field_behavior) = OPTIONAL];
+ // Trace is unable to take advantage of this helpful information.
+ google.protobuf.BoolValue same_process_as_parent_span = 12
+ [(google.api.field_behavior) = OPTIONAL];
// Optional. The number of child spans that were generated while this span
// was active. If set, allows implementation to detect missing child spans.
- google.protobuf.Int32Value child_span_count = 13 [(google.api.field_behavior) = OPTIONAL];
+ google.protobuf.Int32Value child_span_count = 13
+ [(google.api.field_behavior) = OPTIONAL];
- // Optional. Distinguishes between spans generated in a particular context. For example,
- // two spans with the same name may be distinguished using `CLIENT` (caller)
- // and `SERVER` (callee) to identify an RPC call.
+ // Optional. Distinguishes between spans generated in a particular context.
+ // For example, two spans with the same name may be distinguished using
+ // `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
SpanKind span_kind = 14 [(google.api.field_behavior) = OPTIONAL];
}
-// The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
+// The allowed types for `[VALUE]` in a `[KEY]:[VALUE]` attribute.
message AttributeValue {
// The type of the value.
oneof value {
@@ -300,9 +309,10 @@ message StackTrace {
// method that is active in this frame (up to 1024 bytes).
TruncatableString function_name = 1;
- // An un-mangled function name, if `function_name` is
- // [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
- // be fully-qualified (up to 1024 bytes).
+ // An un-mangled function name, if `function_name` is mangled.
+ // To get information about name mangling, run
+ // [this search](https://www.google.com/search?q=cxx+name+mangling).
+ // The name can be fully-qualified (up to 1024 bytes).
TruncatableString original_function_name = 2;
// The name of the source file where the function call appears (up to 256
diff --git a/java-trace/proto-google-cloud-trace-v2/src/main/proto/google/devtools/cloudtrace/v2/tracing.proto b/java-trace/proto-google-cloud-trace-v2/src/main/proto/google/devtools/cloudtrace/v2/tracing.proto
index 7e91d92d15f7..0aac221df21f 100644
--- a/java-trace/proto-google-cloud-trace-v2/src/main/proto/google/devtools/cloudtrace/v2/tracing.proto
+++ b/java-trace/proto-google-cloud-trace-v2/src/main/proto/google/devtools/cloudtrace/v2/tracing.proto
@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
@@ -31,18 +31,20 @@ option java_package = "com.google.devtools.cloudtrace.v2";
option php_namespace = "Google\\Cloud\\Trace\\V2";
option ruby_package = "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 for collecting and viewing traces and spans within a trace.
+//
+// A trace is a collection of spans corresponding to a single
+// operation or a set of operations in an application.
+//
+// A span is an individual timed event which forms a node of the trace tree.
+// A single trace can contain spans from multiple services.
service TraceService {
option (google.api.default_host) = "cloudtrace.googleapis.com";
option (google.api.oauth_scopes) =
"https://www.googleapis.com/auth/cloud-platform,"
"https://www.googleapis.com/auth/trace.append";
- // Sends new spans to new or existing traces. You cannot update
+ // Batch writes new spans to new or existing traces. You cannot update
// existing spans.
rpc BatchWriteSpans(BatchWriteSpansRequest) returns (google.protobuf.Empty) {
option (google.api.http) = {
@@ -73,6 +75,6 @@ message BatchWriteSpansRequest {
];
// Required. A list of new spans. The span names must not match existing
- // spans, or the results are undefined.
+ // spans, otherwise the results are undefined.
repeated Span spans = 2 [(google.api.field_behavior) = REQUIRED];
}