Deprecated API

Contents

• Deprecated Methods

Deprecated Methods

Method and Description
io.opentracing.ScopeManager.activate(Span, boolean) use ScopeManager.activate(Span) instead. Set the specified Span as the active instance for the current context (usually a thread). Finishing the Span upon Scope.close() is discouraged, as reporting errors becomes impossible: try (Scope scope = tracer.scopeManager().activate(span, true)) { } catch (Exception e) { // Not possible to report errors, as // the span has been already finished. }
io.opentracing.tag.StringTag.set(Span, StringTag) as using the tag *key* as tag value is not usually required.
io.opentracing.Scope.span() use Span directly or access it through ScopeManager.activeSpan() Return the corresponding active Span for this instance.
io.opentracing.Tracer.SpanBuilder.startActive(boolean) use Tracer.SpanBuilder.start() and ScopeManager.activate(Span span) instead. Returns a newly started and activated Scope. SpanBuilder#startActive() is a shorthand for tracer.scopeManager().activate(spanBuilder.start()). The returned Scope supports try-with-resources, but using this method is discouraged as the Span reference could be easily lost, and reporting errors on Span through this method becomes impossible: try (Scope scope = tracer.buildSpan("...").startActive(true)) { // (Do work) scope.span().setTag( ... ); // etc, etc } catch (Exception e) { // Not possible to report errors, as // the span reference has been lost, // and span has been already finished too. } It is recommended to use Tracer.SpanBuilder.start() with a subsequent call to ScopeManager.activate(Span) Span span = tracer.buildSpan("...").start(); try (Scope scope = tracer.activateSpan(span)) { } catch (Exception e) { span.log(...); // Report any errors properly. } finally { span.finish(); // Optionally close the Span. }
io.opentracing.Tracer.SpanBuilder.startManual() use Tracer.SpanBuilder.start() instead.