From 867a8a452722093230f609cf465841543b0bf014 Mon Sep 17 00:00:00 2001 From: Abdelrahman Awad Date: Wed, 22 Oct 2025 18:10:02 +0300 Subject: [PATCH 1/4] feat: added nuxt nitro server features --- .../nuxt/features/nitro-server-features.mdx | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx diff --git a/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx b/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx new file mode 100644 index 0000000000000..93a38516a0a0f --- /dev/null +++ b/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx @@ -0,0 +1,40 @@ +--- +title: Nitro Server Features +description: "Learn which Nitro server features are automatically instrumented by the Sentry Nuxt SDK." +--- + +The Sentry Nuxt SDK automatically instruments various Nitro server APIs to provide performance monitoring and error tracking for your server-side code. + +## Server Middleware + +The Sentry Nuxt SDK automatically instruments [server middleware handlers](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-middleware) in addition to server event handlers. + +## Storage + +The Sentry Nuxt SDK automatically instruments [storage APIs](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-storage) (also known as KV storage) and common operations. + + + +Only the storage mounts configured under `nitro.storage` in your `nuxt.config.ts` will be instrumented. + + + +## Cache + +The Sentry Nuxt SDK automatically instruments [cache APIs](https://nitro.build/guide/cache) for the following Nitro functions: + +- `defineCachedEventHandler` +- `cachedEventHandler` +- `cachedFunction` + +This provides spans in your transactions that represent cache operations and their durations, including cache hits. + +## Database + +The Sentry Nuxt SDK automatically instruments [database APIs](https://nitro.build/guide/database). This provides spans in your transactions that represent database query operations and their durations, enabling you to identify slow queries, track query frequency, and optimize your database interactions. + + + +Database instrumentation only applies to database mounts configured under `nitro.database` in your `nuxt.config.ts` and only when `nitro.experimental.database` is set to `true`. + + From 4410280909a1953bb9a3b38ac7d31518898414fb Mon Sep 17 00:00:00 2001 From: Abdelrahman Awad Date: Wed, 22 Oct 2025 18:12:19 +0300 Subject: [PATCH 2/4] fix: added availability --- .../nuxt/features/nitro-server-features.mdx | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx b/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx index 93a38516a0a0f..1d61248b94da7 100644 --- a/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx +++ b/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx @@ -7,10 +7,20 @@ The Sentry Nuxt SDK automatically instruments various Nitro server APIs to provi ## Server Middleware + + Server middleware instrumentation is available from version `@sentry/nuxt` + 10.17.0 and up. + + The Sentry Nuxt SDK automatically instruments [server middleware handlers](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-middleware) in addition to server event handlers. ## Storage + + Storage instrumentation is available from version `@sentry/nuxt` 10.21.0 and + up. + + The Sentry Nuxt SDK automatically instruments [storage APIs](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-storage) (also known as KV storage) and common operations. @@ -21,6 +31,10 @@ Only the storage mounts configured under `nitro.storage` in your `nuxt.config.ts ## Cache + + Cache instrumentation is available from version `@sentry/nuxt` 10.21.0 and up. + + The Sentry Nuxt SDK automatically instruments [cache APIs](https://nitro.build/guide/cache) for the following Nitro functions: - `defineCachedEventHandler` @@ -31,6 +45,11 @@ This provides spans in your transactions that represent cache operations and the ## Database + + Database instrumentation is available from version `@sentry/nuxt` 10.21.0 and + up. + + The Sentry Nuxt SDK automatically instruments [database APIs](https://nitro.build/guide/database). This provides spans in your transactions that represent database query operations and their durations, enabling you to identify slow queries, track query frequency, and optimize your database interactions. From 99d8df04d41514b49ece9de41129151c344337c5 Mon Sep 17 00:00:00 2001 From: Abdelrahman Awad Date: Wed, 22 Oct 2025 18:16:33 +0300 Subject: [PATCH 3/4] docs: cleanup --- .../nuxt/features/nitro-server-features.mdx | 34 +++++++------------ 1 file changed, 13 insertions(+), 21 deletions(-) diff --git a/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx b/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx index 1d61248b94da7..1175bcd28f8bd 100644 --- a/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx +++ b/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx @@ -12,22 +12,7 @@ The Sentry Nuxt SDK automatically instruments various Nitro server APIs to provi 10.17.0 and up. -The Sentry Nuxt SDK automatically instruments [server middleware handlers](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-middleware) in addition to server event handlers. - -## Storage - - - Storage instrumentation is available from version `@sentry/nuxt` 10.21.0 and - up. - - -The Sentry Nuxt SDK automatically instruments [storage APIs](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-storage) (also known as KV storage) and common operations. - - - -Only the storage mounts configured under `nitro.storage` in your `nuxt.config.ts` will be instrumented. - - +The Sentry Nuxt SDK automatically instruments [server middleware handlers](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-middleware) in addition to server event handlers. This includes the handler functions and their `onBeforeResponse` and `onRequest` callbacks. ## Cache @@ -43,17 +28,24 @@ The Sentry Nuxt SDK automatically instruments [cache APIs](https://nitro.build/g This provides spans in your transactions that represent cache operations and their durations, including cache hits. -## Database +## Storage - Database instrumentation is available from version `@sentry/nuxt` 10.21.0 and + Storage instrumentation is available from version `@sentry/nuxt` 10.21.0 and up. -The Sentry Nuxt SDK automatically instruments [database APIs](https://nitro.build/guide/database). This provides spans in your transactions that represent database query operations and their durations, enabling you to identify slow queries, track query frequency, and optimize your database interactions. +The Sentry Nuxt SDK automatically instruments [storage APIs](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-storage) (also known as KV storage) and common operations. - +Keep in mind that only the storage mounts configured under `nitro.storage` in your `nuxt.config.ts` will be instrumented. Storage spans will show up in a similar way to [cache](#cache) spans since they both utilize the same underlying Nitro storage API. -Database instrumentation only applies to database mounts configured under `nitro.database` in your `nuxt.config.ts` and only when `nitro.experimental.database` is set to `true`. +## Database + + Database instrumentation is available from version `@sentry/nuxt` 10.21.0 and + up. + +The Sentry Nuxt SDK automatically instruments Nitro's [database API](https://nitro.build/guide/database). This provides spans in your transactions that represent database query operations and their durations, enabling you to identify slow queries, track query frequency, and optimize your database interactions. + +Database instrumentation only applies to database mounts configured under `nitro.database` in your `nuxt.config.ts` and only when `nitro.experimental.database` is set to `true`. From c4bd2bef2622cdd46e207b21f206f9b02e3bfef8 Mon Sep 17 00:00:00 2001 From: Abdelrahman Awad Date: Fri, 24 Oct 2025 13:42:48 +0300 Subject: [PATCH 4/4] fix: shorter availability text --- .../nuxt/features/nitro-server-features.mdx | 19 ++++--------------- 1 file changed, 4 insertions(+), 15 deletions(-) diff --git a/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx b/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx index 1175bcd28f8bd..60306dd165e6b 100644 --- a/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx +++ b/docs/platforms/javascript/guides/nuxt/features/nitro-server-features.mdx @@ -7,18 +7,13 @@ The Sentry Nuxt SDK automatically instruments various Nitro server APIs to provi ## Server Middleware - - Server middleware instrumentation is available from version `@sentry/nuxt` - 10.17.0 and up. - +Available from version `@sentry/nuxt` 10.17.0 and up. The Sentry Nuxt SDK automatically instruments [server middleware handlers](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-middleware) in addition to server event handlers. This includes the handler functions and their `onBeforeResponse` and `onRequest` callbacks. ## Cache - - Cache instrumentation is available from version `@sentry/nuxt` 10.21.0 and up. - +Available from version `@sentry/nuxt` 10.21.0 and up. The Sentry Nuxt SDK automatically instruments [cache APIs](https://nitro.build/guide/cache) for the following Nitro functions: @@ -30,10 +25,7 @@ This provides spans in your transactions that represent cache operations and the ## Storage - - Storage instrumentation is available from version `@sentry/nuxt` 10.21.0 and - up. - +Available from version `@sentry/nuxt` 10.21.0 and up. The Sentry Nuxt SDK automatically instruments [storage APIs](https://nuxt.com/docs/4.x/guide/directory-structure/server#server-storage) (also known as KV storage) and common operations. @@ -41,10 +33,7 @@ Keep in mind that only the storage mounts configured under `nitro.storage` in yo ## Database - - Database instrumentation is available from version `@sentry/nuxt` 10.21.0 and - up. - +Available from version `@sentry/nuxt` 10.21.0 and up. The Sentry Nuxt SDK automatically instruments Nitro's [database API](https://nitro.build/guide/database). This provides spans in your transactions that represent database query operations and their durations, enabling you to identify slow queries, track query frequency, and optimize your database interactions.