Package io.opentelemetry.proto.trace.v1

Class Span.Link

java.lang.Object
com.google.protobuf.AbstractMessageLite
com.google.protobuf.AbstractMessage
com.google.protobuf.GeneratedMessage
io.opentelemetry.proto.trace.v1.Span.Link
All Implemented Interfaces:
com.google.protobuf.Message, com.google.protobuf.MessageLite, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, Span.LinkOrBuilder, Serializable
Enclosing class:
Span
public static final class Span.Link extends com.google.protobuf.GeneratedMessage implements Span.LinkOrBuilder
 A pointer from the current span to another span in the same trace or in a
 different trace. For example, this can be used in batching operations,
 where a single batch handler processes multiple requests from different
 traces or when the handler receives a request from a different project.
Protobuf type opentelemetry.proto.trace.v1.Span.Link
See Also:

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static final class 
    Span.Link.Builder
    A pointer from the current span to another span in the same trace or in a different trace.

    Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessage

    com.google.protobuf.GeneratedMessage.ExtendableBuilder<MessageT extends com.google.protobuf.GeneratedMessage.ExtendableMessage<MessageT>,BuilderT extends com.google.protobuf.GeneratedMessage.ExtendableBuilder<MessageT,BuilderT>>, com.google.protobuf.GeneratedMessage.ExtendableMessage<MessageT extends com.google.protobuf.GeneratedMessage.ExtendableMessage<MessageT>>, com.google.protobuf.GeneratedMessage.ExtendableMessageOrBuilder<MessageT extends com.google.protobuf.GeneratedMessage.ExtendableMessage<MessageT>>, com.google.protobuf.GeneratedMessage.FieldAccessorTable, com.google.protobuf.GeneratedMessage.GeneratedExtension<ContainingT extends com.google.protobuf.Message,T extends Object>, com.google.protobuf.GeneratedMessage.UnusedPrivateParameter

    Nested classes/interfaces inherited from class com.google.protobuf.AbstractMessage

    com.google.protobuf.AbstractMessage.BuilderParent

    Nested classes/interfaces inherited from class com.google.protobuf.AbstractMessageLite

    com.google.protobuf.AbstractMessageLite.InternalOneOfEnum

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    ATTRIBUTES_FIELD_NUMBER
     
    static final int
    DROPPED_ATTRIBUTES_COUNT_FIELD_NUMBER
     
    static final int
    FLAGS_FIELD_NUMBER
     
    static final int
    SPAN_ID_FIELD_NUMBER
     
    static final int
    TRACE_ID_FIELD_NUMBER
     
    static final int
    TRACE_STATE_FIELD_NUMBER
     

    Fields inherited from class com.google.protobuf.GeneratedMessage

    alwaysUseFieldBuilders, loggedPre22TypeNames, unknownFields

    Fields inherited from class com.google.protobuf.AbstractMessage

    memoizedSize

    Fields inherited from class com.google.protobuf.AbstractMessageLite

    memoizedHashCode

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    equals(Object obj)
     
    KeyValue
    getAttributes(int index)
    attributes is a collection of attribute key/value pairs on the link.
    int
    getAttributesCount()
    attributes is a collection of attribute key/value pairs on the link.
    List<KeyValue>
    getAttributesList()
    attributes is a collection of attribute key/value pairs on the link.
    KeyValueOrBuilder
    getAttributesOrBuilder(int index)
    attributes is a collection of attribute key/value pairs on the link.
    List<? extends KeyValueOrBuilder>
    getAttributesOrBuilderList()
    attributes is a collection of attribute key/value pairs on the link.
    static Span.Link
    getDefaultInstance()
     
    Span.Link
    getDefaultInstanceForType()
     
    static final com.google.protobuf.Descriptors.Descriptor
    getDescriptor()
     
    int
    getDroppedAttributesCount()
    dropped_attributes_count is the number of dropped attributes.
    int
    getFlags()
    Flags, a bit field.
    com.google.protobuf.Parser<Span.Link>
    getParserForType()
     
    int
    getSerializedSize()
     
    com.google.protobuf.ByteString
    getSpanId()
    A unique identifier for the linked span.
    com.google.protobuf.ByteString
    getTraceId()
    A unique identifier of a trace that this linked span is part of.
    String
    getTraceState()
    The trace_state associated with the link.
    com.google.protobuf.ByteString
    getTraceStateBytes()
    The trace_state associated with the link.
    int
    hashCode()
     
    protected com.google.protobuf.GeneratedMessage.FieldAccessorTable
    internalGetFieldAccessorTable()
     
    final boolean
    isInitialized()
     
    static Span.Link.Builder
    newBuilder()
     
    static Span.Link.Builder
    newBuilder(Span.Link prototype)
     
    Span.Link.Builder
    newBuilderForType()
     
    protected Span.Link.Builder
    newBuilderForType(com.google.protobuf.AbstractMessage.BuilderParent parent)
     
    static Span.Link
    parseDelimitedFrom(InputStream input)
     
    static Span.Link
    parseDelimitedFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static Span.Link
    parseFrom(byte[] data)
     
    static Span.Link
    parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static Span.Link
    parseFrom(com.google.protobuf.ByteString data)
     
    static Span.Link
    parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static Span.Link
    parseFrom(com.google.protobuf.CodedInputStream input)
     
    static Span.Link
    parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static Span.Link
    parseFrom(InputStream input)
     
    static Span.Link
    parseFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static Span.Link
    parseFrom(ByteBuffer data)
     
    static Span.Link
    parseFrom(ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
     
    static com.google.protobuf.Parser<Span.Link>
    parser()
     
    Span.Link.Builder
    toBuilder()
     
    void
    writeTo(com.google.protobuf.CodedOutputStream output)
     

    Methods inherited from class com.google.protobuf.GeneratedMessage

    canUseUnsafe, computeStringSize, computeStringSizeNoTag, emptyBooleanList, emptyDoubleList, emptyFloatList, emptyIntList, emptyList, emptyLongList, getAllFields, getDescriptorForType, getField, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof, internalGetMapField, internalGetMapFieldReflection, isStringEmpty, makeExtensionsImmutable, makeMutableCopy, makeMutableCopy, mergeFromAndMakeImmutableInternal, newFileScopedGeneratedExtension, newInstance, newMessageScopedGeneratedExtension, parseDelimitedWithIOException, parseDelimitedWithIOException, parseUnknownField, parseUnknownFieldProto3, parseWithIOException, parseWithIOException, parseWithIOException, parseWithIOException, serializeBooleanMapTo, serializeIntegerMapTo, serializeLongMapTo, serializeStringMapTo, writeReplace, writeString, writeStringNoTag

    Methods inherited from class com.google.protobuf.AbstractMessage

    findInitializationErrors, getInitializationErrorString, hashFields, toString

    Methods inherited from class com.google.protobuf.AbstractMessageLite

    addAll, checkByteStringIsUtf8, toByteArray, toByteString, writeDelimitedTo, writeTo

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

    Methods inherited from interface com.google.protobuf.MessageLite

    toByteArray, toByteString, writeDelimitedTo, writeTo

    Methods inherited from interface com.google.protobuf.MessageOrBuilder

    findInitializationErrors, getAllFields, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof

  • Field Details

    • TRACE_ID_FIELD_NUMBER

      public static final int TRACE_ID_FIELD_NUMBER
      See Also:

    • SPAN_ID_FIELD_NUMBER

      public static final int SPAN_ID_FIELD_NUMBER
      See Also:

    • TRACE_STATE_FIELD_NUMBER

      public static final int TRACE_STATE_FIELD_NUMBER
      See Also:

    • ATTRIBUTES_FIELD_NUMBER

      public static final int ATTRIBUTES_FIELD_NUMBER
      See Also:

    • DROPPED_ATTRIBUTES_COUNT_FIELD_NUMBER

      public static final int DROPPED_ATTRIBUTES_COUNT_FIELD_NUMBER
      See Also:

    • FLAGS_FIELD_NUMBER

      public static final int FLAGS_FIELD_NUMBER
      See Also:

  • Method Details

    • getDescriptor

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

    • internalGetFieldAccessorTable

      protected com.google.protobuf.GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()
      Specified by:
      internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessage

    • getTraceId

      public com.google.protobuf.ByteString getTraceId()
       A unique identifier of a trace that this linked span is part of. The ID is a
 16-byte array.
      bytes trace_id = 1;
      Specified by:
      getTraceId in interface Span.LinkOrBuilder
      Returns:
      The traceId.

    • getSpanId

      public com.google.protobuf.ByteString getSpanId()
       A unique identifier for the linked span. The ID is an 8-byte array.
      bytes span_id = 2;
      Specified by:
      getSpanId in interface Span.LinkOrBuilder
      Returns:
      The spanId.

    • getTraceState

      public String getTraceState()
       The trace_state associated with the link.
      string trace_state = 3;
      Specified by:
      getTraceState in interface Span.LinkOrBuilder
      Returns:
      The traceState.

    • getTraceStateBytes

      public com.google.protobuf.ByteString getTraceStateBytes()
       The trace_state associated with the link.
      string trace_state = 3;
      Specified by:
      getTraceStateBytes in interface Span.LinkOrBuilder
      Returns:
      The bytes for traceState.

    • getAttributesList

      public List<KeyValue> getAttributesList()
       attributes is a collection of attribute key/value pairs on the link.
 Attribute keys MUST be unique (it is not allowed to have more than one
 attribute with the same key).

 The attribute values SHOULD NOT contain empty values.
 The attribute values SHOULD NOT contain bytes values.
 The attribute values SHOULD NOT contain array values different than array of string values, bool values, int values,
 double values.
 The attribute values SHOULD NOT contain kvlist values.
 The behavior of software that receives attributes containing such values can be unpredictable.
 These restrictions can change in a minor release.
 The restrictions take origin from the OpenTelemetry specification:
 https://github.com/open-telemetry/opentelemetry-specification/blob/v1.47.0/specification/common/README.md#attribute.
      repeated .opentelemetry.proto.common.v1.KeyValue attributes = 4;
      Specified by:
      getAttributesList in interface Span.LinkOrBuilder

    • getAttributesOrBuilderList

      public List<? extends KeyValueOrBuilder> getAttributesOrBuilderList()
       attributes is a collection of attribute key/value pairs on the link.
 Attribute keys MUST be unique (it is not allowed to have more than one
 attribute with the same key).

 The attribute values SHOULD NOT contain empty values.
 The attribute values SHOULD NOT contain bytes values.
 The attribute values SHOULD NOT contain array values different than array of string values, bool values, int values,
 double values.
 The attribute values SHOULD NOT contain kvlist values.
 The behavior of software that receives attributes containing such values can be unpredictable.
 These restrictions can change in a minor release.
 The restrictions take origin from the OpenTelemetry specification:
 https://github.com/open-telemetry/opentelemetry-specification/blob/v1.47.0/specification/common/README.md#attribute.
      repeated .opentelemetry.proto.common.v1.KeyValue attributes = 4;
      Specified by:
      getAttributesOrBuilderList in interface Span.LinkOrBuilder

    • getAttributesCount

      public int getAttributesCount()
       attributes is a collection of attribute key/value pairs on the link.
 Attribute keys MUST be unique (it is not allowed to have more than one
 attribute with the same key).

 The attribute values SHOULD NOT contain empty values.
 The attribute values SHOULD NOT contain bytes values.
 The attribute values SHOULD NOT contain array values different than array of string values, bool values, int values,
 double values.
 The attribute values SHOULD NOT contain kvlist values.
 The behavior of software that receives attributes containing such values can be unpredictable.
 These restrictions can change in a minor release.
 The restrictions take origin from the OpenTelemetry specification:
 https://github.com/open-telemetry/opentelemetry-specification/blob/v1.47.0/specification/common/README.md#attribute.
      repeated .opentelemetry.proto.common.v1.KeyValue attributes = 4;
      Specified by:
      getAttributesCount in interface Span.LinkOrBuilder

    • getAttributes

      public KeyValue getAttributes(int index)
       attributes is a collection of attribute key/value pairs on the link.
 Attribute keys MUST be unique (it is not allowed to have more than one
 attribute with the same key).

 The attribute values SHOULD NOT contain empty values.
 The attribute values SHOULD NOT contain bytes values.
 The attribute values SHOULD NOT contain array values different than array of string values, bool values, int values,
 double values.
 The attribute values SHOULD NOT contain kvlist values.
 The behavior of software that receives attributes containing such values can be unpredictable.
 These restrictions can change in a minor release.
 The restrictions take origin from the OpenTelemetry specification:
 https://github.com/open-telemetry/opentelemetry-specification/blob/v1.47.0/specification/common/README.md#attribute.
      repeated .opentelemetry.proto.common.v1.KeyValue attributes = 4;
      Specified by:
      getAttributes in interface Span.LinkOrBuilder

    • getAttributesOrBuilder

      public KeyValueOrBuilder getAttributesOrBuilder(int index)
       attributes is a collection of attribute key/value pairs on the link.
 Attribute keys MUST be unique (it is not allowed to have more than one
 attribute with the same key).

 The attribute values SHOULD NOT contain empty values.
 The attribute values SHOULD NOT contain bytes values.
 The attribute values SHOULD NOT contain array values different than array of string values, bool values, int values,
 double values.
 The attribute values SHOULD NOT contain kvlist values.
 The behavior of software that receives attributes containing such values can be unpredictable.
 These restrictions can change in a minor release.
 The restrictions take origin from the OpenTelemetry specification:
 https://github.com/open-telemetry/opentelemetry-specification/blob/v1.47.0/specification/common/README.md#attribute.
      repeated .opentelemetry.proto.common.v1.KeyValue attributes = 4;
      Specified by:
      getAttributesOrBuilder in interface Span.LinkOrBuilder

    • getDroppedAttributesCount

      public int getDroppedAttributesCount()
       dropped_attributes_count is the number of dropped attributes. If the value is 0,
 then no attributes were dropped.
      uint32 dropped_attributes_count = 5;
      Specified by:
      getDroppedAttributesCount in interface Span.LinkOrBuilder
      Returns:
      The droppedAttributesCount.

    • getFlags

      public int getFlags()
       Flags, a bit field.

 Bits 0-7 (8 least significant bits) are the trace flags as defined in W3C Trace
 Context specification. To read the 8-bit W3C trace flag, use
 `flags & SPAN_FLAGS_TRACE_FLAGS_MASK`.

 See https://www.w3.org/TR/trace-context-2/#trace-flags for the flag definitions.

 Bits 8 and 9 represent the 3 states of whether the link is remote.
 The states are (unknown, is not remote, is remote).
 To read whether the value is known, use `(flags & SPAN_FLAGS_CONTEXT_HAS_IS_REMOTE_MASK) != 0`.
 To read whether the link is remote, use `(flags & SPAN_FLAGS_CONTEXT_IS_REMOTE_MASK) != 0`.

 Readers MUST NOT assume that bits 10-31 (22 most significant bits) will be zero.
 When creating new spans, bits 10-31 (most-significant 22-bits) MUST be zero.

 [Optional].
      fixed32 flags = 6;
      Specified by:
      getFlags in interface Span.LinkOrBuilder
      Returns:
      The flags.

    • isInitialized

      public final boolean isInitialized()
      Specified by:
      isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
      Overrides:
      isInitialized in class com.google.protobuf.GeneratedMessage

    • writeTo

      public void writeTo(com.google.protobuf.CodedOutputStream output) throws IOException
      Specified by:
      writeTo in interface com.google.protobuf.MessageLite
      Overrides:
      writeTo in class com.google.protobuf.GeneratedMessage
      Throws:
      IOException

    • getSerializedSize

      public int getSerializedSize()
      Specified by:
      getSerializedSize in interface com.google.protobuf.MessageLite
      Overrides:
      getSerializedSize in class com.google.protobuf.GeneratedMessage

    • equals

      public boolean equals(Object obj)
      Specified by:
      equals in interface com.google.protobuf.Message
      Overrides:
      equals in class com.google.protobuf.AbstractMessage

    • hashCode

      public int hashCode()
      Specified by:
      hashCode in interface com.google.protobuf.Message
      Overrides:
      hashCode in class com.google.protobuf.AbstractMessage

    • parseFrom

      public static Span.Link parseFrom(ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static Span.Link parseFrom(ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static Span.Link parseFrom(com.google.protobuf.ByteString data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static Span.Link parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static Span.Link parseFrom(byte[] data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static Span.Link parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException

    • parseFrom

      public static Span.Link parseFrom(InputStream input) throws IOException
      Throws:
      IOException

    • parseFrom

      public static Span.Link parseFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException

    • parseDelimitedFrom

      public static Span.Link parseDelimitedFrom(InputStream input) throws IOException
      Throws:
      IOException

    • parseDelimitedFrom

      public static Span.Link parseDelimitedFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException

    • parseFrom

      public static Span.Link parseFrom(com.google.protobuf.CodedInputStream input) throws IOException
      Throws:
      IOException

    • parseFrom

      public static Span.Link parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException

    • newBuilderForType

      public Span.Link.Builder newBuilderForType()
      Specified by:
      newBuilderForType in interface com.google.protobuf.Message
      Specified by:
      newBuilderForType in interface com.google.protobuf.MessageLite

    • newBuilder

      public static Span.Link.Builder newBuilder()

    • newBuilder

      public static Span.Link.Builder newBuilder(Span.Link prototype)

    • toBuilder

      public Span.Link.Builder toBuilder()
      Specified by:
      toBuilder in interface com.google.protobuf.Message
      Specified by:
      toBuilder in interface com.google.protobuf.MessageLite

    • newBuilderForType

      protected Span.Link.Builder newBuilderForType(com.google.protobuf.AbstractMessage.BuilderParent parent)
      Overrides:
      newBuilderForType in class com.google.protobuf.AbstractMessage

    • getDefaultInstance

      public static Span.Link getDefaultInstance()

    • parser

      public static com.google.protobuf.Parser<Span.Link> parser()

    • getParserForType

      public com.google.protobuf.Parser<Span.Link> getParserForType()
      Specified by:
      getParserForType in interface com.google.protobuf.Message
      Specified by:
      getParserForType in interface com.google.protobuf.MessageLite
      Overrides:
      getParserForType in class com.google.protobuf.GeneratedMessage

    • getDefaultInstanceForType

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