Skip to content

Document the DisableSentryHttpMessageHandler configuration option#17012

Open
jamescrosswell wants to merge 3 commits intomasterfrom
jamescrosswell/docs/disable-sentry-http-message-handler
Open

Document the DisableSentryHttpMessageHandler configuration option#17012
jamescrosswell wants to merge 3 commits intomasterfrom
jamescrosswell/docs/disable-sentry-http-message-handler

Conversation

@jamescrosswell
Copy link
Collaborator

Resolves getsentry/sentry-dotnet#4399

PRIORITY

  • None: Not urgent, can wait up to 1 week+

SLA

cc: @Flash0ver

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • 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

…try HTTP instrumentation

When using OpenTelemetry.Instrumentation.Http with AddHttpClientInstrumentation(),
Sentry's built-in SentryHttpMessageHandler would also instrument HTTP requests,
resulting in duplicate spans. The DisableSentryHttpMessageHandler option (added in
5.1.0) prevents this, but was not documented on the OpenTelemetry setup page.

- Add OpenTelemetry.Instrumentation.Http package installation instructions
- Update setup example to include AddHttpClientInstrumentation() and
  DisableSentryHttpMessageHandler = true
- Add an alert explaining when and why to set this option

Fixes GH-4399
Document the DisableSentryHttpMessageHandler option in the .NET tracing
options reference page, including its default value, purpose, and the
version it was introduced (5.1.0).

Refs GH-4399
@vercel
Copy link

vercel bot commented Mar 18, 2026

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Mar 18, 2026 3:39am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Mar 18, 2026 3:39am

Request Review

@codeowner-assignment codeowner-assignment bot requested a review from a team March 18, 2026 03:30
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.

docs: DisableSentryHttpMessageHandler

1 participant