[sentry-api-schema-updater]

No description provided.

[vercel]

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

Project	Deployment	Actions	Updated
develop-docs	Ready	Preview	Oct 27, 2026 4:58pm UTC
sentry-docs	Ready	Preview	Oct 27, 2026 4:58pm UTC

[github-actions]

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]

The plan checks API page loads, API not-found counts, and client errors on API pages. An issue escalates when API page loads drop or those 404s and errors rise.

Monitoring in production

Services: sentry-docs.

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

Plan

What changed

The docs build now fetches the OpenAPI schema at pin c2484fe9. The OpenAPI JSON blob at that pin matches the prior pin. API docs pages should stay the same after this deploy. sentry-docs must ship before the new pin is live.

Risk

A failed schema fetch fails the production build. A parse that drops endpoints would 404 API pages. This pin does not change the JSON. Content risk is low. The deploy still rebuilds the full docs site.

Intended effect

This pin does not change API page content. Production does not emit the schema pin as a metric. There is no new behavior to measure. Report intended_effect as unknown.

Regression watch

Watch the API docs path first. Watch site-wide not-found counts because this deploy rebuilds every docs page.

Last 24 hours is 2026-10-26T16:52:00Z to 2026-10-27T16:52:00Z. Daily bands use complete UTC days 2026-10-20 through 2026-10-26.

Signal	Baseline	Window	Rule	Source
API page loads	Last 24 hours 783. Complete days 190-1086 per day	2026-10-26T16:52:00Z to 2026-10-27T16:52:00Z, and complete days 2026-10-20 to 2026-10-26	Hold inside 190-1086 per day. Fall below 190 is a regression	Sentry sentry/docs metric docs.page.load with page_type:api
Site-wide not-found	Last 24 hours 97. Complete days 42-157 per day	Same windows	Hold inside 42-157 per day. Rise above 157 is a regression	Sentry sentry/docs metric docs.page.not_found
API page errors	Last 24 hours 3 events on 783 API page loads, 0.4%. Complete days 2-13 events except 25 Oct	Same windows	Hold at or below 2.6% of API page loads. Rise above that band is a regression	Sentry sentry/docs errors, environment:production and url /api/
API pageload 404 and 500	0 of 300 sampled pageloads	2026-10-26T16:52:00Z to 2026-10-27T16:52:00Z	Hold at 0	Sentry sentry/docs spans, span.op:pageload, http.response_status_code 404 or 500, url.full /api/, environment:production

25 Oct had 296 API URL errors. Treat that day as an outlier. Do not use it as the band.

API page load share of docs.page.load was 783 of 19435 in the last 24 hours, about 4%. A collapse of API page loads while other page types stay up means the API pages are gone.

If not-found counts rise, inspect requested_path values that start with api.

Not observable

Production does not expose the schema pin SHA. The full not-found sum for paths that start with api was not measured. A filter on requested_path starting with api timed out. Top paths in the last 24 hours showed 3 not-found events on api/event and 3 on api/alerts.