Skip to content

docs(js): Document dataCollection.mcp option - #20106

Open
sentry-junior[bot] wants to merge 3 commits into
masterfrom
jan/js-data-collection-mcp
Open

sentry-junior[bot] wants to merge 3 commits into
masterfrom
jan/js-data-collection-mcp

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Documents the new dataCollection.mcp option for the JavaScript SDK (getsentry/sentry-javascript#25553, spec 0.14.0). mcp controls MCP request and response content and takes precedence over genAI. Until v12, MCP servers fall back to the matching genAI field when an mcp field isn't set, so existing genAI settings keep working.

  • Options: new mcp row, plus a note on genAI that mcp takes precedence for MCP servers
  • MCP monitoring + product getting-started: use mcp as the global control, and document the genAI fallback and the version
  • Data collected: new "MCP Requests And Responses" section

Draft until the SDK PR is merged and released. The docs assume 11.9.0 as the first version with this option. Update the version if it ships in a different release.

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

via Jan Peer Stöcklmair.

--

View Junior Session [Sentry]

Co-Authored-By: Jan Peer Stöcklmair <jan.peer@sentry.io>
@vercel

vercel Bot commented Oct 20, 2026 •

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 21, 2026 8:46am UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 21, 2026 8:46am UTC

Request Review

Co-Authored-By: Jan Peer Stöcklmair <jan.peer@sentry.io>
Co-Authored-By: Jan VamPeer Stöcklmair <jan.peer@sentry.io>
@JPeer264
JPeer264 marked this pull request as ready for review October 21, 2026 08:41
@JPeer264 JPeer264 self-assigned this Oct 21, 2026
@JPeer264
JPeer264 requested review from nicohrubec and s1gr1d October 21, 2026 08:41
@cursor

cursor Bot commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks client errors, page-not-found counts, and page-load volume on the changed docs pages. An issue escalates when client errors or page-not-found counts rise. The new copy has no queryable success signal.

Services: sentry-docs.

Mention @change-monitor in a comment to update the plan.

Plan

What changed

JavaScript docs pages now describe the dataCollection.mcp option. This option controls MCP request and response content. It takes precedence over genAI. MCP servers still follow genAI when mcp is unset.

sentry-docs must deploy before this text is live. The files are MDX under docs/ and ship on docs.sentry.io only.

Risk

These files sit in JavaScript common docs. A render fault can hit every JavaScript guide that inherits them. Users can see a crashed page or a missing page. The product MCP getting-started page has the same render risk.

Intended effect

This is a documentation edit. Telemetry cannot show that the new mcp copy is present. Do not use page-load volume as proof the copy landed. Report intended_effect unknown from telemetry. Absent would mean the live pages still describe only genAI for MCP content.

Regression watch

Watch client errors and missing pages on the JavaScript docs that inherit this common MDX. Also watch the product MCP getting-started page. Pair each count with page-load volume for that same population.

Signal Baseline Window Rule Source
Client error events on JavaScript docs and MCP getting-started URLs 1.1 percent. 83 errors. 7648 page loads. 24h error counts 29 and 54. 2026-10-19T08:42:22Z to 2026-10-21T08:42:22Z Hold near 1.1 percent of page loads. Escalate if the rate rises above 1.5 percent while page loads hold. Sentry org sentry, project docs. Errors: environment:production (http.url:*/platforms/javascript/* OR http.url:*/product/mcp-servers/*) with count(). Page loads: docs.page.load counter, environment:production, path:*platforms/javascript* plus path /product/mcp-servers/getting-started/.
page-not-found count for platforms/javascript 1.1 percent. 86 page-not-found events. 7565 JavaScript page loads. 24h page-not-found counts 37 and 49. 2026-10-19T08:42:22Z to 2026-10-21T08:42:22Z Hold near 1.1 percent of JavaScript page loads. Escalate if the rate rises above 1.5 percent or the 24h count stays above 49 while page loads hold. Sentry org sentry, project docs. Metric docs.page.not_found with requested_path:platforms/javascript and environment:production. Denominator is docs.page.load with path:*platforms/javascript*.
page-not-found count for product/mcp-servers 0 events 2026-10-19T08:42:22Z to 2026-10-21T08:42:22Z Hold at 0. Escalate if any event appears. Sentry org sentry, project docs. Metric docs.page.not_found with requested_path:product/mcp-servers and environment:production.
page-load volume on the changed pages getting-started 83. JavaScript options root 101. JavaScript data-collected root 24. JavaScript mcp-monitoring guides 29. 2026-10-19T08:42:22Z to 2026-10-21T08:42:22Z Hold near these 48h counts. Escalate if getting-started or JavaScript options root falls below half, or if all JavaScript mcp-monitoring loads fall to 0. Sentry org sentry, project docs. Metric docs.page.load counter, environment:production, grouped by path for /product/mcp-servers/getting-started/, /platforms/javascript/configuration/options/, /platforms/javascript/data-management/data-collected/, and path:*mcp-monitoring*.

The 24h error titles are existing client noise. They include a minified TypeError, Algolia fetch failures, and kapa widget failures. Treat a new title or a sharp rise as this change until proven otherwise.

Not observable

Live page text for the new mcp option. 24h docs.page.load volume for JavaScript paths did not return. Pageload traces for JavaScript mcp-monitoring URLs did not return.

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — 835c4d8a Deployed Oct 21, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants