Package org.apache.juneau.rest.server.tracing.otel

package org.apache.juneau.rest.server.tracing.otel

OpenTelemetry bridge for the juneau-rest-server TracerHook SPI.

This module is opt-in and ships OtelTracerHook — a bridge that creates one OpenTelemetry Span per @RestOp call, populates the canonical HTTP semantic-convention attributes (http.request.method, http.response.status_code, http.route), and continues an inbound W3C trace context carried on the traceparent / tracestate request headers.

Containment

The io.opentelemetry:opentelemetry-api dependency is declared in provided scope on this module's POM. Consumers that want OpenTelemetry-backed tracing must add opentelemetry-api themselves at the version of their choice along with an SDK / exporter combination matching their downstream tracing backend (Jaeger, Zipkin, OTLP, etc.). This way:

• The core juneau-rest-server jar stays OpenTelemetry-free.
• Services that never opt in pay zero classpath cost.
• Services that DO opt in pick their own OpenTelemetry version (semantic-convention upgrades, security patches) without waiting for a Juneau release.

See Also:

• OtelTracerHook
• TracerHook
• Observability — Micrometer + OpenTelemetry
• OpenTelemetry HTTP semantic conventions
• W3C Trace Context

Since:

10.0.0

Related Packages

Package	Description
org.apache.juneau.rest.server.tracing	Tracing SPI for juneau-rest-server — per-request span hook backed by a caller-supplied TracerHook bean.

Classes

Class	Description
OtelTracerHook	TracerHook bridge that opens an OpenTelemetry Span for every @RestOp call.
RestRequestTextMapGetter	TextMapGetter implementation that reads HTTP request headers from a RestRequest.
TraceContextCarrierTextMapGetter	TextMapGetter implementation that reads W3C trace-context fields from a neutral TraceContextCarrier — for example an MCP request's params._meta object — instead of HTTP request headers.
TraceContextCarrierTextMapSetter	TextMapSetter implementation that writes W3C trace-context fields into a neutral TraceContextCarrier instead of an HTTP response.