Skip to content

Conversation

@jaffrepaul
Copy link
Contributor

Adds four new documentation pages that help users get value from Sentry after initial SDK setup. These fill the gap between "I set up the SDK" and "I'm getting debugging value."

New pages:

  • docs/product/explore/logs/what-to-log.mdx - High-value logging patterns (auth, payments, external APIs, background jobs, feature flags) with search queries and alert examples
  • docs/product/explore/metrics/what-to-track.mdx - Metric patterns for counters, gauges, and distributions with exploration guidance
  • docs/product/explore/trace-explorer/querying-traces.mdx - How to query auto-instrumented data (pageloads, fetch, long animation frames, navigation, resources)
  • docs/product/explore/trace-explorer/custom-spans.mdx - When and how to add custom instrumentation for business flows, third-party APIs, and background jobs

Each guide follows a consistent structure:

  1. The API pattern (show once, reference throughout)
  2. Five practical use cases with code examples
  3. Query patterns for finding the data in Sentry
  4. Alert recommendations

The content was reviewed against the technical-docs and docs-review style guides to ensure it follows Sentry documentation standards (peer tone, code-first, scannable paragraphs, no marketing fluff).

…cs, and traces

Add four new documentation pages that bridge the gap between SDK setup
and getting value from Sentry's observability features:

- what-to-log.mdx: High-value logging patterns with search and alert examples
- what-to-track.mdx: Metric patterns for counters, gauges, and distributions
- querying-traces.mdx: How to query auto-instrumented trace data
- custom-spans.mdx: When and how to add custom instrumentation

Each guide follows a consistent "5 things to add" structure with code
examples, query patterns, and alert recommendations.

Co-Authored-By: Claude <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Feb 2, 2026

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Feb 2, 2026 4:57pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Feb 2, 2026 4:57pm

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.

1 participant