Skip to content

Bump API schema to b342621e - #19985

Merged
sentry-api-schema-updater[bot] merged 1 commit into
masterfrom
bot/bump-api-schema-to-b342621e
Oct 14, 2026
Merged

sentry-api-schema-updater[bot] merged 1 commit into
masterfrom
bot/bump-api-schema-to-b342621e

Conversation

@sentry-api-schema-updater

Copy link
Copy Markdown
Contributor

No description provided.

@vercel

vercel Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
develop-docs Ready Ready Preview Oct 14, 2026 11:36pm UTC
sentry-docs Ready Ready Preview Oct 14, 2026 11:36pm UTC

Request Review

@sentry-api-schema-updater
sentry-api-schema-updater Bot merged commit 14ef5d8 into master Oct 14, 2026
7 of 8 checks passed
@sentry-api-schema-updater
sentry-api-schema-updater Bot deleted the bot/bump-api-schema-to-b342621e branch October 14, 2026 23:28
@github-actions github-actions Bot added the Priority: Needs Triage The PR description is missing valid priority information label Oct 14, 2026
@github-actions

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 14, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks API page loads, API 404s, client errors on API URLs, and API pageload time. An issue escalates when API 404s rise or API page loads fall.

Monitoring in production

Services: sentry-docs, develop-docs.

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

Plan

What changed

The docs build now fetches OpenAPI from SHA b342621e5125399429df4b22093675fd3259add9. That commit does not change openapi-derefed.json. Public REST API pages should keep the same content. sentry-docs and develop-docs must deploy this commit. Only sentry-docs serves those API pages to readers. On develop-docs, /api/ paths redirect to backend design docs.

Risk

A bad schema can fail the sentry-docs build or emit no API pages. Changed slugs can 404 old API URLs. The shared page module also ships to develop-docs. A crash there can fail developer docs pages.

Intended effect

This pin does not add new API page content. The consumed OpenAPI file is unchanged. Confirm the rebuild still emits API pages. The docs.page.load counter with page_type api must hold. Absent means that counter falls toward zero while other page loads hold.

Signal Baseline Window Rule Source
API page loads 785 in the last 24h. 892 in the prior 24h. 1677 in 48h. Share is 785 of 18782 all page loads, about 4.2%. 2026-10-13T23:29:25Z to 2026-10-14T23:29:25Z, and 2026-10-12T23:29:25Z to 2026-10-14T23:29:25Z Hold in 785-890 per 24h, near 4.2% of all page loads. Absent if the 24h count falls below 200 while all page loads stay near 18800. Sentry org sentry, project docs. Query: metric.name:docs.page.load AND page_type:api AND environment:production. All-load query omits page_type.

Regression watch

This pin can drop API pages, 404 old slugs, or crash the shared page module. Watch API 404s, API URL errors, API pageload time, and develop-docs errors.

Signal Baseline Window Rule Source
API 404s 9 in the last 24h. 18 in 48h. Share is 9 of 785 API page loads, about 1.1%. 2026-10-13T23:29:25Z to 2026-10-14T23:29:25Z, and 2026-10-12T23:29:25Z to 2026-10-14T23:29:25Z Hold near 9 per 24h and near 1.0-1.2% of API page loads. Detected if the 24h count rises above 20 or the share rises above 3%. Sentry org sentry, project docs. Query: metric.name:docs.page.not_found AND environment:production AND requested_path:api*
Client errors on API URLs 3 in the last 24h. 10 in 48h. Share is about 0.4-0.8% of API page loads. Recent titles are client TypeError, promise rejection, and Algolia fetch failure. 2026-10-13T23:29:25Z to 2026-10-14T23:29:25Z, and 2026-10-12T23:29:25Z to 2026-10-14T23:29:25Z Hold near 3-7 per 24h. Detected if the 24h count rises above 15 while API page loads hold. Sentry org sentry, project docs. Query: environment:production AND url:"*/api/*"
API pageload p95 4300ms in the last 24h over 717 pageload and navigation spans. 5000ms over 48h. 2026-10-13T23:29:25Z to 2026-10-14T23:29:25Z, and 2026-10-12T23:29:25Z to 2026-10-14T23:29:25Z Hold in 4300-5000ms. Detected if p95 rises above 6500ms. Sentry org sentry, project docs. Query: span.op:[pageload,navigation] AND http.url:"*/api/*" AND environment:production. Fields: count(), p95(span.duration).
develop-docs production errors 24 in the last 24h. 62 in 48h. 1914 page loads in the last 24h, about 1.3 errors per 100 loads. 2026-10-13T23:29:25Z to 2026-10-14T23:29:25Z, and 2026-10-12T23:29:25Z to 2026-10-14T23:29:25Z Hold near 24-38 errors per 24h. Detected if the 24h count rises above 60 while page loads hold. Sentry org sentry, project develop-docs. Query: environment:production

Not observable

The live schema SHA is not in runtime telemetry. Pageload spans for API URLs have no HTTP status. OpenAPI fetch failures occur at Vercel build time, not in Sentry. Field-level API page copy is not measured.

@cursor

cursor Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Verified in production

  • API pages still load on the new build.
  • API pages kept loading for a full day.

This branch was successfully deployed

2 active deployments
Preview – sentry-docs — e059b770 Deployed Oct 14, 2026 by vercel[bot]
Preview – develop-docs — e059b770 Deployed Oct 14, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants