[jamescrosswell]

Note

This targets dotnet-v7, which collects the .NET docs for sentry-dotnet 7.0.0. #20641 merges that branch into master when 7.0.0 ships, so this PR can merge into dotnet-v7 as soon as it's approved.

DESCRIBE YOUR PR

Adds a Generic Host guide for Sentry.Extensions.Hosting, which sentry-dotnet 7.0.0 adds (getsentry/sentry-dotnet#5739). In 7.0.0, Logging.AddSentry() no longer initializes the SDK. Worker services, console apps on the generic host, Windows services and Azure Functions (isolated) apps call UseSentry from this package instead. The page is written for 7.x. The docs aren't versioned, so this goes live with the rest of the 7.0.0 docs.

The guide follows the quick start template from #19990 and covers:

• UseSentry on IHostApplicationBuilder and IHostBuilder, the Sentry and Logging:Sentry sections, and why not to call Logging.AddSentry() as well
• the host environment, "Dsn": "", and when the SDK starts (Build()) and closes (ApplicationStopped)
• ClearProviders() ordering (fix(hosting): start the SDK during Build() even when the app clears or replaces logger providers sentry-dotnet#5772, fix(logging): make Logging.AddSentry() work after UseSentry and ClearProviders() sentry-dotnet#5776, fix(logging): warn when ClearProviders() removes the logger providers UseSentry added sentry-dotnet#5789, docs: add an ASP.NET Core NLog sample and stop advising AddSentry() when another integration handles ILogger sentry-dotnet#5821)
• ASP.NET Core and MAUI apps, and the static UseSentry call that Aspire's AddServiceDefaults needs
• the .NET Framework gap, with the SentrySdk.Init and Logging.AddSentry() fallback and its HubAdapter.Instance registrations (feat(mel)!: Logging.AddSentry() no longer registers IHub or ISentryClient sentry-dotnet#5740)
• replacing SentrySdk.Init, briefly. The migration guide (docs(dotnet): Add 6.x to 7.x migration guide for 7.0.0-rc.2 #20143) covers upgrades.

It also adds platform-includes/configuration/config-intro/dotnet.extensions-hosting.mdx, so the guide's Options page starts with UseSentry instead of SentrySdk.Init.

Closes getsentry/sentry-dotnet#5707

Notes for review

• Registration. A new .NET guide only needs its index.mdx. The platform key dotnet.extensions-hosting comes from the folder name, guides without sidebar_order, like the other .NET guides, are listed by title, and the icon falls back to the .NET one, as for the Microsoft.Extensions.Logging, Serilog and NLog guides. The page is new, so it needs no redirects.
• Package version. The install snippets use packages.version('sentry.dotnet'), because the release registry has no sentry.dotnet.extensions.hosting entry yet. Until 7.0.0 is out, the preview shows 6.12.1, which doesn't exist for this package. Once the registry has the package, switch to its own key. The sdk: frontmatter already uses sentry.dotnet.extensions.hosting (from Constants.cs). Without a registry entry, the page just has no package details box.
• Shared includes that render wrongly for dotnet.extensions-hosting. I left them alone, since other PRs own them:
  • platform-includes/logs/setup/dotnet.mdx falls into the SentrySdk.Init section instead of UseSentry with EnableLogs. docs(dotnet): Update logging docs for SDK 7.0.0 #19925 is adding the key to the host sections.
  • platform-includes/logs/options/dotnet.mdx shows the generic EnableLogs text and leaves out "Configure Microsoft.Extensions.Logging Filters". Same PR.
  • platform-includes/logs/usage/dotnet.mdx shows only the SentrySdk.Logger APIs. The key belongs in the ILogger section too.
  • platform-includes/logs/requirements/dotnet.mdx says logs need SDK version 5.14.0. This package starts at 7.0.0.
• Additions to the brief from the version7 source:
  • "Dsn": "" turns the SDK off, but SENTRY_DSN still wins over an empty Dsn (SettingLocator.GetDsn). The page says so.
  • Logging:Sentry only accepts LogLevel, MinimumBreadcrumbLevel and MinimumEventLevel. Any other key makes Build() throw NotSupportedException. With no DSN anywhere, Build() throws ArgumentNullException.
  • Calling Sentry.AspNetCore's UseSentry twice still sends each error twice (a follow-up in feat: add Sentry.Extensions.Hosting with UseSentry for generic host apps sentry-dotnet#5739). The Aspire section says not to call it again in Program.cs.
• Azure Functions gets one line in the intro. The Azure Functions guide still shows logging.AddSentry(...). docs(dotnet): Update logging docs for SDK 7.0.0 #19925 owns it.
• Links to add once the other PRs merge:
  • Microsoft.Extensions.Logging guide: send generic host apps here, from the "If you use a host integration such as ASP.NET Core or MAUI" paragraph. Its Sentry.Samples.GenericHost sample link belongs here too, since the sample now calls UseSentry.
  • Azure Functions guide: link here from the UseSentry setup.
  • platform-includes/logs/integrations/dotnet.mdx: add Generic Host to the list.
  • docs/product/logs/getting-started/index.mdx and docs/product/metrics/getting-started/index.mdx: add Generic Host to the .NET lists.
  • Migration guide, "Generic Host Apps Call UseSentry": link to this page.
• The sample link points at main, where Sentry.Samples.GenericHost keeps the 6.x setup until version7 is merged.
• The C# snippets compile against version7, on net10.0, and on net48 for the IHostBuilder example and the .NET Framework fallback. On net48, UseSentry on HostApplicationBuilder fails with CS1929, as the page says.

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 10, 2026 2:15am UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
develop-docs	Ignored	Preview	Nov 10, 2026 2:15am UTC

[cursor]

Getting ready to monitor this change · Rollout details

Status	Service	Environment
⏳ Getting ready to monitor this change