Package io.opentelemetry.instrumentation.api.tracer

Class BaseTracer

    • Constructor Summary

      Constructors 
      Constructor Description
      BaseTracer()  
      BaseTracer​(io.opentelemetry.api.OpenTelemetry openTelemetry)  
      BaseTracer​(io.opentelemetry.api.trace.Tracer tracer)
      Deprecated.
      prefer to pass in an OpenTelemetry instance, instead.

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      void addThrowable​(io.opentelemetry.api.trace.Span span, Throwable throwable)  
      void end​(io.opentelemetry.api.trace.Span span)  
      void end​(io.opentelemetry.api.trace.Span span, long endTimeNanos)  
      void end​(io.opentelemetry.context.Context context)  
      void end​(io.opentelemetry.context.Context context, long endTimeNanos)  
      void endExceptionally​(io.opentelemetry.api.trace.Span span, Throwable throwable)  
      void endExceptionally​(io.opentelemetry.api.trace.Span span, Throwable throwable, long endTimeNanos)  
      void endExceptionally​(io.opentelemetry.context.Context context, Throwable throwable)  
      void endExceptionally​(io.opentelemetry.context.Context context, Throwable throwable, long endTimeNanos)  
      <C> io.opentelemetry.context.Context extract​(C carrier, io.opentelemetry.context.propagation.TextMapPropagator.Getter<C> getter)  
      static <C> io.opentelemetry.context.Context extractWithGlobalPropagators​(C carrier, io.opentelemetry.context.propagation.TextMapPropagator.Getter<C> getter)
      Deprecated.
      We should eliminate all static usages so we can use the non-global propagators.
      static io.opentelemetry.api.trace.Span getCurrentServerSpan()
      Returns span of type SERVER from the current context or null if not found.
      static io.opentelemetry.api.trace.Span getCurrentServerSpan​(io.opentelemetry.context.Context context)
      Returns span of type SERVER from the given context or null if not found.
      io.opentelemetry.context.propagation.ContextPropagators getPropagators()  
      String spanNameForClass​(Class<?> clazz)
      This method is used to generate an acceptable span (operation) name based on a given class reference.
      String spanNameForMethod​(Method method)
      This method is used to generate an acceptable span (operation) name based on a given method reference.
      io.opentelemetry.context.Scope startScope​(io.opentelemetry.api.trace.Span span)  
      io.opentelemetry.api.trace.Span startSpan​(Class<?> clazz)  
      io.opentelemetry.api.trace.Span startSpan​(Method method)  
      io.opentelemetry.api.trace.Span startSpan​(String spanName, io.opentelemetry.api.trace.SpanKind kind)  

    • Constructor Detail

      • BaseTracer

        public BaseTracer()

      • BaseTracer

        @Deprecated
public BaseTracer​(io.opentelemetry.api.trace.Tracer tracer)
        Deprecated.
        prefer to pass in an OpenTelemetry instance, instead.
        Prefer to pass in an OpenTelemetry instance, rather than just a Tracer, so you don't have to use the GlobalOpenTelemetry Propagator instance.

      • BaseTracer

        public BaseTracer​(io.opentelemetry.api.OpenTelemetry openTelemetry)

    • Method Detail

      • getPropagators

        public io.opentelemetry.context.propagation.ContextPropagators getPropagators()

      • startSpan

        public io.opentelemetry.api.trace.Span startSpan​(Class<?> clazz)

      • startSpan

        public io.opentelemetry.api.trace.Span startSpan​(Method method)

      • startSpan

        public io.opentelemetry.api.trace.Span startSpan​(String spanName,
                                                 io.opentelemetry.api.trace.SpanKind kind)

      • startScope

        public io.opentelemetry.context.Scope startScope​(io.opentelemetry.api.trace.Span span)

      • spanNameForMethod

        public String spanNameForMethod​(Method method)
        This method is used to generate an acceptable span (operation) name based on a given method reference. Anonymous classes are named based on their parent.

      • spanNameForClass

        public String spanNameForClass​(Class<?> clazz)
        This method is used to generate an acceptable span (operation) name based on a given class reference. Anonymous classes are named based on their parent.

      • end

        public void end​(io.opentelemetry.context.Context context)

      • end

        public void end​(io.opentelemetry.context.Context context,
                long endTimeNanos)

      • end

        public void end​(io.opentelemetry.api.trace.Span span)

      • end

        public void end​(io.opentelemetry.api.trace.Span span,
                long endTimeNanos)

      • endExceptionally

        public void endExceptionally​(io.opentelemetry.context.Context context,
                             Throwable throwable)

      • endExceptionally

        public void endExceptionally​(io.opentelemetry.context.Context context,
                             Throwable throwable,
                             long endTimeNanos)

      • endExceptionally

        public void endExceptionally​(io.opentelemetry.api.trace.Span span,
                             Throwable throwable)

      • endExceptionally

        public void endExceptionally​(io.opentelemetry.api.trace.Span span,
                             Throwable throwable,
                             long endTimeNanos)

      • addThrowable

        public void addThrowable​(io.opentelemetry.api.trace.Span span,
                         Throwable throwable)

      • extractWithGlobalPropagators

        @Deprecated
public static <C> io.opentelemetry.context.Context extractWithGlobalPropagators​(C carrier,
                                                                                io.opentelemetry.context.propagation.TextMapPropagator.Getter<C> getter)
        Deprecated.
        We should eliminate all static usages so we can use the non-global propagators.
        Do extraction with the propagators from the GlobalOpenTelemetry instance. Not recommended.

      • extract

        public <C> io.opentelemetry.context.Context extract​(C carrier,
                                                    io.opentelemetry.context.propagation.TextMapPropagator.Getter<C> getter)

      • getCurrentServerSpan

        public static io.opentelemetry.api.trace.Span getCurrentServerSpan()
        Returns span of type SERVER from the current context or null if not found.

      • getCurrentServerSpan

        public static io.opentelemetry.api.trace.Span getCurrentServerSpan​(io.opentelemetry.context.Context context)
        Returns span of type SERVER from the given context or null if not found.