@@ -179,22 +179,20 @@ public final class LogEntry extends com.google.api.client.json.GenericJson {
179179 private LogEntrySourceLocation sourceLocation ;
180180
181181 /**
182- * Optional. The ID of the Cloud Trace (https://cloud.google.com/trace) span associated with the
183- * current operation in which the log is being written. For example, if a span has the REST
184- * resource name of "projects/some-project/traces/some-trace/spans/some-span-id", then the span_id
185- * field is "some-span-id".A Span
186- * (https://cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span)
182+ * Optional. The ID of the Cloud Trace (https://docs.cloud.google.com/trace/docs) span associated
183+ * with the current operation in which the log is being written.A Span
184+ * (https://docs.cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span)
187185 * represents a single operation within a trace. Whereas a trace may involve multiple different
188186 * microservices running on multiple different machines, a span generally corresponds to a single
189187 * logical operation being performed in a single instance of a microservice on one specific
190188 * machine. Spans are the nodes within the tree that is a trace.Applications that are instrumented
191- * for tracing (https://cloud.google.com/trace/docs/setup) will generally assign a new, unique
192- * span ID on each incoming request. It is also common to create and record additional spans
193- * corresponding to internal processing elements as well as issuing requests to dependencies.The
194- * span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte array and should
195- * not be zero. It should be unique within the trace and should, ideally, be generated in a manner
196- * that is uniformly random.Example values: 000000000000004a 7a2190356c3fc94b 0000f00300090021
197- * d39223e101960076
189+ * for tracing (https://docs. cloud.google.com/trace/docs/setup) will generally assign a new,
190+ * unique span ID on each incoming request. It is also common to create and record additional
191+ * spans corresponding to internal processing elements as well as issuing requests to
192+ * dependencies.The span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte
193+ * array and should not be zero. It should be unique within the trace and should, ideally, be
194+ * generated in a manner that is uniformly random.Example values: 000000000000004a
195+ * 7a2190356c3fc94b 0000f00300090021 d39223e101960076
198196 * The value may be {@code null}.
199197 */
200198 @ com .google .api .client .util .Key
@@ -230,12 +228,14 @@ public final class LogEntry extends com.google.api.client.json.GenericJson {
230228 private String timestamp ;
231229
232230 /**
233- * Optional. The REST resource name of the trace being written to Cloud Trace
234- * (https://cloud.google.com/trace) in association with this log entry. For example, if your trace
235- * data is stored in the Cloud project "my-trace-project" and if the service that is creating the
236- * log entry receives a trace header that includes the trace ID "12345", then the service should
237- * use "projects/my-trace-project/traces/12345".The trace field provides the link between logs and
238- * traces. By using this field, you can navigate from a log entry to a trace.
231+ * Optional. The trace ID being written to Cloud Trace (https://docs.cloud.google.com/trace/docs)
232+ * in association with this log entry. For example, if your trace data is stored in the Cloud
233+ * project "my-trace-project" and if the service that is creating the log entry receives a trace
234+ * header that includes the trace ID "12345", then the service should use "12345".The REST
235+ * resource name of the trace is also supported, but using this format is not recommended. An
236+ * example trace REST resource name is similar to "projects/my-trace-project/traces/12345".The
237+ * trace field provides the link between logs and traces. By using this field, you can navigate
238+ * from a log entry to a trace.
239239 * The value may be {@code null}.
240240 */
241241 @ com .google .api .client .util .Key
@@ -598,45 +598,41 @@ public LogEntry setSourceLocation(LogEntrySourceLocation sourceLocation) {
598598 }
599599
600600 /**
601- * Optional. The ID of the Cloud Trace (https://cloud.google.com/trace) span associated with the
602- * current operation in which the log is being written. For example, if a span has the REST
603- * resource name of "projects/some-project/traces/some-trace/spans/some-span-id", then the span_id
604- * field is "some-span-id".A Span
605- * (https://cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span)
601+ * Optional. The ID of the Cloud Trace (https://docs.cloud.google.com/trace/docs) span associated
602+ * with the current operation in which the log is being written.A Span
603+ * (https://docs.cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span)
606604 * represents a single operation within a trace. Whereas a trace may involve multiple different
607605 * microservices running on multiple different machines, a span generally corresponds to a single
608606 * logical operation being performed in a single instance of a microservice on one specific
609607 * machine. Spans are the nodes within the tree that is a trace.Applications that are instrumented
610- * for tracing (https://cloud.google.com/trace/docs/setup) will generally assign a new, unique
611- * span ID on each incoming request. It is also common to create and record additional spans
612- * corresponding to internal processing elements as well as issuing requests to dependencies.The
613- * span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte array and should
614- * not be zero. It should be unique within the trace and should, ideally, be generated in a manner
615- * that is uniformly random.Example values: 000000000000004a 7a2190356c3fc94b 0000f00300090021
616- * d39223e101960076
608+ * for tracing (https://docs. cloud.google.com/trace/docs/setup) will generally assign a new,
609+ * unique span ID on each incoming request. It is also common to create and record additional
610+ * spans corresponding to internal processing elements as well as issuing requests to
611+ * dependencies.The span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte
612+ * array and should not be zero. It should be unique within the trace and should, ideally, be
613+ * generated in a manner that is uniformly random.Example values: 000000000000004a
614+ * 7a2190356c3fc94b 0000f00300090021 d39223e101960076
617615 * @return value or {@code null} for none
618616 */
619617 public java .lang .String getSpanId () {
620618 return spanId ;
621619 }
622620
623621 /**
624- * Optional. The ID of the Cloud Trace (https://cloud.google.com/trace) span associated with the
625- * current operation in which the log is being written. For example, if a span has the REST
626- * resource name of "projects/some-project/traces/some-trace/spans/some-span-id", then the span_id
627- * field is "some-span-id".A Span
628- * (https://cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span)
622+ * Optional. The ID of the Cloud Trace (https://docs.cloud.google.com/trace/docs) span associated
623+ * with the current operation in which the log is being written.A Span
624+ * (https://docs.cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span)
629625 * represents a single operation within a trace. Whereas a trace may involve multiple different
630626 * microservices running on multiple different machines, a span generally corresponds to a single
631627 * logical operation being performed in a single instance of a microservice on one specific
632628 * machine. Spans are the nodes within the tree that is a trace.Applications that are instrumented
633- * for tracing (https://cloud.google.com/trace/docs/setup) will generally assign a new, unique
634- * span ID on each incoming request. It is also common to create and record additional spans
635- * corresponding to internal processing elements as well as issuing requests to dependencies.The
636- * span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte array and should
637- * not be zero. It should be unique within the trace and should, ideally, be generated in a manner
638- * that is uniformly random.Example values: 000000000000004a 7a2190356c3fc94b 0000f00300090021
639- * d39223e101960076
629+ * for tracing (https://docs. cloud.google.com/trace/docs/setup) will generally assign a new,
630+ * unique span ID on each incoming request. It is also common to create and record additional
631+ * spans corresponding to internal processing elements as well as issuing requests to
632+ * dependencies.The span ID is expected to be a 16-character, hexadecimal encoding of an 8-byte
633+ * array and should not be zero. It should be unique within the trace and should, ideally, be
634+ * generated in a manner that is uniformly random.Example values: 000000000000004a
635+ * 7a2190356c3fc94b 0000f00300090021 d39223e101960076
640636 * @param spanId spanId or {@code null} for none
641637 */
642638 public LogEntry setSpanId (java .lang .String spanId ) {
@@ -712,25 +708,29 @@ public LogEntry setTimestamp(String timestamp) {
712708 }
713709
714710 /**
715- * Optional. The REST resource name of the trace being written to Cloud Trace
716- * (https://cloud.google.com/trace) in association with this log entry. For example, if your trace
717- * data is stored in the Cloud project "my-trace-project" and if the service that is creating the
718- * log entry receives a trace header that includes the trace ID "12345", then the service should
719- * use "projects/my-trace-project/traces/12345".The trace field provides the link between logs and
720- * traces. By using this field, you can navigate from a log entry to a trace.
711+ * Optional. The trace ID being written to Cloud Trace (https://docs.cloud.google.com/trace/docs)
712+ * in association with this log entry. For example, if your trace data is stored in the Cloud
713+ * project "my-trace-project" and if the service that is creating the log entry receives a trace
714+ * header that includes the trace ID "12345", then the service should use "12345".The REST
715+ * resource name of the trace is also supported, but using this format is not recommended. An
716+ * example trace REST resource name is similar to "projects/my-trace-project/traces/12345".The
717+ * trace field provides the link between logs and traces. By using this field, you can navigate
718+ * from a log entry to a trace.
721719 * @return value or {@code null} for none
722720 */
723721 public java .lang .String getTrace () {
724722 return trace ;
725723 }
726724
727725 /**
728- * Optional. The REST resource name of the trace being written to Cloud Trace
729- * (https://cloud.google.com/trace) in association with this log entry. For example, if your trace
730- * data is stored in the Cloud project "my-trace-project" and if the service that is creating the
731- * log entry receives a trace header that includes the trace ID "12345", then the service should
732- * use "projects/my-trace-project/traces/12345".The trace field provides the link between logs and
733- * traces. By using this field, you can navigate from a log entry to a trace.
726+ * Optional. The trace ID being written to Cloud Trace (https://docs.cloud.google.com/trace/docs)
727+ * in association with this log entry. For example, if your trace data is stored in the Cloud
728+ * project "my-trace-project" and if the service that is creating the log entry receives a trace
729+ * header that includes the trace ID "12345", then the service should use "12345".The REST
730+ * resource name of the trace is also supported, but using this format is not recommended. An
731+ * example trace REST resource name is similar to "projects/my-trace-project/traces/12345".The
732+ * trace field provides the link between logs and traces. By using this field, you can navigate
733+ * from a log entry to a trace.
734734 * @param trace trace or {@code null} for none
735735 */
736736 public LogEntry setTrace (java .lang .String trace ) {
0 commit comments