Skip to content

Enable Unix Helix crash dump capture #7780

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
svick merged 5 commits into from
Oct 15, 2026
Merged

Enable Unix Helix crash dump capture #7780

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
a5d238d
Enable Unix Helix crash dump capture
svick Oct 12, 2026
bf216a3
Temporarily probe macOS Helix SIGSEGV capture
svick Oct 12, 2026
86c5991
Make the temporary dump probe trigger a fatal native fault
svick Oct 12, 2026
c6dd7b1
Remove temporary crash probe after successful CI validation
svick Oct 12, 2026
4e06579
Merge branch 'main' into test/helix-crash-capture
svick Oct 13, 2026
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
6 changes: 6 additions & 0 deletions docs/project-docs/developer-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,12 @@ If you would like to run these specific unit test(s) multiple times, do the foll

These steps are demonstrated in this demonstrative [commit](https://github.com/dotnet/machinelearning/commit/2fb5f8cfcd2a81f27bc22ac6749f1ce2045e925b).

## Collecting crash dumps from Unix Helix tests

The Unix Helix test runner enables .NET crash dumps and JSON crash reports in `HELIX_DUMP_FOLDER`. Download the `.dmp` and `.crashreport.json` files from the failed work item's Helix artifacts. Dump-generation diagnostics are written to the console log; check these if no dump was uploaded.

The JSON report contains thread stacks and can be inspected without a matching-OS debugger. For deeper native analysis, open the dump on the matching OS with the runtime and native binaries from the Helix payload.

## Running unit tests through VSTest Task and collecting memory dumps

During development, there may also arise a need to debug hanging tests. In this scenario, it can be beneficial to collect the memory dump while a given test is hanging.
Expand Down
7 changes: 7 additions & 0 deletions eng/testing/runTests.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,13 @@

EXECUTION_DIR=$(dirname "$0")

if [[ -n "$HELIX_DUMP_FOLDER" ]]; then
export DOTNET_DbgEnableMiniDump=1
export DOTNET_EnableCrashReport=1
export DOTNET_DbgMiniDumpName="$HELIX_DUMP_FOLDER/coredump.%p.%t.dmp"
export DOTNET_CreateDumpDiagnostics=1
fi




Expand Down
Loading