Skip to main content
The @restatedev/restate-sdk-opentelemetry package provides a ready-made OpenTelemetry hook. It:
  • Extracts W3C trace context from the Restate attempt headers
  • Creates one span per handler attempt with standard attributes (restate.invocation.id, restate.invocation.target)
  • Creates child spans for ctx.run() closures with the restate.run.name attribute
  • Suppresses span events during replay (to avoid duplicate events)

​
Setup

Install the package: 
npm install @restatedev/restate-sdk-opentelemetry
Then add the hook to your service or endpoint: 
import * as restate from "@restatedev/restate-sdk";
import { openTelemetryHook } from "@restatedev/restate-sdk-opentelemetry";
import { trace } from "@opentelemetry/api";

const greeter = restate.service({
    name: "Greeter",
    options: {
        hooks: [openTelemetryHook({ tracer: trace.getTracer("greeter-service") })],
    },
    handlers: {
        greet: async (ctx: restate.Context, name: string) => {
            // Add events to the active span
            trace.getActiveSpan()?.addEvent("processing_started", { name });

            // ctx.run gets its own child span automatically
            const greeting = await ctx.run("compute-greeting", async () => {
                return `Hello ${name}!`;
            });

            return greeting;
        },
    },
});
Check the TSDocs to see the full list of options.

​
Full example

For a complete end-to-end tracing example with Jaeger, see the OpenTelemetry integration example.