Repository navigation
Bump API schema to ae87efef - #20186
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
Please update the IS YOUR CHANGE URGENT? section of the PR description:
This information helps the Docs team prioritize your review. |
|
The plan checks API reference page loads, API 404s, and API page latency. An issue escalates when API pages stop loading or API 404s rise. Services: Mention PlanWhat changedAPI reference pages now build from OpenAPI schema SHA ae87efef. The schema JSON matches the previous pin. Page text should stay the same. sentry-docs must deploy before this is live. develop-docs shares this source but does not emit /api/ pages, so it is omitted. RiskA bad schema can omit /api/ routes at build time. Users then see 404 pages for API docs. A schema that parses but has odd fields can break API page render. The blast radius is every /api/ docs page. Other docs paths do not read this SHA. Intended effectAPI pages must keep loading after deploy. The schema JSON did not change, so there is no new page text to detect. Absent: API page loads fall toward zero while other docs pages still load. Last 24h API page loads were 865. The 48h total was 1650, so the prior 24h was about 785. Last 24h all page loads were 18629. API loads were 4.6% of that population.
Regression watchThis change can drop API routes or break API page render. Watch 404s first. Watch API pageload latency on the same path. Last 24h had 20 API 404s and 865 API page loads. That share is 2.3%. Prior 24h had 7 API 404s and about 785 loads. That share is 0.9%. Current 404s already include Last 24h API pageload p95 was 8782ms on 403 sampled spans. Last 48h p95 was 7995ms on 827 spans. This p95 may include slow agent traffic. User traces sample at 30%. Agent traces sample at 100%.
If API 404s rise, inspect which Not observableThe schema SHA is not a runtime metric. The 48h API error query timed out, so there is no prior-day error band. Last 24h had 5 production errors on /api/ URLs. All five used the title Event captured as promise rejection. Field-level copy on each API page is not in telemetry. |
No description provided.