Installation
Memory.Introspect is distributed on NuGet as Memory.Introspect.
dotnet add package Memory.Introspect
Or, with the PackageReference syntax in your .csproj:
app/MyApp.csproj
<ItemGroup>
<PackageReference Include="Memory.Introspect" Version="*" />
</ItemGroup>
Target frameworks
| Target | Status |
|---|---|
| .NET 8.0 / 9.0 | First-class. |
| .NET 6.0 / 7.0 | Supported. |
| .NET Framework | Not supported — the .NET diagnostics protocol used here is only stable on modern .NET. |
What gets installed
Memory.Introspect.dll— the managed library.- A small set of internal dependencies adapted from the .NET diagnostics tools (TraceEvent, Microsoft.Diagnostics.NETCore.Client, MemoryGraph).
No native binaries, no model files, no startup downloads.
Platform support
Memory.Introspect runs on:
| OS | Status |
|---|---|
| Windows | Full support — .gcdump, full dumps, and sampling profiles. |
| Linux | Full support — uses the EventPipe Unix domain socket. |
| macOS | Full support — same EventPipe path as Linux. |
Capturing the current process needs no special privileges. Capturing another process requires permission to open its diagnostics pipe — on Linux/macOS that usually means running as the same user; on Windows, that means appropriate ACLs on the named pipe.
Verify the install
using Memory.Introspect;
var introspector = MemoryIntrospector.Create(new() { Verbose = false });
Console.WriteLine("Memory.Introspect loaded.");
If that compiles and prints, continue with the Quick Start.