Skip to content

docs(js): Document Prisma 8 support in prismaIntegration - #19628

Merged
chargome merged 5 commits into
masterfrom
prisma-8-support
Oct 6, 2026
Merged

docs(js): Document Prisma 8 support in prismaIntegration#19628
chargome merged 5 commits into
masterfrom
prisma-8-support

Conversation

@chargome

@chargome chargome commented Sep 25, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Documents Prisma 8 support in prismaIntegration, available from SDK 11.1.0 (getsentry/sentry-javascript#24682).

  • Add Prisma 8 to the supported versions on the common and Cloudflare Prisma pages
  • Note that Prisma 8 spans come from channel injection, the span structure, and the unwrapped db.sql, db.raw, and groupBy calls
  • Note that CommonJS apps on Node.js 20 only get pg query spans
  • Scope the Prisma trace output link to Prisma 5 to 7

prisma__v8.x.mdx is intentionally unchanged: it documents SDK 8.x, not Prisma 8.

@vercel

vercel Bot commented Sep 25, 2026 •
edited
Loading

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Oct 6, 2026 2:37pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 6, 2026 2:37pm UTC

Request Review

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Sep 25, 2026
@github-actions github-actions Bot added Priority: Needs Triage The PR description is missing valid priority information and removed Priority: Normal Docs review has no urgent deadline labels Sep 25, 2026
@chargome chargome self-assigned this Oct 1, 2026
chargome and others added 3 commits October 2, 2026 13:45
@chargome @claude
docs(js): Document Prisma 8 support in prismaIntegration
b62ef8d 
Prisma 8 is instrumented through diagnostics channels starting with
SDK 11.1.0. Add it to the supported versions and note its span shape
and limitations.

Refs getsentry/sentry-javascript#24682
Co-Authored-By: Claude Opus 5.5 <[email protected]>
@sentry-junior @chargome
fix(api): Escape numeric comparisons before compiling MDX
392f570 
OpenAPI descriptions allow literal less-than comparisons, but MDX treats them as malformed tags. Escape comparisons in prose without changing code examples or HTML so the custom inbound filter API pages can build.

Co-Authored-By: Charly Gomez <[email protected]>
@sentry-junior @chargome
Revert "fix(api): Escape numeric comparisons before compiling MDX"
1e59802 
This reverts commit ae8a34e.

Co-Authored-By: Charly Gomez <[email protected]>
@chargome
chargome marked this pull request as ready for review October 5, 2026 11:46
@chargome
chargome requested a review from JPeer264 October 5, 2026 11:46
@github-actions

github-actions Bot commented Oct 5, 2026

Copy link
Copy Markdown
Contributor

Please update the IS YOUR CHANGE URGENT? section of the PR description:

  • Select exactly one option.
  • If you selected an urgent or other deadline, provide the date as YYYY-MM-DD.

This information helps the Docs team prioritize your review.

@cursor

cursor Bot commented Oct 5, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

The plan checks Prisma 8 copy, Prisma page client errors, and nearby JavaScript integration page client errors. An issue escalates when Prisma page client errors appear or nearby integration page client errors rise.

Rollout complete

Services: sentry-docs.

Plan

What changed

JavaScript Prisma integration pages now list Prisma 8 as supported from SDK 11.1.0.
The pages describe channel injection, span shape, and unwrapped query helpers.
Server JavaScript guides inherit the common Prisma page.
The Cloudflare guide ships its own Prisma page.
The change is live after sentry-docs deploys.

Risk

Broken MDX or a failed Alert can crash Prisma pages at render time.
Readers of Node, Cloudflare, and other server JavaScript Prisma pages would lose the page.
Other JavaScript integration pages share this MDX render path.

Intended effect

This change is documentation copy. Telemetry does not show the new Prisma 8 wording.
The live pages must show Prisma 8 after deploy. absent means the pages still list only 5.x, 6.x, and 7.x.

Signal Baseline Rule Source
Prisma 8 copy on the Node Prisma page Absent Confirmed when the page shows Prisma Version 8 and 8.x GET https://docs.sentry.io/platforms/javascript/guides/node/configuration/integrations/prisma/ at 2026-10-05T11:47:08Z. The page listed Prisma versions 5, 6 and 7.
Prisma 8 copy on the Cloudflare Prisma page Absent Confirmed when the page lists Prisma 8 and 8.x GET https://docs.sentry.io/platforms/javascript/guides/cloudflare/configuration/integrations/prisma/ at 2026-10-05T11:47:08Z. The page listed Prisma versions 5, 6, and 7.

Regression watch

A failed Alert or MDX render shows first as client errors on Prisma pages.
Nearby JavaScript integration pages would fail next on the same render path.

Signal Baseline band Window Source Compare
Prisma page client errors 0 2026-10-04T11:47:08Z to 2026-10-05T11:47:08Z Sentry org sentry, project docs. Query environment:production url:*configuration/integrations/prisma* with count(). Hold at 0. Any new client error escalates.
JavaScript integration page client errors 0-1 errors per hour 2026-10-04T11:47:08Z to 2026-10-05T11:47:08Z Sentry org sentry, project docs. Query environment:production url:*platforms/javascript*configuration/integrations* hourly count(). The 24 hour total was 1. Hold in 0-1 errors per hour. Rise above 1 error in an hour escalates.

Not observable

Pageload and HTTP span counts for these paths did not return data.
Do not use span duration to judge this change.
Path-scoped web vitals were not available.
SDK Prisma 8 runtime behavior is not part of this documentation change.

JPeer264
JPeer264 approved these changes Oct 5, 2026
View reviewed changes
Comment thread docs/platforms/javascript/common/configuration/integrations/prisma.mdx Outdated
Comment thread docs/platforms/javascript/guides/cloudflare/configuration/integrations/prisma.mdx Outdated
chargome and others added 2 commits October 6, 2026 16:28
@chargome
chargome enabled auto-merge (squash) October 6, 2026 14:28
@chargome
chargome merged commit 3cc950c into master Oct 6, 2026
23 checks passed
@chargome
chargome deleted the prisma-8-support branch October 6, 2026 14:46
@cursor

cursor Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Verified in production

  • The Node and Cloudflare Prisma pages now list Prisma 8.

solnic pushed a commit that referenced this pull request Oct 8, 2026
@chargome @claude
@sentry-junior @JPeer264 @solnic
docs(js): Document Prisma 8 support in prismaIntegration (#19628)
57ebf64 
## DESCRIBE YOUR PR

Documents Prisma 8 support in `prismaIntegration`, available from SDK
11.1.0 (getsentry/sentry-javascript#24682).

- Add Prisma 8 to the supported versions on the common and Cloudflare
Prisma pages
- Note that Prisma 8 spans come from channel injection, the span
structure, and the unwrapped `db.sql`, `db.raw`, and `groupBy` calls
- Note that CommonJS apps on Node.js 20 only get `pg` query spans
- Scope the Prisma trace output link to Prisma 5 to 7

`prisma__v8.x.mdx` is intentionally unchanged: it documents SDK 8.x, not
Prisma 8.

---------

Co-authored-by: Claude Opus 5.5 <[email protected]>
Co-authored-by: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
Co-authored-by: Jan Peer Stöcklmair <[email protected]>

This branch was successfully deployed

2 active (1 outdated) deployments
Preview – sentry-docs — 28c13e13 Deployed Oct 6, 2026 by vercel[bot]
View deployment
Preview – develop-docs — 1e598020 Deployed Oct 2, 2026 by vercel[bot]
View deployment
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@JPeer264 JPeer264 JPeer264 approved these changes

Assignees

@chargome chargome

Labels

Priority: Needs Triage The PR description is missing valid priority information

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@chargome @JPeer264