From e445b637c80a7377fc0a025e44e2966ab6af09be Mon Sep 17 00:00:00 2001 From: Abdelrahman Awad Date: Wed, 15 Jul 2026 15:39:34 -0400 Subject: [PATCH] diagnostics_channel: mark TracingChannel as stable Promotes the diagnostics_channel.tracingChannel() factory and the TracingChannel class from experimental to stable. TracingChannel has been available since v18.19.0 / v19.9.0 with an unchanged surface and now has broad adoption: fastify, pino, mysql2, redis, ioredis, mongoose, graphql, h3, srvx, and the Vercel AI SDK publish TracingChannel events natively, and it is consumed by OpenTelemetry, Sentry, Datadog, and New Relic. The last behavioral wart, tracePromise stripping custom thenables (#59936), was resolved in #61766. This mirrors the scoping in #45290: BoundedChannel, the bindStore / runStores store helpers, and the concrete built-in channels stay experimental. Signed-off-by: Abdelrahman Awad --- doc/api/diagnostics_channel.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/doc/api/diagnostics_channel.md b/doc/api/diagnostics_channel.md index e5ace9abcfdddc..22b70c444a9a1e 100644 --- a/doc/api/diagnostics_channel.md +++ b/doc/api/diagnostics_channel.md @@ -237,9 +237,13 @@ diagnostics_channel.unsubscribe('my-channel', onMessage); added: - v19.9.0 - v18.19.0 +changes: + - version: REPLACEME + pr-url: https://github.com/nodejs/node/pull/64525 + description: Marked as stable. --> -> Stability: 1 - Experimental +> Stability: 2 - Stable * `nameOrChannels` {string|TracingChannel} Channel name or object containing all the [TracingChannel Channels][] @@ -744,9 +748,13 @@ The scope must be used with the `using` syntax to ensure proper disposal. added: - v19.9.0 - v18.19.0 +changes: + - version: REPLACEME + pr-url: https://github.com/nodejs/node/pull/64525 + description: Marked as stable. --> -> Stability: 1 - Experimental +> Stability: 2 - Stable The class `TracingChannel` is a collection of [TracingChannel Channels][] which together express a single traceable action. It is used to formalize and