GeneratorLog 0.0.2-alpha

This is a prerelease version of GeneratorLog.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet tool install --global GeneratorLog --version 0.0.2-alpha
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local GeneratorLog --version 0.0.2-alpha
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=GeneratorLog&version=0.0.2-alpha&prerelease
                    
nuke :add-package GeneratorLog --version 0.0.2-alpha
                    

GeneratorLog

Tools for recording and analyzing Roslyn source generator events.

Tools

generatorlog — Trace Recorder

Record source generator events from the Microsoft-CodeAnalysis-General provider to a trace file.

Wrap a build command (any platform):

dnx generatorlog -- dotnet build

Windows (system-wide via ETW, no PID needed):

dnx generatorlog [--output|-o <path>]

Attach to a running process (any platform):

dnx generatorlog --pid <pid> [--output|-o <path>]
  • -- <command>: Launches the command and traces it via EventPipe. Works on all platforms.
  • No arguments (Windows only): system-wide ETW capture, auto-elevates via UAC, produces .etl files
  • --pid: attaches to a running process via EventPipe, produces .nettrace files
  • Default output: generators.etl (ETW) or generators.nettrace (EventPipe) with collision avoidance
  • Shows live progress; press Ctrl+C to stop recording

generatorlog-analyze — Trace Analyzer

Analyze trace files containing Roslyn source generator events and display statistics.

dnx generatorlog-analyze [--csv|-c <path>] <file.etl|file.nettrace> [...]
  • Works with .etl files (from ETW) and .nettrace files (from EventPipe)
  • Reports per-process and per-generator statistics: execution counts, min/avg/max timing, cumulative time
  • Optional CSV export with --csv

Installation

One-shot via dnx (.NET 10+)

dnx generatorlog -- dotnet build
dnx generatorlog-analyze generators.nettrace

As global tools

dotnet tool install -g GeneratorLog --version 0.0.2-alpha
dotnet tool install -g GeneratorLog.Analyze --version 0.0.2-alpha

Customer guide

See docs/recording-guide.md for step-by-step instructions to give to customers.

License

MIT

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
0.0.7-alpha 90 4/9/2026
0.0.6-alpha 75 3/18/2026
0.0.5-alpha 64 3/18/2026
0.0.4-alpha 68 3/18/2026
0.0.2-alpha 64 3/18/2026
0.0.1-alpha 71 3/18/2026