Version 0.7.0

Supports OpenTelemetry Java version 0.7.0.

Changes since v.0.6.0

• BREAKING CHANGE #760 Rename trace.methods.exclude to trace.annotated.methods.exclude

• BREAKING CHANGE #841 Changed prefixes of all configuration options from ota to otel

• #506 @WithSpan annotation now supports kind attribute

• New documentation about writing new Instrumentation

• #735 MDC support for log4j 2.13.2+

• #726 New semantic attribute http.response_content_length

• Performance optimisations for instrumenting Clojure applications

• #575 Several instrumentations used to update name of the parent span. It is now fixed to correctly do that for SERVER span

• #756 Add support for Armeria server

• Support for new exception span event

• #785, #823 Update database semantic convention

• #827 More attributes on http server spans

• #838 Add support for OtTracerPropagator and AwsXRayPropagator

• #849 Add support for TraceMultiPropagator

• README.md updated to reflect current configuration.

• Extensive support for manual instrumentation of Spring Boot applications

Version 0.6.0

See Getting Started for setup instructions.

Supports OpenTelemetry Java version 0.6.0.

Multiple modules have been renamed. Please consult new coordinates for published artefacts at Bintray

Version 0.4.0

See Getting Started for new setup instructions.

Version 0.3.0

Download opentelemetry-auto-0.3.0.jar and one of the exporters:

• opentelemetry-auto-exporters-jaeger-0.3.0.jar
• opentelemetry-auto-exporters-logging-0.3.0.jar
• opentelemetry-auto-exporters-otlp-0.3.0.jar

To run with the otlp exporter:

export OTEL_RESOURCE_ATTRIBUTES=service.name=shopping
java -javaagent:path/to/opentelemetry-auto-0.3.0.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-otlp-0.3.0.jar \
     -Dota.exporter.otlp.endpoint=localhost:55678 \
     -jar myapp.jar

To run with the jaeger exporter:

java -javaagent:path/to/opentelemetry-auto-0.3.0.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-jaeger-0.3.0.jar \
     -Dota.exporter.jaeger.endpoint=localhost:14250 \
     -Dota.exporter.jaeger.service.name=shopping \
     -jar myapp.jar

To run with the logging exporter:

java -javaagent:path/to/opentelemetry-auto-0.3.0.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-logging-0.3.0.jar \
     -jar myapp.jar

Version 0.2.2

Download opentelemetry-auto-0.2.2.jar and one of the exporters:

• opentelemetry-auto-exporters-jaeger-0.2.2.jar
• opentelemetry-auto-exporters-logging-0.2.2.jar
• opentelemetry-auto-exporters-otlp-0.2.2.jar

To run with the jaeger exporter:

java -javaagent:path/to/opentelemetry-auto-0.2.2.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-jaeger-0.2.2.jar \
     -Dota.exporter.jaeger.endpoint=localhost:14250 \
     -Dota.exporter.jaeger.service.name=shopping \
     -jar myapp.jar

To run with the logging exporter:

java -javaagent:path/to/opentelemetry-auto-0.2.2.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-logging-0.2.2.jar \
     -jar myapp.jar

To run with the otlp exporter:

java -javaagent:path/to/opentelemetry-auto-0.2.2.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-otlp-0.2.2.jar \
     -Dota.exporter.otlp.endpoint=localhost:55678 \
     -jar myapp.jar

Version 0.2.1

Download opentelemetry-auto-0.2.1.jar and one of the exporters:

• opentelemetry-auto-exporters-jaeger-0.2.1.jar
• opentelemetry-auto-exporters-logging-0.2.1.jar
• opentelemetry-auto-exporters-otlp-0.2.1.jar

To run with the jaeger exporter:

java -javaagent:path/to/opentelemetry-auto-0.2.1.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-jaeger-0.2.1.jar \
     -Dota.exporter.jaeger.endpoint=localhost:14250 \
     -Dota.exporter.jaeger.service.name=shopping \
     -jar myapp.jar

To run with the logging exporter:

java -javaagent:path/to/opentelemetry-auto-0.2.1.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-logging-0.2.1.jar \
     -jar myapp.jar

To run with the otlp exporter:

java -javaagent:path/to/opentelemetry-auto-0.2.1.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-otlp-0.2.1.jar \
     -Dota.exporter.otlp.endpoint=localhost:55678 \
     -jar myapp.jar

Version 0.2.0

Download opentelemetry-auto-0.2.0.jar and one of the exporters:

• opentelemetry-auto-exporters-jaeger-0.2.0.jar
• opentelemetry-auto-exporters-logging-0.2.0.jar
• opentelemetry-auto-exporters-otlp-0.2.0.jar

To run with the jaeger exporter:

java -javaagent:path/to/opentelemetry-auto-0.2.0.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-jaeger-0.2.0.jar \
     -Dota.exporter.jaeger.endpoint=localhost:14250 \
     -Dota.exporter.jaeger.service.name=shopping \
     -jar myapp.jar

To run with the logging exporter:

java -javaagent:path/to/opentelemetry-auto-0.2.0.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-logging-0.2.0.jar \
     -jar myapp.jar

To run with the otlp exporter:

java -javaagent:path/to/opentelemetry-auto-0.2.0.jar \
     -Dota.exporter.jar=path/to/opentelemetry-auto-exporters-otlp-0.2.0.jar \
     -Dota.exporter.otlp.endpoint=localhost:55678 \
     -jar myapp.jar

Version 0.1.1

This first release takes the easy route and directly bundles the Jaeger exporter and only the Jaeger exporter (in the next release, you will be able to plug in the exporter of your choice).

Download and try it out on your (non-production) app today, and let us know what works and what doesn't!

To add it to your app, e.g.:

java -javaagent:/path/to/opentelemetry-auto-0.1.1.jar \
     -Dota.exporter=jaeger \
     -Dota.jaeger.host=localhost \
     -Dota.jaeger.port=14250 \
     -Dota.service=shopping \
     -jar myapp.jar