Implements io.opentelemetry.api.trace.SpanBuilder.addLink.

Doc from io.opentelemetry.api.trace.SpanBuilder.addLink.

Adds a link to the newly created Span.

Links are used to link Spans in different traces. Used (for example) in batching operations, where a single batch handler processes multiple requests from different traces or the same trace.

Implementations may ignore calls with an invalid span context.

Parameters

spanContext:SpanContext

the context of the linked Span.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.addLink.

Doc from io.opentelemetry.api.trace.SpanBuilder.addLink.

Adds a link to the newly created Span.

Links are used to link Spans in different traces. Used (for example) in batching operations, where a single batch handler processes multiple requests from different traces or the same trace.

Implementations may ignore calls with an invalid span context.

Parameters

spanContext:SpanContext

the context of the linked Span.

attributes:Attributes

the attributes of the Link.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Overrides default io.opentelemetry.api.trace.SpanBuilder.setAllAttributes.

Doc from io.opentelemetry.api.trace.SpanBuilder.setAllAttributes.

Sets attributes to the SpanBuilder. If the SpanBuilder previously contained a mapping for any of the keys, the old values are replaced by the specified values.

Parameters

attributes:Attributes

the attributes

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Doc from io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Sets an attribute to the newly created Span. If SpanBuilder previously contained a mapping for the key, the old value is replaced by the specified value.

If a null or empty String value is passed in, the behavior is undefined, and hence strongly discouraged.

Parameters

key:String

the key for this attribute.

value:String

the value for this attribute.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Doc from io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Sets an attribute to the newly created Span. If SpanBuilder previously contained a mapping for the key, the old value is replaced by the specified value.

Parameters

key:String

the key for this attribute.

value:long

the value for this attribute.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Doc from io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Sets an attribute to the newly created Span. If SpanBuilder previously contained a mapping for the key, the old value is replaced by the specified value.

Parameters

key:String

the key for this attribute.

value:double

the value for this attribute.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Doc from io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Sets an attribute to the newly created Span. If SpanBuilder previously contained a mapping for the key, the old value is replaced by the specified value.

Parameters

key:String

the key for this attribute.

value:boolean

the value for this attribute.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Doc from io.opentelemetry.api.trace.SpanBuilder.setAttribute.

Sets an attribute to the newly created Span. If SpanBuilder previously contained a mapping for the key, the old value is replaced by the specified value.

Parameters

key:AttributeKey<T>

the key for this attribute.

value:T

the value for this attribute.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.setNoParent.

Doc from io.opentelemetry.api.trace.SpanBuilder.setNoParent.

Sets the option to become a root Span for a new trace. If not set, the value of Span.current() at startSpan() time will be used as parent.

Observe that any previously set parent will be discarded.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.setParent.

Doc from io.opentelemetry.api.trace.SpanBuilder.setParent.

Sets the parent to use from the specified Context. If not set, the value of Span.current() at startSpan() time will be used as parent.

If no Span is available in the specified Context, the resulting Span will become a root instance, as if setNoParent() had been called.

If called multiple times, only the last specified value will be used. Observe that the state defined by a previous call to setNoParent() will be discarded.

Parameters

context:Context

the Context.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.setSpanKind.

Doc from io.opentelemetry.api.trace.SpanBuilder.setSpanKind.

Sets the SpanKind for the newly created Span. If not called, the implementation will provide a default value SpanKind#INTERNAL.

Parameters

spanKind:SpanKind

the kind of the newly created Span.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.setStartTimestamp.

Doc from io.opentelemetry.api.trace.SpanBuilder.setStartTimestamp.

Sets an explicit start timestamp for the newly created Span.

LIRInstruction.Use this method to specify an explicit start timestamp. If not called, the implementation will use the timestamp value at startSpan() time, which should be the default case.

Important this is NOT equivalent with System.nanoTime().

Parameters

startTimestamp:long

the explicit start timestamp from the epoch of the newly created Span.

unit:TimeUnit

the unit of the timestamp.

Returns:DefaultTracer.NoopSpanBuilder

this.

Annotations

@Override

Implements io.opentelemetry.api.trace.SpanBuilder.startSpan.

Doc from io.opentelemetry.api.trace.SpanBuilder.startSpan.

Starts a new Span.

Users must manually call Span#end() to end this Span.

Does not install the newly created Span to the current Context.

Example of usage:

class MyClass {
  private final Tracer tracer;

  MyClass(OpenTelemetry openTelemetry) {
    tracer = openTelemetry.getTracer("com.example.rpc");
  }

  void doWork(Span parent) {
    Span childSpan = tracer.spanBuilder("MyChildSpan")
         .setParent(Context.current().with(parent))
         .startSpan();
    childSpan.addEvent("my event");
    try {
      doSomeWork(childSpan); // Manually propagate the new span down the stack.
    } finally {
      // To make sure we end the span even in case of an exception.
      childSpan.end();  // Manually end the span.
    }
  }
}

Returns:Span

the newly created Span.

Annotations

@Override