Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 2 additions & 8 deletions includes/dotnet-v7-migration-overview.mdx
Original file line number Diff line number Diff line change
@@ -1,14 +1,8 @@
<Alert level="warning" title="Release candidate">

There is no stable 7.0 release of the Sentry SDK for .NET yet. The current release candidate is `7.0.0-rc.2`. Until 7.0.0 ships, use that version wherever this guide says `7.0.0`. The rest of the .NET docs still describe 6.x until then, so where they differ from this guide, follow this guide. If you run into problems, [open an issue on GitHub](https://github.com/getsentry/sentry-dotnet/issues).
There is no stable 7.0 release of the Sentry SDK for .NET yet. Until 7.0.0 ships, use the latest 7.0.0 release candidate from [NuGet](https://www.nuget.org/packages/Sentry/#versions-body-tab) wherever this guide says `7.0.0`. The rest of the .NET docs still describe 6.x until then, so where they differ from this guide, follow this guide. If you run into problems, [open an issue on GitHub](https://github.com/getsentry/sentry-dotnet/issues).

On `7.0.0-rc.2`, three things work differently from what this guide describes:

- `Logging.AddSentry()` after `ClearProviders()` doesn't add Sentry's logger providers back. Call `UseSentry` after `ClearProviders()` instead.
- `DecompressionMethods` still includes Brotli, which the next release takes out of the default. To leave it out now, set `options.DecompressionMethods = DecompressionMethods.GZip | DecompressionMethods.Deflate` where you initialize Sentry.
- An ASP.NET Core app that sends `ILogger` entries through NLog crashes with a stack overflow when `Debug` is on. In these apps, leave `Debug` off and check that the test event arrives in Sentry instead.

The release candidate's `net11.0` builds depend on the .NET 11 release candidate versions of `Microsoft.Extensions.Http`, `Microsoft.Extensions.Logging.Configuration` and `Microsoft.Extensions.Configuration.Binder`. A .NET 11 app that references 10.0.x of one of these packages directly fails to restore with error NU1605. Remove that reference, or update it to the same .NET 11 release candidate version.
The release candidate's `net11.0` builds depend on the .NET 11 versions of `Microsoft.Extensions.Http`, `Microsoft.Extensions.Logging.Configuration` and `Microsoft.Extensions.Configuration.Binder`. `Sentry.AspNetCore.Blazor.WebAssembly` also depends on the .NET 11 version of `Microsoft.AspNetCore.Components.WebAssembly`. A .NET 11 app that directly references an older version of one of these packages, such as 10.0.x, fails to restore with error NU1605. The error message shows the version the Sentry package needs. Update the reference to that version, or remove it.

</Alert>

Expand Down
Loading