Instana - Java Open Tracing

Implementation of the opentracing.io API that is monitored by Instana.

License

License

Categories

Categories

Java Languages
GroupId

GroupId

com.instana
ArtifactId

ArtifactId

instana-java-opentracing
Last Version

Last Version

0.33.1
Release Date

Release Date

Type

Type

jar
Description

Description

Instana - Java Open Tracing
Implementation of the opentracing.io API that is monitored by Instana.
Project URL

Project URL

https://github.com/instana/instana-java-opentracing
Project Organization

Project Organization

Instana Inc.
Source Code Management

Source Code Management

https://github.com/instana/instana-java-opentracing

Download instana-java-opentracing

How to add to project

<!-- https://jarcasting.com/artifacts/com.instana/instana-java-opentracing/ -->
<dependency>
    <groupId>com.instana</groupId>
    <artifactId>instana-java-opentracing</artifactId>
    <version>0.33.1</version>
</dependency>
// https://jarcasting.com/artifacts/com.instana/instana-java-opentracing/
implementation 'com.instana:instana-java-opentracing:0.33.1'
// https://jarcasting.com/artifacts/com.instana/instana-java-opentracing/
implementation ("com.instana:instana-java-opentracing:0.33.1")
'com.instana:instana-java-opentracing:jar:0.33.1'
<dependency org="com.instana" name="instana-java-opentracing" rev="0.33.1">
  <artifact name="instana-java-opentracing" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.instana', module='instana-java-opentracing', version='0.33.1')
)
libraryDependencies += "com.instana" % "instana-java-opentracing" % "0.33.1"
[com.instana/instana-java-opentracing "0.33.1"]

Dependencies

compile (1)

Group / Artifact Type Version
io.opentracing : opentracing-api jar 0.33.0

test (1)

Group / Artifact Type Version
junit : junit jar 4.12

Project Modules

There are no modules declared in this project.

Instana Java OpenTracing  Build Status

Instana is capable of collecting traces that are described via the OpenTracing API. In order to collect such traces, this tracer implementation must be used.

The artifact is available on Maven Central. When using Maven you can include the tracer with:

<dependency>
  <groupId>com.instana</groupId>
  <artifactId>instana-java-opentracing</artifactId>
  <version>0.33.0</version>
</dependency>

The older 0.20.7, 0.30.3, 0.31.0 and 0.32.0 are also available.

The implementation's version number follows the OpenTracing API version that it implements.

The tracer is fully compliant with the OpenTracing API and is available via:

io.opentracing.Tracer tracer = new InstanaTracer();

it will try to load a ScopeManager via the Java Service Loader. Or when explicitly using a specific ScopeManager:

io.opentracing.util.ThreadLocalScopeManager scopeManager = new ThreadLocalScopeManager();
io.opentracing.Tracer tracer = new InstanaTracer(scopeManager);

The Instana tracer supports context propagation using all of OpenTracing's built-in formats, i.e. Format.Builtin#TEXT_MAP, Format.Builtin#HTTP_HEADERS and Format.Builtin#BINARY.

When the Instana monitoring agent is not attached, the Instana OpenTracing API will act as an inactive tracer, similarly to the OpenTracing noop-tracer. To activate opentracing you must activate it in the agent configuation:

# Java Tracing
com.instana.plugin.javatrace:
  instrumentation:
    # Lightweight Bytecode Instrumentation, enabled by default
    enabled: true
    # OpenTracing instrumentation, disabled by default
    opentracing: true
com.instana

Instana

Sensors for instrumentation of various languages and outbound data connectors

Versions

Version
0.33.1
0.33.0
0.32.0
0.31.0
0.30.2
0.30.1
0.30.0
0.20.7
0.20.2