GeneratorLog 0.0.1-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 add package GeneratorLog --version 0.0.1-alpha
                    
NuGet\Install-Package GeneratorLog -Version 0.0.1-alpha
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="GeneratorLog" Version="0.0.1-alpha" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="GeneratorLog" Version="0.0.1-alpha" />
                    
Directory.Packages.props
<PackageReference Include="GeneratorLog" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add GeneratorLog --version 0.0.1-alpha
                    
#r "nuget: GeneratorLog, 0.0.1-alpha"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package GeneratorLog@0.0.1-alpha
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=GeneratorLog&version=0.0.1-alpha&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=GeneratorLog&version=0.0.1-alpha&prerelease
                    
Install as a Cake Tool

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
dotnet tool install -g GeneratorLog.Analyze

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.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.0.7-alpha 91 4/9/2026
0.0.6-alpha 76 3/18/2026
0.0.5-alpha 66 3/18/2026
0.0.4-alpha 69 3/18/2026
0.0.2-alpha 65 3/18/2026
0.0.1-alpha 72 3/18/2026