From 449827c3e4d1c82381b3e6d10e1efd4b4d893c7c Mon Sep 17 00:00:00 2001 From: Francesco Novy Date: Fri, 18 Sep 2026 13:24:00 +0200 Subject: [PATCH 1/2] docs(js): broaden server integration support via categories MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit These integrations are exported from `@sentry/node` (and re-exported by the edge runtimes that support them), so they are available across all server SDKs rather than the handful of frameworks the hand-maintained lists enumerated. Move them to `supportedCategories: [server]` with the runtimes the SDK does not support listed under `notSupported`, verified against the exports in getsentry/sentry-javascript. - childProcess: node-only → exclude bun, deno, cloudflare (keep electron). - fastify: node+bun → exclude deno, cloudflare. - koa: node+bun+deno → exclude cloudflare. - hapi: node+bun+deno → exclude cloudflare. - postgresjs: node+bun+deno → exclude cloudflare (the previous list wrongly listed only cloudflare/deno and omitted node/bun). Co-Authored-By: Claude Opus 4.8 (1M context) --- .../integrations/childProcess.mdx | 26 +++++-------------- .../configuration/integrations/fastify.mdx | 10 +++---- .../configuration/integrations/hapi.mdx | 9 +++---- .../common/configuration/integrations/koa.mdx | 9 +++---- .../configuration/integrations/postgresjs.mdx | 5 ++-- 5 files changed, 22 insertions(+), 37 deletions(-) diff --git a/docs/platforms/javascript/common/configuration/integrations/childProcess.mdx b/docs/platforms/javascript/common/configuration/integrations/childProcess.mdx index 61e0ef1e52b4f..e9625ae04a0bb 100644 --- a/docs/platforms/javascript/common/configuration/integrations/childProcess.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/childProcess.mdx @@ -1,28 +1,14 @@ --- title: Child Process Integration description: "Adds instrumentation for child processes and worker threads (default)" +supportedCategories: + - server supported: - - javascript.node - - javascript.eve - - javascript.mastra - - javascript.aws-lambda - - javascript.azure-functions - - javascript.connect - - javascript.express - - javascript.fastify - - javascript.gcp-functions - - javascript.hapi - - javascript.hono - - javascript.koa - - javascript.nestjs - javascript.electron - - javascript.nextjs - - javascript.nuxt - - javascript.sveltekit - - javascript.remix - - javascript.react-router - - javascript.astro - - javascript.tanstackstart-react +notSupported: + - javascript.bun + - javascript.deno + - javascript.cloudflare --- diff --git a/docs/platforms/javascript/common/configuration/integrations/fastify.mdx b/docs/platforms/javascript/common/configuration/integrations/fastify.mdx index 2a3100fddb41c..3b911ed0fb694 100644 --- a/docs/platforms/javascript/common/configuration/integrations/fastify.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/fastify.mdx @@ -1,11 +1,11 @@ --- title: Fastify description: "Adds performance instrumentation for Fastify. (default)" -supported: - - javascript.node - - javascript.eve - - javascript.mastra - - javascript.fastify +supportedCategories: + - server +notSupported: + - javascript.deno + - javascript.cloudflare --- For more information on setting up Sentry Fastify support, see the [Fastify Sentry documentation](/platforms/javascript/guides/fastify/). diff --git a/docs/platforms/javascript/common/configuration/integrations/hapi.mdx b/docs/platforms/javascript/common/configuration/integrations/hapi.mdx index f2718375fbe47..c862492e54319 100644 --- a/docs/platforms/javascript/common/configuration/integrations/hapi.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/hapi.mdx @@ -1,11 +1,10 @@ --- title: Hapi description: "Adds performance instrumentation for Hapi. (default)" -supported: - - javascript.node - - javascript.eve - - javascript.mastra - - javascript.hapi +supportedCategories: + - server +notSupported: + - javascript.cloudflare --- For more information on setting up Sentry Hapi support, see the [Hapi Sentry documentation](/platforms/javascript/guides/hapi/). diff --git a/docs/platforms/javascript/common/configuration/integrations/koa.mdx b/docs/platforms/javascript/common/configuration/integrations/koa.mdx index 3c0b8788c33bd..6e0707bb10b39 100644 --- a/docs/platforms/javascript/common/configuration/integrations/koa.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/koa.mdx @@ -1,11 +1,10 @@ --- title: Koa description: "Adds performance instrumentation for Koa. (default)" -supported: - - javascript.node - - javascript.eve - - javascript.mastra - - javascript.koa +supportedCategories: + - server +notSupported: + - javascript.cloudflare --- For more information on setting up Sentry Koa support, see the [Koa Sentry documentation](/platforms/javascript/guides/koa/). diff --git a/docs/platforms/javascript/common/configuration/integrations/postgresjs.mdx b/docs/platforms/javascript/common/configuration/integrations/postgresjs.mdx index 4715fc793b259..bc7c78fd30f99 100644 --- a/docs/platforms/javascript/common/configuration/integrations/postgresjs.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/postgresjs.mdx @@ -1,9 +1,10 @@ --- title: Postgres.js description: "Adds instrumentation for the postgres (postgres.js) library." -supported: +supportedCategories: + - server +notSupported: - javascript.cloudflare - - javascript.deno --- From 5d8542479b6a2841c655b6014ca27b9db654f855 Mon Sep 17 00:00:00 2001 From: Francesco Novy Date: Mon, 21 Sep 2026 09:16:01 +0200 Subject: [PATCH 2/2] docs(js): extend fastify/koa/hapi/postgresjs to deno and cloudflare These integrations are also available on the edge runtimes, so drop the notSupported runtime exclusions and let them show across all server SDKs: - fastify: also available on deno and cloudflare. - hapi: also available on cloudflare. - koa: also available on cloudflare. - postgresjs: also available on cloudflare. Remove the "only works in Node.js and Bun runtimes" alerts from fastify, hapi, and koa, which no longer hold. Co-Authored-By: Claude Opus 4.8 (1M context) --- .../common/configuration/integrations/fastify.mdx | 9 --------- .../common/configuration/integrations/hapi.mdx | 8 -------- .../javascript/common/configuration/integrations/koa.mdx | 8 -------- .../common/configuration/integrations/postgresjs.mdx | 2 -- 4 files changed, 27 deletions(-) diff --git a/docs/platforms/javascript/common/configuration/integrations/fastify.mdx b/docs/platforms/javascript/common/configuration/integrations/fastify.mdx index 3b911ed0fb694..dcbd131918a96 100644 --- a/docs/platforms/javascript/common/configuration/integrations/fastify.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/fastify.mdx @@ -3,19 +3,10 @@ title: Fastify description: "Adds performance instrumentation for Fastify. (default)" supportedCategories: - server -notSupported: - - javascript.deno - - javascript.cloudflare --- For more information on setting up Sentry Fastify support, see the [Fastify Sentry documentation](/platforms/javascript/guides/fastify/). - - -This integration only works in the Node.js and Bun runtimes. - - - _Import name: `Sentry.fastifyIntegration`_ This integration is enabled by default when performance monitoring is enabled. If you'd like to modify your default integrations, read [this](./../#modifying-default-integrations). diff --git a/docs/platforms/javascript/common/configuration/integrations/hapi.mdx b/docs/platforms/javascript/common/configuration/integrations/hapi.mdx index c862492e54319..791044dbecc4b 100644 --- a/docs/platforms/javascript/common/configuration/integrations/hapi.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/hapi.mdx @@ -3,18 +3,10 @@ title: Hapi description: "Adds performance instrumentation for Hapi. (default)" supportedCategories: - server -notSupported: - - javascript.cloudflare --- For more information on setting up Sentry Hapi support, see the [Hapi Sentry documentation](/platforms/javascript/guides/hapi/). - - -This integration only works in the Node.js and Bun runtimes. - - - _Import name: `Sentry.hapiIntegration`_ This integration is enabled by default when performance monitoring is enabled. If you'd like to modify your default integrations, read [this](./../#modifying-default-integrations). diff --git a/docs/platforms/javascript/common/configuration/integrations/koa.mdx b/docs/platforms/javascript/common/configuration/integrations/koa.mdx index 6e0707bb10b39..ac708ed44940b 100644 --- a/docs/platforms/javascript/common/configuration/integrations/koa.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/koa.mdx @@ -3,18 +3,10 @@ title: Koa description: "Adds performance instrumentation for Koa. (default)" supportedCategories: - server -notSupported: - - javascript.cloudflare --- For more information on setting up Sentry Koa support, see the [Koa Sentry documentation](/platforms/javascript/guides/koa/). - - -This integration only works in the Node.js and Bun runtimes. - - - _Import name: `Sentry.koaIntegration`_ This integration is enabled by default when performance monitoring is enabled. If you'd like to modify your default integrations, read [this](./../#modifying-default-integrations). diff --git a/docs/platforms/javascript/common/configuration/integrations/postgresjs.mdx b/docs/platforms/javascript/common/configuration/integrations/postgresjs.mdx index bc7c78fd30f99..cb94803e35b90 100644 --- a/docs/platforms/javascript/common/configuration/integrations/postgresjs.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/postgresjs.mdx @@ -3,8 +3,6 @@ title: Postgres.js description: "Adds instrumentation for the postgres (postgres.js) library." supportedCategories: - server -notSupported: - - javascript.cloudflare ---