Skip to content

docs(operate): add Vercel log drains setup guide#466

Draft
sentry-junior[bot] wants to merge 1 commit into
mainfrom
docs/vercel-log-drains
Draft

docs(operate): add Vercel log drains setup guide#466
sentry-junior[bot] wants to merge 1 commit into
mainfrom
docs/vercel-log-drains

Conversation

@sentry-junior
Copy link
Copy Markdown
Contributor

@sentry-junior sentry-junior Bot commented May 31, 2026

What

Adds a new /operate/vercel-log-drains/ doc page covering how to route Vercel runtime, build, and edge logs into Sentry using Vercel's built-in log drain feature.

Why

Closes #441. Users deploying Junior on Vercel had no docs on how to connect Vercel's native telemetry export to Sentry — this fills the gap.

What's in the page

  • Automatic setup via the Sentry native Vercel integration (new Sentry accounts)
  • Manual setup for existing Sentry accounts: where to find the ingestion endpoint and auth header in Sentry Project Settings > Client Keys (DSN) > Vercel, and step-by-step Vercel dashboard instructions
  • Trace drain variant using the OTLP endpoint from Client Keys > OpenTelemetry (OTLP)
  • Log source table (Functions, Edge, Static, Rewrites, Builds, Firewall)
  • Caveats sourced directly from Sentry and Vercel official docs: metric drain limitations, empty-message logs, static-source display gap, build log trace correlation
  • Explicit links to both official references: docs.sentry.io/product/drains/vercel/ and vercel.com/docs/drains

Also changed

  • Sidebar entry added to astro.config.mjs under Operate
  • operate/observability.md related list and next-step updated to point at the new page

Verified

Content is a docs-only change. Validated against Sentry and Vercel official docs fetched live during this session. No code changed; no automated tests to run.

Action taken on behalf of David Cramer.


View Session in Sentry

Covers both automatic setup (Sentry native integration) and manual setup
for existing accounts. Documents log and trace drain configuration,
log source selection, and platform-specific caveats sourced from:
- https://docs.sentry.io/product/drains/vercel/
- https://vercel.com/docs/drains

Also wires the new page into the sidebar and updates observability.md
to reference it.

Fixes #441

---
[View Session in Sentry](https://sentry.sentry.io/traces/?project=4510944073809921&query=gen_ai.conversation.id%3A%22slack%3AC0AHB7N2JCR%3A1780258891.450269%22)

Co-Authored-By: claude-opus-4-5 <noreply@anthropic.com>

Co-authored-by: David Cramer <david@sentry.io>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 31, 2026

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

Project Deployment Actions Updated (UTC)
junior-docs Ready Ready Preview, Comment May 31, 2026 8:25pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document Sentry log drains setup for Vercel

0 participants