Class Span.Builder

  • All Implemented Interfaces:
    com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, SpanOrBuilder, Cloneable
    Enclosing class:
    Span

    public static final class Span.Builder
    extends com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
    implements SpanOrBuilder
     A span represents a single operation within a trace. Spans can be
     nested to form a trace tree. Spans may also be linked to other spans
     from the same or different trace. And form graphs. 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 gaps or overlaps between spans in a trace.
     The next id is 17.
     TODO(bdrutu): Add an example.
     
    Protobuf type opencensus.proto.trace.v1.Span
    • Method Detail

      • getDescriptor

        public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()
      • internalGetFieldAccessorTable

        protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
        Specified by:
        internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • clear

        public Span.Builder clear()
        Specified by:
        clear in interface com.google.protobuf.Message.Builder
        Specified by:
        clear in interface com.google.protobuf.MessageLite.Builder
        Overrides:
        clear in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • getDescriptorForType

        public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
        Specified by:
        getDescriptorForType in interface com.google.protobuf.Message.Builder
        Specified by:
        getDescriptorForType in interface com.google.protobuf.MessageOrBuilder
        Overrides:
        getDescriptorForType in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • getDefaultInstanceForType

        public Span getDefaultInstanceForType()
        Specified by:
        getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
        Specified by:
        getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder
      • build

        public Span build()
        Specified by:
        build in interface com.google.protobuf.Message.Builder
        Specified by:
        build in interface com.google.protobuf.MessageLite.Builder
      • buildPartial

        public Span buildPartial()
        Specified by:
        buildPartial in interface com.google.protobuf.Message.Builder
        Specified by:
        buildPartial in interface com.google.protobuf.MessageLite.Builder
      • clone

        public Span.Builder clone()
        Specified by:
        clone in interface com.google.protobuf.Message.Builder
        Specified by:
        clone in interface com.google.protobuf.MessageLite.Builder
        Overrides:
        clone in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • setField

        public Span.Builder setField​(com.google.protobuf.Descriptors.FieldDescriptor field,
                                     Object value)
        Specified by:
        setField in interface com.google.protobuf.Message.Builder
        Overrides:
        setField in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • clearField

        public Span.Builder clearField​(com.google.protobuf.Descriptors.FieldDescriptor field)
        Specified by:
        clearField in interface com.google.protobuf.Message.Builder
        Overrides:
        clearField in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • clearOneof

        public Span.Builder clearOneof​(com.google.protobuf.Descriptors.OneofDescriptor oneof)
        Specified by:
        clearOneof in interface com.google.protobuf.Message.Builder
        Overrides:
        clearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • setRepeatedField

        public Span.Builder setRepeatedField​(com.google.protobuf.Descriptors.FieldDescriptor field,
                                             int index,
                                             Object value)
        Specified by:
        setRepeatedField in interface com.google.protobuf.Message.Builder
        Overrides:
        setRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • addRepeatedField

        public Span.Builder addRepeatedField​(com.google.protobuf.Descriptors.FieldDescriptor field,
                                             Object value)
        Specified by:
        addRepeatedField in interface com.google.protobuf.Message.Builder
        Overrides:
        addRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • mergeFrom

        public Span.Builder mergeFrom​(com.google.protobuf.Message other)
        Specified by:
        mergeFrom in interface com.google.protobuf.Message.Builder
        Overrides:
        mergeFrom in class com.google.protobuf.AbstractMessage.Builder<Span.Builder>
      • isInitialized

        public final boolean isInitialized()
        Specified by:
        isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
        Overrides:
        isInitialized in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • mergeFrom

        public Span.Builder mergeFrom​(com.google.protobuf.CodedInputStream input,
                                      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                               throws IOException
        Specified by:
        mergeFrom in interface com.google.protobuf.Message.Builder
        Specified by:
        mergeFrom in interface com.google.protobuf.MessageLite.Builder
        Overrides:
        mergeFrom in class com.google.protobuf.AbstractMessage.Builder<Span.Builder>
        Throws:
        IOException
      • getTraceId

        public com.google.protobuf.ByteString getTraceId()
         A unique identifier for a trace. All spans from the same trace share
         the same `trace_id`. The ID is a 16-byte array. An ID with all zeroes
         is considered invalid.
         This field is semantically required. Receiver should generate new
         random trace_id if empty or invalid trace_id was received.
         This field is required.
         
        bytes trace_id = 1;
        Specified by:
        getTraceId in interface SpanOrBuilder
        Returns:
        The traceId.
      • setTraceId

        public Span.Builder setTraceId​(com.google.protobuf.ByteString value)
         A unique identifier for a trace. All spans from the same trace share
         the same `trace_id`. The ID is a 16-byte array. An ID with all zeroes
         is considered invalid.
         This field is semantically required. Receiver should generate new
         random trace_id if empty or invalid trace_id was received.
         This field is required.
         
        bytes trace_id = 1;
        Parameters:
        value - The traceId to set.
        Returns:
        This builder for chaining.
      • clearTraceId

        public Span.Builder clearTraceId()
         A unique identifier for a trace. All spans from the same trace share
         the same `trace_id`. The ID is a 16-byte array. An ID with all zeroes
         is considered invalid.
         This field is semantically required. Receiver should generate new
         random trace_id if empty or invalid trace_id was received.
         This field is required.
         
        bytes trace_id = 1;
        Returns:
        This builder for chaining.
      • getSpanId

        public com.google.protobuf.ByteString getSpanId()
         A unique identifier for a span within a trace, assigned when the span
         is created. The ID is an 8-byte array. An ID with all zeroes is considered
         invalid.
         This field is semantically required. Receiver should generate new
         random span_id if empty or invalid span_id was received.
         This field is required.
         
        bytes span_id = 2;
        Specified by:
        getSpanId in interface SpanOrBuilder
        Returns:
        The spanId.
      • setSpanId

        public Span.Builder setSpanId​(com.google.protobuf.ByteString value)
         A unique identifier for a span within a trace, assigned when the span
         is created. The ID is an 8-byte array. An ID with all zeroes is considered
         invalid.
         This field is semantically required. Receiver should generate new
         random span_id if empty or invalid span_id was received.
         This field is required.
         
        bytes span_id = 2;
        Parameters:
        value - The spanId to set.
        Returns:
        This builder for chaining.
      • clearSpanId

        public Span.Builder clearSpanId()
         A unique identifier for a span within a trace, assigned when the span
         is created. The ID is an 8-byte array. An ID with all zeroes is considered
         invalid.
         This field is semantically required. Receiver should generate new
         random span_id if empty or invalid span_id was received.
         This field is required.
         
        bytes span_id = 2;
        Returns:
        This builder for chaining.
      • hasTracestate

        public boolean hasTracestate()
         The Tracestate on the span.
         
        .opencensus.proto.trace.v1.Span.Tracestate tracestate = 15;
        Specified by:
        hasTracestate in interface SpanOrBuilder
        Returns:
        Whether the tracestate field is set.
      • getTracestate

        public Span.Tracestate getTracestate()
         The Tracestate on the span.
         
        .opencensus.proto.trace.v1.Span.Tracestate tracestate = 15;
        Specified by:
        getTracestate in interface SpanOrBuilder
        Returns:
        The tracestate.
      • setTracestate

        public Span.Builder setTracestate​(Span.Tracestate value)
         The Tracestate on the span.
         
        .opencensus.proto.trace.v1.Span.Tracestate tracestate = 15;
      • setTracestate

        public Span.Builder setTracestate​(Span.Tracestate.Builder builderForValue)
         The Tracestate on the span.
         
        .opencensus.proto.trace.v1.Span.Tracestate tracestate = 15;
      • mergeTracestate

        public Span.Builder mergeTracestate​(Span.Tracestate value)
         The Tracestate on the span.
         
        .opencensus.proto.trace.v1.Span.Tracestate tracestate = 15;
      • clearTracestate

        public Span.Builder clearTracestate()
         The Tracestate on the span.
         
        .opencensus.proto.trace.v1.Span.Tracestate tracestate = 15;
      • getTracestateBuilder

        public Span.Tracestate.Builder getTracestateBuilder()
         The Tracestate on the span.
         
        .opencensus.proto.trace.v1.Span.Tracestate tracestate = 15;
      • getParentSpanId

        public com.google.protobuf.ByteString getParentSpanId()
         The `span_id` of this span's parent span. If this is a root span, then this
         field must be empty. The ID is an 8-byte array.
         
        bytes parent_span_id = 3;
        Specified by:
        getParentSpanId in interface SpanOrBuilder
        Returns:
        The parentSpanId.
      • setParentSpanId

        public Span.Builder setParentSpanId​(com.google.protobuf.ByteString value)
         The `span_id` of this span's parent span. If this is a root span, then this
         field must be empty. The ID is an 8-byte array.
         
        bytes parent_span_id = 3;
        Parameters:
        value - The parentSpanId to set.
        Returns:
        This builder for chaining.
      • clearParentSpanId

        public Span.Builder clearParentSpanId()
         The `span_id` of this span's parent span. If this is a root span, then this
         field must be empty. The ID is an 8-byte array.
         
        bytes parent_span_id = 3;
        Returns:
        This builder for chaining.
      • hasName

        public boolean hasName()
         A description of the span's operation.
         For example, the 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 at the same call point in an application.
         This makes it easier to correlate spans in different traces.
         This field is semantically required to be set to non-empty string.
         When null or empty string received - receiver may use string "name"
         as a replacement. There might be smarted algorithms implemented by
         receiver to fix the empty span name.
         This field is required.
         
        .opencensus.proto.trace.v1.TruncatableString name = 4;
        Specified by:
        hasName in interface SpanOrBuilder
        Returns:
        Whether the name field is set.
      • getName

        public TruncatableString getName()
         A description of the span's operation.
         For example, the 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 at the same call point in an application.
         This makes it easier to correlate spans in different traces.
         This field is semantically required to be set to non-empty string.
         When null or empty string received - receiver may use string "name"
         as a replacement. There might be smarted algorithms implemented by
         receiver to fix the empty span name.
         This field is required.
         
        .opencensus.proto.trace.v1.TruncatableString name = 4;
        Specified by:
        getName in interface SpanOrBuilder
        Returns:
        The name.
      • setName

        public Span.Builder setName​(TruncatableString value)
         A description of the span's operation.
         For example, the 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 at the same call point in an application.
         This makes it easier to correlate spans in different traces.
         This field is semantically required to be set to non-empty string.
         When null or empty string received - receiver may use string "name"
         as a replacement. There might be smarted algorithms implemented by
         receiver to fix the empty span name.
         This field is required.
         
        .opencensus.proto.trace.v1.TruncatableString name = 4;
      • setName

        public Span.Builder setName​(TruncatableString.Builder builderForValue)
         A description of the span's operation.
         For example, the 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 at the same call point in an application.
         This makes it easier to correlate spans in different traces.
         This field is semantically required to be set to non-empty string.
         When null or empty string received - receiver may use string "name"
         as a replacement. There might be smarted algorithms implemented by
         receiver to fix the empty span name.
         This field is required.
         
        .opencensus.proto.trace.v1.TruncatableString name = 4;
      • mergeName

        public Span.Builder mergeName​(TruncatableString value)
         A description of the span's operation.
         For example, the 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 at the same call point in an application.
         This makes it easier to correlate spans in different traces.
         This field is semantically required to be set to non-empty string.
         When null or empty string received - receiver may use string "name"
         as a replacement. There might be smarted algorithms implemented by
         receiver to fix the empty span name.
         This field is required.
         
        .opencensus.proto.trace.v1.TruncatableString name = 4;
      • clearName

        public Span.Builder clearName()
         A description of the span's operation.
         For example, the 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 at the same call point in an application.
         This makes it easier to correlate spans in different traces.
         This field is semantically required to be set to non-empty string.
         When null or empty string received - receiver may use string "name"
         as a replacement. There might be smarted algorithms implemented by
         receiver to fix the empty span name.
         This field is required.
         
        .opencensus.proto.trace.v1.TruncatableString name = 4;
      • getNameBuilder

        public TruncatableString.Builder getNameBuilder()
         A description of the span's operation.
         For example, the 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 at the same call point in an application.
         This makes it easier to correlate spans in different traces.
         This field is semantically required to be set to non-empty string.
         When null or empty string received - receiver may use string "name"
         as a replacement. There might be smarted algorithms implemented by
         receiver to fix the empty span name.
         This field is required.
         
        .opencensus.proto.trace.v1.TruncatableString name = 4;
      • getNameOrBuilder

        public TruncatableStringOrBuilder getNameOrBuilder()
         A description of the span's operation.
         For example, the 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 at the same call point in an application.
         This makes it easier to correlate spans in different traces.
         This field is semantically required to be set to non-empty string.
         When null or empty string received - receiver may use string "name"
         as a replacement. There might be smarted algorithms implemented by
         receiver to fix the empty span name.
         This field is required.
         
        .opencensus.proto.trace.v1.TruncatableString name = 4;
        Specified by:
        getNameOrBuilder in interface SpanOrBuilder
      • getKindValue

        public int getKindValue()
         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 queueing latency associated with the span.
         
        .opencensus.proto.trace.v1.Span.SpanKind kind = 14;
        Specified by:
        getKindValue in interface SpanOrBuilder
        Returns:
        The enum numeric value on the wire for kind.
      • setKindValue

        public Span.Builder setKindValue​(int value)
         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 queueing latency associated with the span.
         
        .opencensus.proto.trace.v1.Span.SpanKind kind = 14;
        Parameters:
        value - The enum numeric value on the wire for kind to set.
        Returns:
        This builder for chaining.
      • getKind

        public Span.SpanKind getKind()
         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 queueing latency associated with the span.
         
        .opencensus.proto.trace.v1.Span.SpanKind kind = 14;
        Specified by:
        getKind in interface SpanOrBuilder
        Returns:
        The kind.
      • setKind

        public Span.Builder setKind​(Span.SpanKind value)
         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 queueing latency associated with the span.
         
        .opencensus.proto.trace.v1.Span.SpanKind kind = 14;
        Parameters:
        value - The kind to set.
        Returns:
        This builder for chaining.
      • clearKind

        public Span.Builder clearKind()
         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 queueing latency associated with the span.
         
        .opencensus.proto.trace.v1.Span.SpanKind kind = 14;
        Returns:
        This builder for chaining.
      • hasStartTime

        public boolean hasStartTime()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to the value of end_time field if it was
         set. Or to the current time if neither was set. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp start_time = 5;
        Specified by:
        hasStartTime in interface SpanOrBuilder
        Returns:
        Whether the startTime field is set.
      • getStartTime

        public com.google.protobuf.Timestamp getStartTime()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to the value of end_time field if it was
         set. Or to the current time if neither was set. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp start_time = 5;
        Specified by:
        getStartTime in interface SpanOrBuilder
        Returns:
        The startTime.
      • setStartTime

        public Span.Builder setStartTime​(com.google.protobuf.Timestamp value)
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to the value of end_time field if it was
         set. Or to the current time if neither was set. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp start_time = 5;
      • setStartTime

        public Span.Builder setStartTime​(com.google.protobuf.Timestamp.Builder builderForValue)
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to the value of end_time field if it was
         set. Or to the current time if neither was set. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp start_time = 5;
      • mergeStartTime

        public Span.Builder mergeStartTime​(com.google.protobuf.Timestamp value)
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to the value of end_time field if it was
         set. Or to the current time if neither was set. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp start_time = 5;
      • clearStartTime

        public Span.Builder clearStartTime()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to the value of end_time field if it was
         set. Or to the current time if neither was set. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp start_time = 5;
      • getStartTimeBuilder

        public com.google.protobuf.Timestamp.Builder getStartTimeBuilder()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to the value of end_time field if it was
         set. Or to the current time if neither was set. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp start_time = 5;
      • getStartTimeOrBuilder

        public com.google.protobuf.TimestampOrBuilder getStartTimeOrBuilder()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to the value of end_time field if it was
         set. Or to the current time if neither was set. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp start_time = 5;
        Specified by:
        getStartTimeOrBuilder in interface SpanOrBuilder
      • hasEndTime

        public boolean hasEndTime()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to start_time value. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp end_time = 6;
        Specified by:
        hasEndTime in interface SpanOrBuilder
        Returns:
        Whether the endTime field is set.
      • getEndTime

        public com.google.protobuf.Timestamp getEndTime()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to start_time value. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp end_time = 6;
        Specified by:
        getEndTime in interface SpanOrBuilder
        Returns:
        The endTime.
      • setEndTime

        public Span.Builder setEndTime​(com.google.protobuf.Timestamp value)
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to start_time value. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp end_time = 6;
      • setEndTime

        public Span.Builder setEndTime​(com.google.protobuf.Timestamp.Builder builderForValue)
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to start_time value. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp end_time = 6;
      • mergeEndTime

        public Span.Builder mergeEndTime​(com.google.protobuf.Timestamp value)
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to start_time value. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp end_time = 6;
      • clearEndTime

        public Span.Builder clearEndTime()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to start_time value. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp end_time = 6;
      • getEndTimeBuilder

        public com.google.protobuf.Timestamp.Builder getEndTimeBuilder()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to start_time value. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp end_time = 6;
      • getEndTimeOrBuilder

        public com.google.protobuf.TimestampOrBuilder getEndTimeOrBuilder()
         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.
         This field is semantically required. When not set on receive -
         receiver should set it to start_time value. It is important to
         keep end_time > start_time for consistency.
         This field is required.
         
        .google.protobuf.Timestamp end_time = 6;
        Specified by:
        getEndTimeOrBuilder in interface SpanOrBuilder
      • hasAttributes

        public boolean hasAttributes()
         A set of attributes on the span.
         
        .opencensus.proto.trace.v1.Span.Attributes attributes = 7;
        Specified by:
        hasAttributes in interface SpanOrBuilder
        Returns:
        Whether the attributes field is set.
      • getAttributes

        public Span.Attributes getAttributes()
         A set of attributes on the span.
         
        .opencensus.proto.trace.v1.Span.Attributes attributes = 7;
        Specified by:
        getAttributes in interface SpanOrBuilder
        Returns:
        The attributes.
      • setAttributes

        public Span.Builder setAttributes​(Span.Attributes value)
         A set of attributes on the span.
         
        .opencensus.proto.trace.v1.Span.Attributes attributes = 7;
      • setAttributes

        public Span.Builder setAttributes​(Span.Attributes.Builder builderForValue)
         A set of attributes on the span.
         
        .opencensus.proto.trace.v1.Span.Attributes attributes = 7;
      • mergeAttributes

        public Span.Builder mergeAttributes​(Span.Attributes value)
         A set of attributes on the span.
         
        .opencensus.proto.trace.v1.Span.Attributes attributes = 7;
      • clearAttributes

        public Span.Builder clearAttributes()
         A set of attributes on the span.
         
        .opencensus.proto.trace.v1.Span.Attributes attributes = 7;
      • getAttributesBuilder

        public Span.Attributes.Builder getAttributesBuilder()
         A set of attributes on the span.
         
        .opencensus.proto.trace.v1.Span.Attributes attributes = 7;
      • hasStackTrace

        public boolean hasStackTrace()
         A stack trace captured at the start of the span.
         
        .opencensus.proto.trace.v1.StackTrace stack_trace = 8;
        Specified by:
        hasStackTrace in interface SpanOrBuilder
        Returns:
        Whether the stackTrace field is set.
      • getStackTrace

        public StackTrace getStackTrace()
         A stack trace captured at the start of the span.
         
        .opencensus.proto.trace.v1.StackTrace stack_trace = 8;
        Specified by:
        getStackTrace in interface SpanOrBuilder
        Returns:
        The stackTrace.
      • setStackTrace

        public Span.Builder setStackTrace​(StackTrace value)
         A stack trace captured at the start of the span.
         
        .opencensus.proto.trace.v1.StackTrace stack_trace = 8;
      • setStackTrace

        public Span.Builder setStackTrace​(StackTrace.Builder builderForValue)
         A stack trace captured at the start of the span.
         
        .opencensus.proto.trace.v1.StackTrace stack_trace = 8;
      • mergeStackTrace

        public Span.Builder mergeStackTrace​(StackTrace value)
         A stack trace captured at the start of the span.
         
        .opencensus.proto.trace.v1.StackTrace stack_trace = 8;
      • clearStackTrace

        public Span.Builder clearStackTrace()
         A stack trace captured at the start of the span.
         
        .opencensus.proto.trace.v1.StackTrace stack_trace = 8;
      • getStackTraceBuilder

        public StackTrace.Builder getStackTraceBuilder()
         A stack trace captured at the start of the span.
         
        .opencensus.proto.trace.v1.StackTrace stack_trace = 8;
      • hasTimeEvents

        public boolean hasTimeEvents()
         The included time events.
         
        .opencensus.proto.trace.v1.Span.TimeEvents time_events = 9;
        Specified by:
        hasTimeEvents in interface SpanOrBuilder
        Returns:
        Whether the timeEvents field is set.
      • getTimeEvents

        public Span.TimeEvents getTimeEvents()
         The included time events.
         
        .opencensus.proto.trace.v1.Span.TimeEvents time_events = 9;
        Specified by:
        getTimeEvents in interface SpanOrBuilder
        Returns:
        The timeEvents.
      • setTimeEvents

        public Span.Builder setTimeEvents​(Span.TimeEvents value)
         The included time events.
         
        .opencensus.proto.trace.v1.Span.TimeEvents time_events = 9;
      • setTimeEvents

        public Span.Builder setTimeEvents​(Span.TimeEvents.Builder builderForValue)
         The included time events.
         
        .opencensus.proto.trace.v1.Span.TimeEvents time_events = 9;
      • mergeTimeEvents

        public Span.Builder mergeTimeEvents​(Span.TimeEvents value)
         The included time events.
         
        .opencensus.proto.trace.v1.Span.TimeEvents time_events = 9;
      • clearTimeEvents

        public Span.Builder clearTimeEvents()
         The included time events.
         
        .opencensus.proto.trace.v1.Span.TimeEvents time_events = 9;
      • getTimeEventsBuilder

        public Span.TimeEvents.Builder getTimeEventsBuilder()
         The included time events.
         
        .opencensus.proto.trace.v1.Span.TimeEvents time_events = 9;
      • hasLinks

        public boolean hasLinks()
         The included links.
         
        .opencensus.proto.trace.v1.Span.Links links = 10;
        Specified by:
        hasLinks in interface SpanOrBuilder
        Returns:
        Whether the links field is set.
      • getLinks

        public Span.Links getLinks()
         The included links.
         
        .opencensus.proto.trace.v1.Span.Links links = 10;
        Specified by:
        getLinks in interface SpanOrBuilder
        Returns:
        The links.
      • setLinks

        public Span.Builder setLinks​(Span.Links value)
         The included links.
         
        .opencensus.proto.trace.v1.Span.Links links = 10;
      • setLinks

        public Span.Builder setLinks​(Span.Links.Builder builderForValue)
         The included links.
         
        .opencensus.proto.trace.v1.Span.Links links = 10;
      • mergeLinks

        public Span.Builder mergeLinks​(Span.Links value)
         The included links.
         
        .opencensus.proto.trace.v1.Span.Links links = 10;
      • clearLinks

        public Span.Builder clearLinks()
         The included links.
         
        .opencensus.proto.trace.v1.Span.Links links = 10;
      • getLinksBuilder

        public Span.Links.Builder getLinksBuilder()
         The included links.
         
        .opencensus.proto.trace.v1.Span.Links links = 10;
      • hasStatus

        public boolean hasStatus()
         An optional final status for this span. Semantically when Status
         wasn't set it is means span ended without errors and assume
         Status.Ok (code = 0).
         
        .opencensus.proto.trace.v1.Status status = 11;
        Specified by:
        hasStatus in interface SpanOrBuilder
        Returns:
        Whether the status field is set.
      • getStatus

        public Status getStatus()
         An optional final status for this span. Semantically when Status
         wasn't set it is means span ended without errors and assume
         Status.Ok (code = 0).
         
        .opencensus.proto.trace.v1.Status status = 11;
        Specified by:
        getStatus in interface SpanOrBuilder
        Returns:
        The status.
      • setStatus

        public Span.Builder setStatus​(Status value)
         An optional final status for this span. Semantically when Status
         wasn't set it is means span ended without errors and assume
         Status.Ok (code = 0).
         
        .opencensus.proto.trace.v1.Status status = 11;
      • setStatus

        public Span.Builder setStatus​(Status.Builder builderForValue)
         An optional final status for this span. Semantically when Status
         wasn't set it is means span ended without errors and assume
         Status.Ok (code = 0).
         
        .opencensus.proto.trace.v1.Status status = 11;
      • mergeStatus

        public Span.Builder mergeStatus​(Status value)
         An optional final status for this span. Semantically when Status
         wasn't set it is means span ended without errors and assume
         Status.Ok (code = 0).
         
        .opencensus.proto.trace.v1.Status status = 11;
      • clearStatus

        public Span.Builder clearStatus()
         An optional final status for this span. Semantically when Status
         wasn't set it is means span ended without errors and assume
         Status.Ok (code = 0).
         
        .opencensus.proto.trace.v1.Status status = 11;
      • getStatusBuilder

        public Status.Builder getStatusBuilder()
         An optional final status for this span. Semantically when Status
         wasn't set it is means span ended without errors and assume
         Status.Ok (code = 0).
         
        .opencensus.proto.trace.v1.Status status = 11;
      • getStatusOrBuilder

        public StatusOrBuilder getStatusOrBuilder()
         An optional final status for this span. Semantically when Status
         wasn't set it is means span ended without errors and assume
         Status.Ok (code = 0).
         
        .opencensus.proto.trace.v1.Status status = 11;
        Specified by:
        getStatusOrBuilder in interface SpanOrBuilder
      • hasResource

        public boolean hasResource()
         An optional resource that is associated with this span. If not set, this span 
         should be part of a batch that does include the resource information, unless resource 
         information is unknown.
         
        .opencensus.proto.resource.v1.Resource resource = 16;
        Specified by:
        hasResource in interface SpanOrBuilder
        Returns:
        Whether the resource field is set.
      • getResource

        public Resource getResource()
         An optional resource that is associated with this span. If not set, this span 
         should be part of a batch that does include the resource information, unless resource 
         information is unknown.
         
        .opencensus.proto.resource.v1.Resource resource = 16;
        Specified by:
        getResource in interface SpanOrBuilder
        Returns:
        The resource.
      • setResource

        public Span.Builder setResource​(Resource value)
         An optional resource that is associated with this span. If not set, this span 
         should be part of a batch that does include the resource information, unless resource 
         information is unknown.
         
        .opencensus.proto.resource.v1.Resource resource = 16;
      • setResource

        public Span.Builder setResource​(Resource.Builder builderForValue)
         An optional resource that is associated with this span. If not set, this span 
         should be part of a batch that does include the resource information, unless resource 
         information is unknown.
         
        .opencensus.proto.resource.v1.Resource resource = 16;
      • mergeResource

        public Span.Builder mergeResource​(Resource value)
         An optional resource that is associated with this span. If not set, this span 
         should be part of a batch that does include the resource information, unless resource 
         information is unknown.
         
        .opencensus.proto.resource.v1.Resource resource = 16;
      • clearResource

        public Span.Builder clearResource()
         An optional resource that is associated with this span. If not set, this span 
         should be part of a batch that does include the resource information, unless resource 
         information is unknown.
         
        .opencensus.proto.resource.v1.Resource resource = 16;
      • getResourceBuilder

        public Resource.Builder getResourceBuilder()
         An optional resource that is associated with this span. If not set, this span 
         should be part of a batch that does include the resource information, unless resource 
         information is unknown.
         
        .opencensus.proto.resource.v1.Resource resource = 16;
      • getResourceOrBuilder

        public ResourceOrBuilder getResourceOrBuilder()
         An optional resource that is associated with this span. If not set, this span 
         should be part of a batch that does include the resource information, unless resource 
         information is unknown.
         
        .opencensus.proto.resource.v1.Resource resource = 16;
        Specified by:
        getResourceOrBuilder in interface SpanOrBuilder
      • hasSameProcessAsParentSpan

        public boolean hasSameProcessAsParentSpan()
         A highly recommended but not required flag that identifies when a
         trace crosses a process boundary. True when the parent_span belongs
         to the same process as the current span. This flag is most commonly
         used to indicate the need to adjust time as clocks in different
         processes may not be synchronized.
         
        .google.protobuf.BoolValue same_process_as_parent_span = 12;
        Specified by:
        hasSameProcessAsParentSpan in interface SpanOrBuilder
        Returns:
        Whether the sameProcessAsParentSpan field is set.
      • getSameProcessAsParentSpan

        public com.google.protobuf.BoolValue getSameProcessAsParentSpan()
         A highly recommended but not required flag that identifies when a
         trace crosses a process boundary. True when the parent_span belongs
         to the same process as the current span. This flag is most commonly
         used to indicate the need to adjust time as clocks in different
         processes may not be synchronized.
         
        .google.protobuf.BoolValue same_process_as_parent_span = 12;
        Specified by:
        getSameProcessAsParentSpan in interface SpanOrBuilder
        Returns:
        The sameProcessAsParentSpan.
      • setSameProcessAsParentSpan

        public Span.Builder setSameProcessAsParentSpan​(com.google.protobuf.BoolValue value)
         A highly recommended but not required flag that identifies when a
         trace crosses a process boundary. True when the parent_span belongs
         to the same process as the current span. This flag is most commonly
         used to indicate the need to adjust time as clocks in different
         processes may not be synchronized.
         
        .google.protobuf.BoolValue same_process_as_parent_span = 12;
      • setSameProcessAsParentSpan

        public Span.Builder setSameProcessAsParentSpan​(com.google.protobuf.BoolValue.Builder builderForValue)
         A highly recommended but not required flag that identifies when a
         trace crosses a process boundary. True when the parent_span belongs
         to the same process as the current span. This flag is most commonly
         used to indicate the need to adjust time as clocks in different
         processes may not be synchronized.
         
        .google.protobuf.BoolValue same_process_as_parent_span = 12;
      • mergeSameProcessAsParentSpan

        public Span.Builder mergeSameProcessAsParentSpan​(com.google.protobuf.BoolValue value)
         A highly recommended but not required flag that identifies when a
         trace crosses a process boundary. True when the parent_span belongs
         to the same process as the current span. This flag is most commonly
         used to indicate the need to adjust time as clocks in different
         processes may not be synchronized.
         
        .google.protobuf.BoolValue same_process_as_parent_span = 12;
      • clearSameProcessAsParentSpan

        public Span.Builder clearSameProcessAsParentSpan()
         A highly recommended but not required flag that identifies when a
         trace crosses a process boundary. True when the parent_span belongs
         to the same process as the current span. This flag is most commonly
         used to indicate the need to adjust time as clocks in different
         processes may not be synchronized.
         
        .google.protobuf.BoolValue same_process_as_parent_span = 12;
      • getSameProcessAsParentSpanBuilder

        public com.google.protobuf.BoolValue.Builder getSameProcessAsParentSpanBuilder()
         A highly recommended but not required flag that identifies when a
         trace crosses a process boundary. True when the parent_span belongs
         to the same process as the current span. This flag is most commonly
         used to indicate the need to adjust time as clocks in different
         processes may not be synchronized.
         
        .google.protobuf.BoolValue same_process_as_parent_span = 12;
      • getSameProcessAsParentSpanOrBuilder

        public com.google.protobuf.BoolValueOrBuilder getSameProcessAsParentSpanOrBuilder()
         A highly recommended but not required flag that identifies when a
         trace crosses a process boundary. True when the parent_span belongs
         to the same process as the current span. This flag is most commonly
         used to indicate the need to adjust time as clocks in different
         processes may not be synchronized.
         
        .google.protobuf.BoolValue same_process_as_parent_span = 12;
        Specified by:
        getSameProcessAsParentSpanOrBuilder in interface SpanOrBuilder
      • hasChildSpanCount

        public boolean hasChildSpanCount()
         An optional number of child spans that were generated while this span
         was active. If set, allows an implementation to detect missing child spans.
         
        .google.protobuf.UInt32Value child_span_count = 13;
        Specified by:
        hasChildSpanCount in interface SpanOrBuilder
        Returns:
        Whether the childSpanCount field is set.
      • getChildSpanCount

        public com.google.protobuf.UInt32Value getChildSpanCount()
         An optional number of child spans that were generated while this span
         was active. If set, allows an implementation to detect missing child spans.
         
        .google.protobuf.UInt32Value child_span_count = 13;
        Specified by:
        getChildSpanCount in interface SpanOrBuilder
        Returns:
        The childSpanCount.
      • setChildSpanCount

        public Span.Builder setChildSpanCount​(com.google.protobuf.UInt32Value value)
         An optional number of child spans that were generated while this span
         was active. If set, allows an implementation to detect missing child spans.
         
        .google.protobuf.UInt32Value child_span_count = 13;
      • setChildSpanCount

        public Span.Builder setChildSpanCount​(com.google.protobuf.UInt32Value.Builder builderForValue)
         An optional number of child spans that were generated while this span
         was active. If set, allows an implementation to detect missing child spans.
         
        .google.protobuf.UInt32Value child_span_count = 13;
      • mergeChildSpanCount

        public Span.Builder mergeChildSpanCount​(com.google.protobuf.UInt32Value value)
         An optional number of child spans that were generated while this span
         was active. If set, allows an implementation to detect missing child spans.
         
        .google.protobuf.UInt32Value child_span_count = 13;
      • clearChildSpanCount

        public Span.Builder clearChildSpanCount()
         An optional number of child spans that were generated while this span
         was active. If set, allows an implementation to detect missing child spans.
         
        .google.protobuf.UInt32Value child_span_count = 13;
      • getChildSpanCountBuilder

        public com.google.protobuf.UInt32Value.Builder getChildSpanCountBuilder()
         An optional number of child spans that were generated while this span
         was active. If set, allows an implementation to detect missing child spans.
         
        .google.protobuf.UInt32Value child_span_count = 13;
      • getChildSpanCountOrBuilder

        public com.google.protobuf.UInt32ValueOrBuilder getChildSpanCountOrBuilder()
         An optional number of child spans that were generated while this span
         was active. If set, allows an implementation to detect missing child spans.
         
        .google.protobuf.UInt32Value child_span_count = 13;
        Specified by:
        getChildSpanCountOrBuilder in interface SpanOrBuilder
      • setUnknownFields

        public final Span.Builder setUnknownFields​(com.google.protobuf.UnknownFieldSet unknownFields)
        Specified by:
        setUnknownFields in interface com.google.protobuf.Message.Builder
        Overrides:
        setUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>
      • mergeUnknownFields

        public final Span.Builder mergeUnknownFields​(com.google.protobuf.UnknownFieldSet unknownFields)
        Specified by:
        mergeUnknownFields in interface com.google.protobuf.Message.Builder
        Overrides:
        mergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<Span.Builder>