infochanged

Workers - Workers tracing — new spanContext(), setStatus(), and updateName() APIs

Announced: 2026-10-26
Tags: Workers
Severity: info, set by reef/rss-rule-v1
Source: https://developers.cloudflare.com/changelog/post/2026-10-26-span-context-status-update-name/

<a href="https://developers.cloudflare.com/workers/observability/traces/custom-spans/">Custom spans</a> in Workers now support three more methods from the OpenTelemetry span API. <ul> <li><code>span.spanContext()</code> returns the span's <code>traceId</code>, <code>spanId</code>, and <code>traceFlags</code>. The IDs match the trace and span IDs in Workers Observability and in exported traces, so you can log them or return them to clients to correlate a request with its trace.</li> <li><code>span.setStatus(status)</code> sets the span status to <code>"unset"</code>, <code>"ok"</code>, or <code>"error"</code>, with an optional message for errors. Span status is included in traces exported to <a href="https://developers.cloudflare.com/workers/observability/opentelemetry-export/">OpenTelemetry destinations</a>. The Workers Observability dashboard does not display it yet.</li> <li><code>span.updateName(name)</code> renames a span after it starts, such as once you know which route a request matched. You can also rename the invocation's root span returned by <code>tracing.getActiveSpan()</code>.</li> </ul> <div><div data-nb-tabs data-nb-sync-key="workersExamples" class><div class="relative flex border-b border-border" role="tablist" data-nb-tabs-list></div><div class="mt-3"><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="JavaScript" class><figure class="nb-code-figure nb-code-figure-titled" data-nb-lang="js"><figcaption class="nb-code-title">src/index.jsjs</figcaption><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="js" data-nb-lang="js"><code>import { tracing } from "cloudflare:workers"; export default { async fetch(request, env) { const root = tracing.getActiveSpan(); const route = router.match(request); root?.updateName(${request.method} ${route.pattern}); return tracing.startActiveSpan("handle", async (span) => { try { const response = await route.handler(request, env); span.setStatus({ code: "ok" }); return response; } catch (err) { span.recordException(err); span.setStatus({ code: "error", message: "Route handler failed" }); return Response.json( { error: "Internal error", traceId: root?.spanContext().traceId }, { status: 500 }, ); } finally { span.end(); } }); }, };</code></pre></figure></div><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="TypeScript" class><figure class="nb-code-figure nb-code-figure-titled" data-nb-lang="ts"><figcaption class="nb-code-title">src/index.tsts</figcaption><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="ts" data-nb-lang="ts"><code>import { tracing } from "cloudflare:workers"; export default { async fetch(request: Request, env: Env): Promise<Response> { const root = tracing.getActiveSpan(); const route = router.match(request); root?.updateName(${request.method} ${route.pattern}); return tracing.startActiveSpan("handle", async (span) => { try { const response = await route.handler(request, env); span.setStatus({ code: "ok" }); return response; } catch (err) { span.recordException(err as Error); span.setStatus({ code: "error", message: "Route handler failed" }); return Response.json( { error: "Internal error", traceId: root?.spanContext().traceId }, { status: 500 }, ); } finally { span.end(); } }); }, };</code></pre></figure></div></div></div><script type="module" src="https://developers.cloudflare.com/home/runner/work/cloudflare-docs/cloudflare-docs/src/components/ui/tabs/Tabs.astro?astro&type=script&index=0&lang.ts"></script></div> For more details, refer to the <a href="https://developers.cloudflare.com/workers/observability/traces/custom-spans/">custom spans documentation</a>.

The text above is the source's. reef added the severity, the dates it could read from the text, and the endpoints and scopes named in code.