Add troubleshooting section for duplicate native crash events (.NET)#18623
Open
jamescrosswell wants to merge 3 commits into
Open
Add troubleshooting section for duplicate native crash events (.NET)#18623jamescrosswell wants to merge 3 commits into
jamescrosswell wants to merge 3 commits into
Conversation
Documents how to resolve duplicate managed + native crash events on Android and iOS. Covers the preferred (experimental) SignalHandlerStrategy approach and the SuppressSegfaults fallback on Android, and notes the automatic iOS handling as of 6.4.0. Closes #3943 (getsentry/sentry-dotnet). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
Collaborator
Author
|
@jpnurmi would be good to get your eyes on this briefly, to double check it doesn't say anything crazy. |
The new section was nested inside the existing PlatformSection scoped to dotnet.maui/dotnet.apple only, so readers on the plain ".NET for Android" guide (not MAUI) wouldn't see the Android-specific fix. Give it its own PlatformSection that also includes dotnet.android. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
![sentry[bot]](https://avatars.githubusercontent.com/in/12637?s=60&v=4){kind=small}
jamescrosswell
commented
Jul 2, 2026
jamescrosswell
commented
Jul 2, 2026
Resolves https://github.com/getsentry/sentry-docs/pull/18623/changes#r3510081163 Co-authored-by: James Crosswell <jamescrosswell@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
DESCRIBE YOUR PR
Adds a Duplicate events from native crashes section to the .NET Troubleshooting page, covering the case where a single managed exception that surfaces as a native signal (e.g. a
NullReferenceExceptionraised as aSIGSEGV) is reported to Sentry twice — once as the managed .NET exception and once as a native crash.The section documents the platform-specific fixes:
options.Native.ExperimentalOptions.SignalHandlerStrategy = SignalHandlerStrategy.ChainAtStart, with runtime/version caveats, plus theoptions.Android.SuppressSegfaultsfallback.This resolves getsentry/sentry-dotnet#3943 (which asked to document
AndroidOptions.SuppressSegfaults), reframing it around the newer preferred fix landed by @jpnurmi and demotingSuppressSegfaultsto a documented fallback.Related sentry-dotnet PRs: #4676 (Android/Mono), #5126 (iOS), #5127 (Android/CoreCLR); tracking issue #3954.
IS YOUR CHANGE URGENT?
Help us prioritize incoming PRs by letting us know when the change needs to go live.
SLA
Thanks in advance for your help!
PRE-MERGE CHECKLIST
Make sure you've checked the following before merging your changes:
🤖 Generated with Claude Code