Skip to content

docs(rust): Use new sentry-tracing layers - #20290

Merged
szokeasaurusrex merged 4 commits into
masterfrom
docs/rust-tracing-layers-0.49.4
Oct 28, 2026
Merged

szokeasaurusrex merged 4 commits into
masterfrom
docs/rust-tracing-layers-0.49.4

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

sentry-rust 0.49.4 deprecated sentry::integrations::tracing::layer(), SentryLayer, and EventFilter. It replaced them with independently selectable layers, and recommends SpanLayer and LogLayer for most applications (getsentry/sentry-rust#1342). The Rust docs still showed only the deprecated API.

  • tracing guide: The example registers SpanLayer and LogLayer with LevelFilter::INFO. I removed the product option toggles because the example no longer depends on them. The page links the API docs for each layer and mentions ErrorLayer/BreadcrumbLayer as legacy options. It also has a deprecation warning that links the migration guide for the latest 0.49.x release (~0.49). The Verify section now covers traces and logs.
  • Logs: Uses LogLayer with LevelFilter::INFO, and explains in prose why filtering is recommended.
  • Automatic instrumentation: Uses SpanLayer with LevelFilter::INFO.

I compiled and ran the new snippets against sentry 0.49.4, with no deprecation warnings. Heads-up: #19989 also edits the tracing guide, so one of the two PRs will need a rebase.

Resolves #20289

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

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

--

View Junior Session [Sentry]

sentry-rust 0.49.4 deprecated sentry::integrations::tracing::layer(),
SentryLayer, and EventFilter in favor of independently selectable
SpanLayer, LogLayer, ErrorLayer, and BreadcrumbLayer. Update the tracing
guide, logs page, and automatic instrumentation page to use the new
layers with explicit level filters.

Resolves #20289

Co-Authored-By: Daniel Szoke <7881302+szokeasaurusrex@users.noreply.github.com>
@vercel

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

Request Review

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Oct 28, 2026
@codeowner-assignment
codeowner-assignment Bot requested a review from a team October 28, 2026 11:45
@cursor

cursor Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

Monitoring services · Rollout details

Status Service Environment
✅ Verified sentry-docs production

Mention @rollout in a comment to update the plan.

Comment thread docs/platforms/rust/common/logs/index.mdx Outdated
Comment thread docs/platforms/rust/guides/tracing/index.mdx
Comment thread docs/platforms/rust/guides/tracing/index.mdx Outdated
Comment thread docs/platforms/rust/guides/tracing/index.mdx Outdated
Drop ErrorLayer and BreadcrumbLayer from the tracing guide example and
mention them only as legacy options. Remove the product option toggles
from the guide, since the example no longer depends on them. Link the
layer API docs, point the migration guide at the latest 0.49.x release,
and explain LogLayer filtering on the logs page.
Comment thread docs/platforms/rust/common/logs/index.mdx Outdated
Comment thread docs/platforms/rust/common/tracing/instrumentation/automatic-instrumentation.mdx Outdated
Place the LogLayer filter recommendation after the example on the logs
page, and describe automatic instrumentation in terms of SpanLayer with
the same filter recommendation.
Comment thread docs/platforms/rust/common/logs/index.mdx Outdated
Comment thread docs/platforms/rust/common/tracing/instrumentation/automatic-instrumentation.mdx Outdated
Drop the fmt layer from the logs example and comment the LogLayer
filter. Describe SpanLayer without tying it to tracing::instrument.
@szokeasaurusrex
szokeasaurusrex merged commit 9dbe5a7 into master Oct 28, 2026
27 checks passed
@szokeasaurusrex
szokeasaurusrex deleted the docs/rust-tracing-layers-0.49.4 branch October 28, 2026 12:45

This branch was successfully deployed

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

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Rust tracing docs for new sentry-tracing layers

1 participant