Skip to content

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

Merged
sergical merged 4 commits into
masterfrom
docs/claude-platform-otel
Oct 22, 2026
Merged

sergical merged 4 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 22, 2026 8:07pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 22, 2026 8:07pm 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.

Monitoring in production

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, Vercel AI, Mastra, Eve, Flue, and Pi Durable cards stay. The large grid uses four columns and equal row height. 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 four-column grid can raise home page load time. The extra row can hide or crowd the Pi Durable card. 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. The same grid also serves the Pi Durable card.

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. No pre-merge pageload band exists for the Pi Durable guide. Docs telemetry cannot show whether readers finish the Claude Console steps.

]
---

<Include name="feature-available-open-beta-tracing.mdx" />

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sergical Do we know when this will be out of beta?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@coolguyzone coolguyzone left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

sentry-junior Bot and others added 4 commits October 22, 2026 20:00
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>
Co-Authored-By: Sergiy Deceive-skiy <3760543+sergical@users.noreply.github.com>
Co-Authored-By: Sergiy Deceive-skiy <3760543+sergical@users.noreply.github.com>
@sentry-junior
sentry-junior Bot force-pushed the docs/claude-platform-otel branch from 71e1ebf to f7f3701 Compare October 22, 2026 20:01
@sergical
sergical merged commit 374e982 into master Oct 22, 2026
27 checks passed
@sergical
sergical deleted the docs/claude-platform-otel branch October 22, 2026 22:23
@cursor

cursor Bot commented Oct 22, 2026

Copy link
Copy Markdown
Contributor

Verified in production

  • The new Claude Platform guide received views, and the home page stayed healthy.

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — f7f37015 Deployed Oct 22, 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.

2 participants