ETLReader 1.0.1

.NET 10.0

The VS Code MCP server configuration entry cannot be generated because the server.json file is invalid. Please refer to the package README and the MCP Configuration Guide for proper setup instructions.

dotnet tool install --global ETLReader --version 1.0.1

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 ETLReader --version 1.0.1

This package contains a .NET tool you can call from the shell/command line.

#tool dotnet:?package=ETLReader&version=1.0.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

nuke :add-package ETLReader --version 1.0.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

ETLReader

An MCP server for analyzing .NET ETL performance traces — CPU stacks, CLR allocations, file I/O, GC, and custom ETW providers.

Install

dotnet tool install -g ETLReader

Or configure in your IDE's MCP settings:

{
  "servers": {
    "ETLReader": {
      "type": "stdio",
      "command": "dnx",
      "args": ["ETLReader", "--version", "1.0.0", "--yes"]
    }
  }
}

Tools (14)

Session Management

Tool	Description
`load_traces`	Load `.etl.zip` files (baseline and/or target) into the session. Must be called first.
`session_status`	Show what's currently loaded.
`prepare_etl`	Extract and index the raw ETL for deep analysis (two-step: `extract` then `index`).

Discovery

Tool	Description
`list_scenarios`	List measured scenarios with time ranges.
`list_processes`	List processes with CPU time, PIDs, command lines, and timing.

Metrics

Tool	Description
`get_metrics`	Get pre-computed counter values for a trace.
`compare_metrics`	Compare counters between baseline and target with noise detection.
`get_metric_lists`	Get detailed list data (e.g. JIT'd methods) with optional diff.
`describe_counter`	Explain what a counter name means and how to investigate it. No session required.

Raw ETL Analysis

Tool	Description
`get_cpu_stacks`	CPU sampling stacks — flat tree, hot path, or baseline/target diff.
`get_clr_data`	CLR runtime data: allocations, JIT, exceptions, contention, GC.
`get_io_activity`	File I/O reads/writes and directory enumerations.
`get_memory`	Process memory usage (working set, commit, private bytes).
`get_etw_events`	Query any ETW provider's events with payloads and stacks.

Configuration

Tool	Description
`get_trace_config`	Get PDC config, consumption settings, and analysis logs.

Platform

ETL is a Windows trace format. Built on Microsoft.Diagnostics.Tracing.TraceEvent (the PerfView engine) and ModelContextProtocol C# SDK. Requires .NET 10.

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
1.0.1	45	6/2/2026