Skip to content

docs(agents): Add Claude Platform OTLP guide and Anthropic home card - #19997

Open
sentry-junior[bot] wants to merge 3 commits into
masterfrom
docs/claude-platform-otel
Open

sentry-junior[bot] wants to merge 3 commits into
masterfrom
docs/claude-platform-otel

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Oct 15, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Anthropic shipped native OpenTelemetry trace export from Claude Managed Agents, the Messages API, and the Claude SDKs (public beta), with Sentry as a built-in destination in the Claude Console (announcement). The docs didn't cover it, and the homepage agent integrations list didn't include Anthropic.

  • New page at /concepts/otlp/direct/claude-platform/. It adapts the cookbook recipe: copy the DSN, add Sentry as a Console destination, check delivery, and explore traces in Agents. It links to the TypeScript and Python SDK cookbooks and to the existing Sentry Anthropic integrations. The Console and timeline screenshots are copied from the cookbook.
  • Homepage: new Anthropic card that links to the new page. With six cards, the grid changes from lg:grid-cols-5 to lg:grid-cols-3, so the cards fill two full rows. Providers come first (Anthropic, OpenAI, Vercel AI), then frameworks (Mastra, Eve, Flue).
  • Linked the new page from the Direct OTLP index and from the Agents set-up list.

IS YOUR CHANGE URGENT?

  • Other deadline: 2026-10-16 (follow-up to the 2026-10-14 launch)

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 @sergical.

--

View Junior Session [Sentry]

@vercel

vercel Bot commented Oct 15, 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 15, 2026 2:50pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 15, 2026 2:50pm UTC

Request Review

@github-actions github-actions Bot added the Priority: Deadline Docs review has a specific non-urgent due date label Oct 15, 2026
@cursor

cursor Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

The plan tracks views of the new Claude Platform guide, home page loads, and catch-all route errors. Home page component errors must stay at zero. An issue escalates when catch-all errors rise or the new guide stays at zero.

Services: sentry-docs.

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

Plan

What changed

Requests to /concepts/otlp/direct/claude-platform/ now return the Claude Platform OpenTelemetry guide. The home page agent grid adds an Anthropic card that links to that guide. The Set Up Agents page also links to that guide. OpenAI and Vercel AI cards stay, and the large grid uses three columns. sentry-docs must deploy before this change is live. The Home view does not render on develop-docs, so that site does not ship this UI.

Risk

A render failure in Home blanks the docs home page for visitors. A bad MDX page or missing image returns 404 for the new guide. The three-column grid can raise home page load time. A broken platform-redirect path can hide the OpenAI and Vercel AI cards.

Intended effect

The change worked when pageloads hit the new Claude Platform guide. Absent looks like home page loads staying in band while those pageloads stay at zero.

Signal Baseline Rule Source
Pageloads for url.path /concepts/otlp/direct/claude-platform/ 0 pageloads in 2026-10-14T14:00:00Z to 2026-10-15T14:00:00Z. docs.page.load with path *claude-platform* was also 0. Rise above 0. Sentry org sentry project docs. Spans: is_transaction:true span.op:pageload environment:production url.path:"/concepts/otlp/direct/claude-platform/". Metrics: path:*claude-platform* environment:production sum of docs.page.load.

Regression watch

A Home crash or a failed MDX render shows up as errors on the catch-all route. Home.tsx stack errors must stay at zero. Home page load time and home page load volume must stay in band.

Signal Baseline Rule Source
Error events on transaction /:path*? 222 events in 2026-10-14T14:00:00Z to 2026-10-15T14:00:00Z against 19384 docs.page.load events, about 1.1%. 136 events in 2026-10-13T14:00:00Z to 2026-10-14T14:00:00Z. The page-load total for that prior day is unknown. Hold in 136-222 events per 24h. Hold near 1.1% of docs.page.load when that total is known. Sentry org sentry project docs. Errors: environment:production transaction:":path*?". Page-load total: environment:production sum of docs.page.load.
Errors with stack file home.tsx 0 events in 2026-10-14T14:00:00Z to 2026-10-15T14:00:00Z. Hold at 0. Sentry errors environment:production stack.filename:"*home.tsx*".
p95 pageload duration for url.path / 9585ms in 2026-10-14T14:00:00Z to 2026-10-15T14:00:00Z, 783 sampled pageloads. 8044ms in 2026-10-13T14:00:00Z to 2026-10-15T14:00:00Z, 1467 sampled pageloads. Hold in 8.0-9.6s. Sentry spans is_transaction:true span.op:pageload environment:production url.path:"/" url.full:*docs.sentry.io*. Traces sample at 30%.
docs.page.load with page_type home 1115 in 2026-10-14T14:00:00Z to 2026-10-15T14:00:00Z. 993 in 2026-10-13T14:00:00Z to 2026-10-14T14:00:00Z from the 48h total of 2108. Hold in 990-1120 per 24h. A fall below the band means the home page may not render. Sentry metrics page_type:home environment:production sum of docs.page.load.

Not observable

Home page LCP and CLS were not present on the pageload spans. The Set Up Agents URL returned zero pageloads, so that entry path is not a usable signal. The 48h docs.page.load total timed out, so the prior-day error rate has no denominator. Platform-redirect errors were 73 in the latest 24h. The prior 24h count was 0, so no stable band exists. Docs telemetry cannot show whether readers finish the Claude Console steps.

sentry-junior Bot and others added 3 commits October 15, 2026 14:45
Co-Authored-By: Sergiy Deceive-skiy <3760543+sergical@users.noreply.github.com>
Co-Authored-By: Sergiy Deceive-skiy <3760543+sergical@users.noreply.github.com>
Co-Authored-By: Sergiy Deceive-skiy <3760543+sergical@users.noreply.github.com>

This branch was successfully deployed

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

Labels

Priority: Deadline Docs review has a specific non-urgent due date

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant