From 10fb8875ddc663bc4b1afa6fbad7e9d4835e9c9b Mon Sep 17 00:00:00 2001 From: Francesco Novy Date: Thu, 11 Sep 2025 11:12:47 +0200 Subject: [PATCH] feat(js): Update docs for prisma integration --- .../configuration/integrations/prisma.mdx | 29 +++++-------------- 1 file changed, 7 insertions(+), 22 deletions(-) diff --git a/docs/platforms/javascript/common/configuration/integrations/prisma.mdx b/docs/platforms/javascript/common/configuration/integrations/prisma.mdx index 5c68440510aa1..2ddf304fd7c5c 100644 --- a/docs/platforms/javascript/common/configuration/integrations/prisma.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/prisma.mdx @@ -1,6 +1,6 @@ --- title: Prisma -description: "Adds instrumentation for Prisma." +description: "Adds instrumentation for Prisma. (default)" supported: - javascript.node - javascript.aws-lambda @@ -36,13 +36,13 @@ Sentry supports tracing [Prisma ORM](https://www.prisma.io/) queries with the Pr The Prisma Integrations creates a spans for each query and reports to Sentry with relevant details inside the`description` if available. -This integration is enabled by default when using Prisma version 6 or higher. -When using Prisma version 5 this integration requires additional setup, which you can read about below. +This integration is enabled by default and supports Prisma versions 5 & 6. In Prisma v5, you need to follow the instructions below to enable tracing. + If you'd like to learn how to modify your default integrations, visit the docs on Modifying Default Integrations. ## Prisma Version >=6 -To use the integration with Prisma version >=6, add the `prismaIntegration` to your Sentry initialization as follows: +To use the integration with Prisma version >=6, no configuration is required - tracing in Prisma v6 is enabled by default. ```javascript {3} Sentry.init({ @@ -62,30 +62,15 @@ generator client { } ``` -For Prisma version 5 compatibility you must pass a specific version of the Prisma instrumentation to the Sentry Prisma integration. Add the `prismaIntegration` to your Sentry initialization as follows: - -```javascript {1,6-9} -import { PrismaInstrumentation } from "@prisma/instrumentation"; +Then, the `prismaIntegration` will automatically capture spans for Prisma queries. +```javascript {3} Sentry.init({ tracesSampleRate: 1.0, - integrations: [ - Sentry.prismaIntegration({ - // Override the default instrumentation that Sentry uses - prismaInstrumentation: new PrismaInstrumentation(), - }), - ], + integrations: [Sentry.prismaIntegration()], }); ``` -## Options - -### `prismaInstrumentation` - -_Type: `Instrumentation`_ (An OpenTelemetry type) - -Overrides the instrumentation used by the Sentry SDK with the passed in instrumentation instance. - ## Supported Versions - `prisma`: `>=5`