diff --git a/docs/platforms/javascript/common/configuration/integrations/prisma.mdx b/docs/platforms/javascript/common/configuration/integrations/prisma.mdx index 1142dd1ac8d163..7fdbee6cc577d0 100644 --- a/docs/platforms/javascript/common/configuration/integrations/prisma.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/prisma.mdx @@ -11,7 +11,7 @@ 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 and supports Prisma versions 5, 6 & 7. In Prisma v5, you need to follow the instructions below to enable tracing. +This integration is enabled by default and supports Prisma versions 5, 6, 7 & 8. 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. @@ -26,6 +26,20 @@ Sentry.init({ }); ``` +## Prisma Version 8 + +_Available since: `11.1.0`_ + +No configuration is required. Prisma 8 has no built-in tracing, so the SDK instruments it through diagnostics channels. If channel injection is disabled (`enableRuntimeChannelInjection: false` without build-time injection), no Prisma 8 spans are created. + +Each ORM call creates a `prisma:client:operation` span with the `pg` query spans nested underneath. `db.sql`, `db.raw`, and `groupBy` calls only create `pg` query spans. + + + +On Node.js 20, CommonJS apps only get `pg` query spans. + + + ## Prisma Version 5 To configure the integration for Prisma version 5, first add the `tracing` feature flag to the `generator` block of your Prisma schema: @@ -48,8 +62,8 @@ Sentry.init({ ## Supported Versions -- `prisma`: `5.x`, `6.x`, `7.x` +- `prisma`: `5.x`, `6.x`, `7.x`, `8.x` ## Learn More -For details on the span structure that Prisma's OpenTelemetry tracing produces (e.g., `prisma:client:operation`, `prisma:engine:db_query`), see the [Prisma trace output documentation](https://www.prisma.io/docs/orm/prisma-client/observability-and-logging/opentelemetry-tracing#trace-output). +For details on the span structure that Prisma's OpenTelemetry tracing produces in Prisma versions 5 to 7 (e.g., `prisma:client:operation`, `prisma:engine:db_query`), see the [Prisma trace output documentation](https://www.prisma.io/docs/orm/prisma-client/observability-and-logging/opentelemetry-tracing#trace-output). diff --git a/docs/platforms/javascript/guides/cloudflare/configuration/integrations/prisma.mdx b/docs/platforms/javascript/guides/cloudflare/configuration/integrations/prisma.mdx index c6f8ae2472a07d..b9598a2130f007 100644 --- a/docs/platforms/javascript/guides/cloudflare/configuration/integrations/prisma.mdx +++ b/docs/platforms/javascript/guides/cloudflare/configuration/integrations/prisma.mdx @@ -18,7 +18,7 @@ Sentry.init({ }); ``` -This integration supports Prisma versions 5, 6, and 7. In Prisma v5, you also need to add the `tracing` preview feature to the `generator` block of your Prisma schema: +This integration supports Prisma versions 5, 6, 7, and 8. In Prisma v5, you also need to add the `tracing` preview feature to the `generator` block of your Prisma schema: ```txt {tabTitle: Prisma Schema} {filename: schema.prisma} {3} generator client { @@ -27,10 +27,12 @@ generator client { } ``` +Prisma 8 support requires SDK version `11.1.0` or higher. Prisma 8 has no built-in tracing, so the SDK instruments it through diagnostics channels. If channel injection is disabled (`enableRuntimeChannelInjection: false` without build-time injection), no Prisma 8 spans are created. Each ORM call creates a `prisma:client:operation` span with the `pg` query spans nested underneath. `db.sql`, `db.raw`, and `groupBy` calls only create `pg` query spans. + ## Supported Versions -- `prisma`: `5.x`, `6.x`, `7.x` +- `prisma`: `5.x`, `6.x`, `7.x`, `8.x` ## Learn More -For details on the span structure that Prisma's OpenTelemetry tracing produces (e.g., `prisma:client:operation`, `prisma:engine:db_query`), see the [Prisma trace output documentation](https://www.prisma.io/docs/orm/prisma-client/observability-and-logging/opentelemetry-tracing#trace-output). +For details on the span structure that Prisma's OpenTelemetry tracing produces in Prisma versions 5 to 7 (e.g., `prisma:client:operation`, `prisma:engine:db_query`), see the [Prisma trace output documentation](https://www.prisma.io/docs/orm/prisma-client/observability-and-logging/opentelemetry-tracing#trace-output).