Retrace.Exit
0.1.0
dotnet tool install --global Retrace.Exit --version 0.1.0
dotnet new tool-manifest
dotnet tool install --local Retrace.Exit --version 0.1.0
#tool dotnet:?package=Retrace.Exit&version=0.1.0
nuke :add-package Retrace.Exit --version 0.1.0
Retrace.Exit
A dotnet tool that scans a .NET solution for Stackify Retrace usage and writes an OpenTelemetry migration report.
BMC Helix is retiring Retrace on 31 March 2027. After that date you cannot log in, ingest data, or read stored data, and there is no automated conversion off Retrace's agents and profilers. Official announcement: Stackify Retrace End of Life letter.
Retrace.Exit inventories what is in your repo so you can plan the move. It does not rewrite your code, it does not send data over the network, and it never prints API keys.
Install
Requires the .NET 10 SDK (or a later major, via roll-forward).
dotnet tool install -g Retrace.Exit
From a local pack (this repository):
dotnet pack src/Retrace.Exit/Retrace.Exit.csproj -c Release
dotnet tool install -g Retrace.Exit --add-source ./nupkg
Usage
retrace-exit ./src
retrace-exit ./src --format markdown --out retrace-exit-report.md
retrace-exit ./src --format html --out retrace-exit-report.html
retrace-exit ./src --backend azure-monitor --emit-snippets ./otel-snippets
retrace-exit --help
| Option | Meaning |
|---|---|
path |
Directory to scan (default: current directory). bin, obj, .git, node_modules, .vs, packages, and nupkg are skipped. |
--format markdown|html |
Report format (default: markdown). |
--out <file> |
Write the report to a file instead of stdout. |
--backend azure-monitor|grafana|otlp|signoz |
Chooses which starter snippets to include (default: azure-monitor). |
--emit-snippets <dir> |
Also write starter snippet files into a directory. |
What it looks for
- NuGet /
packages.configreferences (StackifyLib,StackifyMiddleware,Serilog.Sinks.Stackify,NLog.Targets.Stackify,StackifyLib.log4net,Stackify.AzureWebApps, and other official packages) Stackify.json(AppName, Environment,Instrumentation[],CaptureAllExceptions)appsettings*.jsonStackifysections andWeb.config/App.configkeys (Stackify.ApiKey,Stackify.AppName,Stackify.Environment)- Log appenders and sinks (
WriteTo.Stackify(),StackifyAppender,StackifyTarget) - Code:
ProfileTracer.CreateAsOperation,StackifyLib.Metrics,RequestTracerMiddleware,ConfigureStackifyLogging,StackifyHttpModule - The Retrace profiler GUID (
cf0d821e-299b-5307-a3d8-b283c03916da) in Dockerfiles, Compose, and environment files
The report includes a findings table, next-step checklist, and starter OpenTelemetry snippets:
- ASP.NET Core → Microsoft OpenTelemetry Distro for Azure Monitor, or an OTLP exporter for Grafana / SigNoz
- IIS / .NET Framework 4.6.2+ → OpenTelemetry .NET zero-code instrumentation (
Register-OpenTelemetryForIIS)
OpenTelemetry auto-instrumentation is not a like-for-like copy of the Retrace profiler (method-level call trees, first-chance exceptions, and query-parameter capture differ). The official comparison is in BMC's Helix AIOps with OpenTelemetry guide.
Sample output
Against the fixtures in samples/:
# Retrace Exit report
Scanned: `./samples`
Backend hint: `azure-monitor`
Findings: 24 (15 critical, 9 warning, 0 info)
Stackify Retrace reaches end of life on **31 March 2027**. ...
## Summary
| Severity | Kind | Path | Line | Detail |
| --- | --- | --- | --- | --- |
| critical | nuget | `aspnetcore-shop/Sample.AspNetCoreShop.csproj` | 8 | Package 'StackifyMiddleware' is referenced. ... |
| critical | stackify-json | `aspnetcore-shop/Stackify.json` | | Stackify.json found. ... AppName=Sample.AspNetCoreShop ... |
| critical | xml-config | `netframework-iis/Web.config` | 4 | Config contains 'Stackify.ApiKey'. The key value was not copied into this report. ... |
| warning | code | `netframework-iis/CheckoutService.cs` | 12 | Found 'ProfileTracer.CreateAsOperation'. Replace with ActivitySource.StartActivity ... |
The full report then appends suggested next steps and copy-paste snippets for the chosen backend. API key values such as those in the samples are never written into the report.
Build and test
dotnet test Retrace.Exit.slnx
dotnet pack src/Retrace.Exit/Retrace.Exit.csproj -c Release
The sample projects under samples/ are scan fixtures only; they are not built (they intentionally reference Stackify packages and contain a fake API key).
Need help migrating?
If you want a hands-on move off Retrace for ASP.NET Core or IIS / .NET Framework — inventory, OpenTelemetry pilot, Azure Monitor or Grafana landing, then removal of the Retrace agents — book a 15-minute fit check:
License
MIT © 2026 Aykut Mayali. See LICENSE.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0 | 0 | 11/18/2026 |