Global Tracer resolution

Library to obtain a Tracer reference from anywhere in your application

License	Apache License, Version 2.0
GroupId	io.opentracing.contrib
ArtifactId	opentracing-globaltracer
Last Version	0.1.2
Release Date	May 12, 2017
Type	jar
Description	Global Tracer resolution Library to obtain a Tracer reference from anywhere in your application
Project URL	https://github.com/opentracing-contrib/java-globaltracer
Source Code Management	https://github.com/opentracing-contrib/java-globaltracer

Download opentracing-globaltracer

Filename	Size
opentracing-globaltracer-0.1.2.pom
opentracing-globaltracer-0.1.2.jar	5 KB
opentracing-globaltracer-0.1.2-sources.jar	3 KB
opentracing-globaltracer-0.1.2-javadoc.jar	25 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.opentracing.contrib/opentracing-globaltracer/ -->
<dependency>
    <groupId>io.opentracing.contrib</groupId>
    <artifactId>opentracing-globaltracer</artifactId>
    <version>0.1.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.opentracing.contrib/opentracing-globaltracer/
implementation 'io.opentracing.contrib:opentracing-globaltracer:0.1.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.opentracing.contrib/opentracing-globaltracer/
implementation ("io.opentracing.contrib:opentracing-globaltracer:0.1.2")

Apache Buildr

'io.opentracing.contrib:opentracing-globaltracer:jar:0.1.2'

Apache Ivy

<dependency org="io.opentracing.contrib" name="opentracing-globaltracer" rev="0.1.2">
  <artifact name="opentracing-globaltracer" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.opentracing.contrib', module='opentracing-globaltracer', version='0.1.2')
)

Scala SBT

libraryDependencies += "io.opentracing.contrib" % "opentracing-globaltracer" % "0.1.2"

Leiningen

[io.opentracing.contrib/opentracing-globaltracer "0.1.2"]

Dependencies

compile (4)

Group / Artifact	Type	Version
io.opentracing : opentracing-api	jar	0.22.0
io.opentracing : opentracing-noop	jar	0.22.0
io.opentracing : opentracing-util	jar	0.22.0
io.opentracing.contrib : opentracing-tracerresolver	jar	0.1.0

test (4)

Group / Artifact	Type	Version
io.opentracing : opentracing-mock	jar	0.22.0
junit : junit	jar	4.12
org.hamcrest : hamcrest-library	jar	1.3
org.mockito : mockito-all	jar	1.10.19

Project Modules

There are no modules declared in this project.

❗ deprecated ❗ Global tracer resolution for Java

Global Tracer forwarding to another Tracer implementation.

❗ Note: GlobalTracer has been included in core OpenTracing Java since opentracing-java version 0.21.0.
This contrib project is now deprecated.

GlobalTracer

Provides the GlobalTracer.get() method that returns the singleton global tracer.

When the tracer is needed it is lazily looked up using the following rules:

1. The tracer from the last register(tracer) call always takes precedence.
2. If no tracer was registered, one is resolved by the TracerResolver.
3. If no Tracer is resolved, the NoopTracer will be used.

How to use this library

Some examples on how this library can be used:

Application intialization

Initialize a new tracer from the application configuration and let it to become the GlobalTracer for the application:

    Tracer configuredTracer = applicationConfiguration.buildConfiguredTracer();
    GlobalTracer.register(configuredTracer);

Using the global tracer

Once initialized, all application code can instrument tracing by starting new spans like:

    try (Span span = GlobalTracer.get().buildSpan("someOperation").start()) {
        // ... Traced block of code ...
    }

If no GlobalTracer is configured, this code will not throw any exceptions. Tracing is simply delegated to the NoopTracer instead.

3rd-Party OpenTracing API Contributions

3rd-party contributions that use OpenTracing. **The repositories in this org are *not* affiliated with the CNCF.**

Versions

Version
0.1.2 May 12, 2017
0.1.1 Apr 18, 2017
0.1.0 Jan 24, 2017