[jamescrosswell]

Warning

Do not merge before sentry-dotnet 7.0.0 is released (planned 2026-11-30).

DESCRIBE YOUR PR

Updates the .NET logging docs for sentry-dotnet 7.0.0. In 7.0.0, SentryOptions.EnableLogs and SentryOptions.EnableMetrics are removed, Serilog, NLog and log4net send logs as soon as they're added, and the Serilog, NLog, log4net and Microsoft.Extensions.Logging integrations no longer initialize the SDK. The pages are written for 7.x. The docs aren't versioned, so this stays a draft until 7.0.0 ships.

• Logs setup, options and usage (platform-includes/logs/*/dotnet.mdx): EnableLogs is only documented on the host options (ASP.NET Core, AWS Lambda, Azure Functions, Blazor Server, Blazor WebAssembly, MAUI). The Serilog, NLog, log4net and Microsoft.Extensions.Logging snippets call SentrySdk.Init and add the integration without a switch. The host and Serilog/NLog/log4net sections explain when EnableLogs sends each log twice.
• Serilog, NLog and log4net guides: initialize Sentry first, then add the sink/target/appender. Removed initializing through the integration, InitializeSdk, and the DSN, environment, release and <options> settings on the NLog target and log4net appender. Documented Serilog's UseSerilog() and the one-time standard-error warning.
• NLog includes: removed dsn from the set-tag and set-user variants, including the options.Dsn that feat(docs): Apply new quick start template to .NET quick start guides #19990 added to the set-tag snippet. Deleted the set-environment, set-release and config-intro variants, so the NLog guide uses the generic .NET pages, which set these on the options passed to SentrySdk.Init.
• Blazor WebAssembly: removed builder.Logging.AddSentry(o => o.InitializeSdk = false), which no longer compiles and was already redundant with UseSentry.
• Azure Functions: installs Sentry.Extensions.Hosting instead of Sentry.Extensions.Logging, and starts Sentry with .UseSentry(options => ...) on the HostBuilder chain instead of logging.AddSentry(options => ...). EnableLogs = true stays in the snippet, now on SentryGenericHostOptions. Apps with the ASP.NET Core integration (ConfigureFunctionsWebApplication()) call the same UseSentry. The "Changed in Version 7.0.0" alert covers 6.x, which has no hosting package.
• ASP.NET: removed EnableLogs from the SentrySdk.Init snippet and from the list of features the snippet turns on. Send Logs now says the Serilog, NLog and log4net integrations send logs as soon as they're added, and points to SetBeforeSendLog for dropping them.
• Metrics options: EnableMetrics was removed in 7.0.0. Kept the advice to return null from SetBeforeSendMetric.

Closes getsentry/sentry-dotnet#5698
Part of getsentry/sentry-dotnet#5706

Notes for review

• The Serilog, NLog and log4net guides each have a new "Capturing Startup Crashes" subsection for apps that want crashes from before UseSentry starts Sentry (Document capturing ASP.NET Core startup crashes with Serilog, NLog and log4net in v7.0.0 sentry-dotnet#5844). Each calls SentrySdk.Init before the builder; the Serilog one does it alongside Serilog's two-stage initialization. The companion samples, docs(samples): capture startup crashes in the ASP.NET Core Serilog sample sentry-dotnet#5847 and docs(samples): capture startup crashes in the ASP.NET Core NLog sample sentry-dotnet#5866, link to them.
• Merged master after feat(docs): Apply new quick start template to .NET quick start guides #19990, which moved the .NET guides to the new quick start template. The Azure Functions and Blazor WebAssembly changes now sit on that template, which already uses UseOtlp() for Azure Functions.
• The Microsoft.Extensions.Logging snippet on the logs setup page uses SentrySdk.Init plus builder.Logging.AddSentry(), and says in one sentence that generic-host apps use UseSentry from Sentry.Extensions.Hosting instead. The Microsoft.Extensions.Logging guide page is updated in docs(dotnet): Update Microsoft.Extensions.Logging guide for SDK 7.0.0 #19961, so this PR only partly covers delete hidden DS pages #5706.
• Azure Functions follows feat: add Sentry.Extensions.Hosting with UseSentry for generic host apps sentry-dotnet#5739. It adds Sentry.Extensions.Hosting with UseSentry, and says Azure Functions (isolated) apps use it, also with the ASP.NET Core integration. Checked against version7: SentryGenericHostOptions.EnableLogs defaults to false, and UseSentry registers Sentry's ILogger providers. ConfigureFunctionsWorkerDefaults() and ConfigureFunctionsWebApplication() return IHostBuilder, so the snippet binds to UseSentry(IHostBuilder, Action<SentryGenericHostOptions>). The SDK starts in Build() and closes when the host stops. The version7 sample makes the same call. feat(mel)!: Logging.AddSentry() no longer registers IHub or ISentryClient sentry-dotnet#5740 stops Logging.AddSentry() from registering IHub, so UseSentry is now also what puts it in DI.
• The logs setup and options includes list dotnet.extensions-hosting in the UseSentry + EnableLogs sections, the appsettings.json tab and the Serilog/NLog/log4net expandables. That's the platform key of the generic-host guide coming in a separate PR, so that PR doesn't need to edit these files. Nothing links to it yet, since the page doesn't exist on this branch. Azure Functions isn't in the Serilog/NLog/log4net expandables: their snippets use builder.Services and builder.Logging, which a HostBuilder chain doesn't have.
• "Before 7.0.0" notes appear only where a 6.x reader following the page would silently get no logs, or replace their SDK setup: the Serilog/NLog/log4net and Microsoft.Extensions.Logging sections of the logs setup page, the EnableLogs option, and the Azure Functions guide.
• feat(discover-homepage): Update Discover homepage docs for GA #5698 says an ASP.NET Core app that also uses the Serilog sink sends each log twice with EnableLogs on. That only happens when ILogger entries reach both Sentry's provider and Serilog. I checked against version7: one LogInformation call was sent once with builder.Host.UseSerilog(), which replaces the logger factory, and twice with builder.Logging.AddSerilog(). The same applies to NLog and log4net when they're registered as ILogger providers. So the docs name that case, registering the framework as an ILogger provider (for example builder.Logging.AddSerilog()), and say to leave EnableLogs off then.
• delete hidden DS pages #5706 describes UseSerilog() as the replacement for ApplySerilogScopeToEvents(). On version7 it's optional: if the app doesn't call it, the sink registers the scope processor itself once it's running, so only events captured before then miss the LogContext properties. The guide says so.
• Changes beyond the two issues:
  • dotnet.blazor-server added to the EnableLogs sections. It uses Sentry.AspNetCore's UseSentry, but it fell into the plain SentrySdk.Init section, which now says logging integrations need no switch.
  • log4net logs usage no longer mentions SentryAppender.Environment, which 7.0.0 removes (feat(log4net)!: the Sentry appender no longer initializes the SDK sentry-dotnet#5592).
  • The NLog set-user snippet used new User. That type doesn't exist, so it's now SentryUser.
• The Azure Functions snippet drops TracesSampleRate and DisableSentryHttpMessageHandler, which the version7 sample still sets. Under UseOtlp() Sentry creates no transactions of its own, so TracesSampleRate has no effect. SentryHttpMessageHandler already skips span creation, so disabling it would only stop it propagating sentry-trace. docs(dotnet): Update OTLP propagation docs for SDK 7.0.0 #19924 documents both.
• The C# and F# snippets I added or changed compile against the version7 sources. The Azure Functions and UseSentry ones compile against the 7.0.0-rc.2 packages, whose public API matches version7.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

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

🤖 Generated with Claude Code

[vercel]

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

Project	Deployment	Actions	Updated
sentry-docs	Ready	Preview	Nov 3, 2026 10:31pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
develop-docs	Ignored	Preview	Nov 3, 2026 10:31pm UTC

[cursor]

This change rewrites logging setup pages for a new SDK major. Readers now see Init-first examples. Three logging frameworks send logs without a flag.

The plan checks page loads, client errors, and RSC fetch failures on those paths. An issue escalates when those pages stop loading or those errors rise.

Services: sentry-docs.

Mention @change-monitor in a comment to update the plan.

Plan

What changed

.NET logging pages now tell readers to call SentrySdk.Init first. Serilog, NLog, and log4net send logs as soon as they are added. EnableLogs stays only for ILogger on some hosts. Azure Functions docs no longer initialize the SDK inside AddSentry. Blazor WebAssembly docs drop the extra AddSentry call.

sentry-docs must deploy before this copy is live. The Vercel production project maps to that service. develop-docs does not ship these paths.

Risk

Wrong copy can make readers skip Init or send each log twice. A PlatformSection mistake can show the wrong snippet on sibling logs pages. Removed NLog includes fall back to generic environment and release copy. A failed MDX render can hide Azure Functions or Blazor setup. The shared logs includes also ship to every .NET logs page.

Intended effect

Telemetry cannot show that the new 7.0.0 wording is live. The executor cannot mark intended_effect from metrics. Inspect the live logging pages if a human check is required.

absent would be the live pages still showing EnableLogs on Serilog, NLog, and log4net. That case stays unknown from telemetry.

Regression watch

This diff can break render of the changed guides and every .NET logs page that pulls the shared includes. Watch client errors and RSC fetch failures first. Those are the symptoms users and on-call would see. Then watch not-found and page-load share so a silent blank path is not missed.

Signal	Baseline	Rule	Source
Client errors on /platforms/dotnet pages	8 events in 2026-10-12T04:09:00Z to 2026-10-13T04:09:00Z. Hourly band 0-3. Peak 3 at 2026-10-12T22:00Z. About 1.9 events per 100 page loads, from 8 events against 431 page loads. Titles were TypeError on mw, promise rejection, and an Algolia NetworkError.	Hold the hourly band at 0-3. Escalate if the next 24h count rises above 8 while page loads hold. Treat one Algolia or mw event as noise.	Sentry org sentry, project docs. Query: environment:production (http.url:*/platforms/dotnet* OR transaction:*/platforms/dotnet*)
RSC fetch failure logs that mention platforms/dotnet	11 matching logs in 2026-10-12T04:09:00Z to 2026-10-13T04:09:00Z. Site-wide RSC fetch failures were 923 in the same window.	Hold the .NET slice near 11 per 24h. Escalate if that slice rises while the site-wide count stays near 923.	Sentry org sentry, project docs. Query: sentry.environment:production message:"*Failed to fetch RSC payload*" message:"*platforms/dotnet*"
docs.page.not_found for platforms/dotnet	2 counts in 2026-10-12T04:09:00Z to 2026-10-13T04:09:00Z. That is about 0.5 not-found per 100 page loads.	Hold 0-2 per 24h. Escalate if the count rises while other platform not-found stays near 19 for platforms/javascript.	Sentry org sentry, project docs. Metric docs.page.not_found. Query: sentry.environment:production requested_path:platforms/dotnet
docs.page.load on /platforms/dotnet	431 loads in 2026-10-12T04:09:00Z to 2026-10-13T04:09:00Z. 5485 loads in 2026-10-06T04:09:00Z to 2026-10-13T04:09:00Z. Share of page_type=platforms loads is 431 of 8792, about 4.9%. Changed-path loads in the 24h window: Serilog 3, log4net 4, Blazor WebAssembly 6, NLog 0, Azure Functions worker 0. .NET logs pages totaled 26.	Hold the .NET share near 4.9%. Escalate if the logs-page group falls toward 0 while other platform logs pages still load. NLog and Azure Functions worker had 0 loads, so they cannot show a drop on their own.	Sentry org sentry, project docs. Metric docs.page.load. Query: environment:production path:*/platforms/dotnet*

Not observable

The new 7.0.0 wording is not in telemetry. Pageload traces did not match these URL transactions, so latency is not a watch. Reader setup mistakes in downstream apps are not in this project.

[jamescrosswell]

@ric-oliv thanks for testing this so thoroughly. Rather than document the workaround, I've opened getsentry/sentry-dotnet#5763 to fix it in the SDK. When the NLog, Serilog or log4net integration already receives an app's ILogger entries, the ILogger providers that UseSentry registers would stand down, so each entry reaches Sentry once whatever order the init calls are in. Your table is in the issue.

Let's hold the duplicate-capture note for the NLog and log4net guides until that's decided. If it lands for 7.0, the note becomes one sentence about which side handles ILogger entries, and the EnableLogs note already in this PR changes the same way. If it doesn't, I'll add your suggestion of setting both Logging:Sentry levels to None.

[jamescrosswell]

Note the External links check will continue to fail until this makes it into main on the sentry-dotnet repo:

• docs: add an ASP.NET Core NLog sample and stop advising AddSentry() when another integration handles ILogger sentry-dotnet#5821 (comment)

That will happen when we make the v7.0.0 release (we don't want to merge these docs until after then anyway).

That PR also addresses the comment from @ric-oliv above.