Package io.opencensus.implcore.trace

Class NoRecordEventsSpanImpl

  • final class NoRecordEventsSpanImpl
extends Span
    Implementation for the Span class that does not record trace events.

    • Field Detail

      • NOT_RECORD_EVENTS_SPAN_OPTIONS

        private static final java.util.EnumSet<Span.Options> NOT_RECORD_EVENTS_SPAN_OPTIONS

    • Constructor Detail

      • NoRecordEventsSpanImpl

        private NoRecordEventsSpanImpl​(SpanContext context)

    • Method Detail

      • addAnnotation

        public void addAnnotation​(java.lang.String description,
                          java.util.Map<java.lang.String,​AttributeValue> attributes)
        Description copied from class: Span
        Adds an annotation to the Span.
        Specified by:
        addAnnotation in class Span
        Parameters:
        description - the description of the annotation time event.
        attributes - the attributes that will be added; these are associated with this annotation, not the Span as for Span.putAttributes(Map).

      • addAnnotation

        public void addAnnotation​(Annotation annotation)
        Description copied from class: Span
        Adds an annotation to the Span.
        Specified by:
        addAnnotation in class Span
        Parameters:
        annotation - the annotations to add.

      • putAttribute

        public void putAttribute​(java.lang.String key,
                         AttributeValue value)
        Description copied from class: Span
        Sets an attribute to the Span. If the Span previously contained a mapping for the key, the old value is replaced by the specified value.
        Overrides:
        putAttribute in class Span
        Parameters:
        key - the key for this attribute.
        value - the value for this attribute.

      • putAttributes

        public void putAttributes​(java.util.Map<java.lang.String,​AttributeValue> attributes)
        Description copied from class: Span
        Sets a set of attributes to the Span. The effect of this call is equivalent to that of calling Span.putAttribute(String, AttributeValue) once for each element in the specified map.
        Overrides:
        putAttributes in class Span
        Parameters:
        attributes - the attributes that will be added and associated with the Span.

      • addMessageEvent

        public void addMessageEvent​(MessageEvent messageEvent)
        Description copied from class: Span
        Adds a MessageEvent to the Span.

        This function can be used by higher level applications to record messaging event.

        This method should always be overridden by users whose API versions are larger or equal to 0.12.

        Overrides:
        addMessageEvent in class Span
        Parameters:
        messageEvent - the message to add.

      • addLink

        public void addLink​(Link link)
        Description copied from class: Span
        Adds a Link to the Span.

        Used (for example) in batching operations, where a single batch handler processes multiple requests from different traces.

        Specified by:
        addLink in class Span
        Parameters:
        link - the link to add.

      • setStatus

        public void setStatus​(Status status)
        Description copied from class: Span
        Sets the Status to the Span.

        If used, this will override the default Span status. Default is Status.OK.

        Only the value of the last call will be recorded, and implementations are free to ignore previous calls. If the status is set via EndSpanOptions.Builder.setStatus(Status) that will always be the last call.

        Overrides:
        setStatus in class Span
        Parameters:
        status - the Status to set.

      • end

        public void end​(EndSpanOptions options)
        Description copied from class: Span
        Marks the end of Span execution with the given options.

        Only the timing of the first end call for a given Span will be recorded, and implementations are free to ignore all further calls.

        Specified by:
        end in class Span
        Parameters:
        options - the options to be used for the end of the Span.