Package dev.restate.sdk.interceptor.opentelemetry

Class OpenTelemetryInterceptorFactory

java.lang.Object

dev.restate.sdk.interceptor.opentelemetry.OpenTelemetryInterceptorFactory

All Implemented Interfaces:

HandlerInterceptor.Factory, RunInterceptor.Factory

public final class OpenTelemetryInterceptorFactory
extends Object
implements HandlerInterceptor.Factory, RunInterceptor.Factory

OpenTelemetry interceptor factory for Java handlers. Implements both HandlerInterceptor.Factory and RunInterceptor.Factory so a single registration covers both invocation- and run-level spans.

• Per invocation: opens an attempt <target> span (server kind) with restate.invocation.id and restate.invocation.target attributes. The parent span context is extracted from the incoming request headers via the configured TextMapPropagator.
• Per ctx.run(name, ...) call: opens a run (<name>) child span with the restate.run.name attribute.

Scopes are thread-local. Use with OpenTelemetryRunContextPropagator (registered via SPI by default) to propagate spans to run closures.

Constructor Summary

Constructors

Constructor	Description
OpenTelemetryInterceptorFactory(io.opentelemetry.api.OpenTelemetry openTelemetry)

Method Summary

Modifier and Type	Method	Description
@Nullable HandlerInterceptor	createHandlerInterceptor()	Create HandlerInterceptor.
@Nullable RunInterceptor	createRunInterceptor()	Create RunInterceptor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

OpenTelemetryInterceptorFactory

public OpenTelemetryInterceptorFactory(io.opentelemetry.api.OpenTelemetry openTelemetry)

Method Details

createHandlerInterceptor

public @Nullable HandlerInterceptor createHandlerInterceptor()

Description copied from interface: HandlerInterceptor.Factory

Create HandlerInterceptor. Invoked once at endpoint initialization, hence the resulting interceptor is cached and reused across all invocations.

Return null to skip this factory.

Specified by:

createHandlerInterceptor in interface HandlerInterceptor.Factory

createRunInterceptor

public @Nullable RunInterceptor createRunInterceptor()

Description copied from interface: RunInterceptor.Factory

Create RunInterceptor. Invoked once at endpoint initialization, hence the resulting interceptor is cached and reused across all invocations.

Return null to skip this factory.

Specified by:

createRunInterceptor in interface RunInterceptor.Factory