Preview 6 Release

This is the preview 6 release of the dotnet-counters, dotnet-dump, dotnet-sos and dotnet-trace global CLI tools.

Release Notes

SOS

• Fixed missing metadata in core dump issue that caused UNKNOWN functions and type names.
• Windows arm and Linux arm/arm64 builds now available.
• Improved "dumpasync" and "threadpool -wi" command performance.
• WARNING: SOS will be removed from the .NET Core runtime (coreclr repo) in Preview 7.

dotnet-dump

• Works on Alpine and other MUSL based distros.
• Dump collection now works without superuser/root (sudo) elevation.
• Not supported ARM32 or ARM64. Issue #168.
• Not supported on MacOS.
• Dump collection (dotnet dump collect) requires SYS_PTRACE docker capabilities (--cap-add=SYS_PTRACE or --privileged).
• Dump analysis (dotnet dump analyze) on Microsoft .NET Core SDK Linux docker images can throw Unhandled exception: System.DllNotFoundException: Unable to load shared library 'libdl.so' or one of its dependencies exception. Issue #201. To work around this problem install the "libc6-dev" (debian based distros) or "glibc-devel" (opensuse, etc.) package.
• Dump analysis on Windows is not supported. Minidump collection is support. Issue #157.
• Dump collection on Windows doesn't save all the required managed state. Related to issue #25083.
• Dump collection on CentOS/OpenSuse VMs fails with Core dump generation FAILED 0x80004005. Issue #334.

dotnet-counters

• Added new runtime counters:
  • % Time in GC
  • Gen 0 Heap Size
  • Gen 1 Heap Size
  • Gen 2 Heap Size
  • LOH Heap Size
  • Allocation Rate
  • Number of assemblies loaded
  • Number of ThreadPool Threads
  • Monitor Lock Contention Rate
  • ThreadPool Work Items Queue
  • ThreadPool Completed Work Items Rate
• Added visual cues for showing the current monitoring status (initializing, running, paused)
• Added list-processes command to display attachable .NET processes
• Made --refresh-interval argument optional (defaults to 1)
• Fixed an issue where counters from user-defined EventSource didn't get displayed with proper provider name
• Fixed an issue where previously updated values were not properly cleared from the console window
• Multiple sessions of instances of dotnet-counters can be attached now

Preview 5

Preview 5 Release

This is the preview 5 release of the dotnet-counters, dotnet-dump, dotnet-sos and dotnet-trace global CLI tools.

Release Notes

dotnet-dump

• Does not work on alpine and other MUSL based distros. Issue #195.
• Not supported ARM32 or ARM64. Issue #168.
• Not supported on MacOS.
• Dump collection (dotnet dump collect) requires SYS_PTRACE docker capabilities (--cap-add=SYS_PTRACE or --privileged).
• Dump analysis (dotnet dump analyze) in on Microsoft SDK Linux docker images throws Unhandled exception: System.DllNotFoundException: Unable to load shared library 'libdl.so' or one of its dependencies exception. Issue #201. A work around is to install the "libc6-dev" package.
• Dump analysis on Windows is not supported. Minidump collection is support. Issue #157.

dotnet-sos

• Does not work on alpine and other MUSL based distros. Issue #195.
• Not supported ARM32 or ARM64. Issue #168.

dotnet-counters

• Addressed an issue where list command doesn't show the name of providers. (#220)
• Addressed an issue where counters from user-defined EventSource couldn't be enabled (#222)

Preview 5

Preview 5 Release

This is the preview 5 release of the dotnet-counters, dotnet-dump, dotnet-sos and dotnet-trace global CLI tools.

Release Notes

dotnet-dump

• Does not work on alpine and other MUSL based distros. Issue #195.
• Not supported ARM32 or ARM64. Issue #168.
• Not supported on MacOS.
• Dump collection (dotnet dump collect) requires SYS_PTRACE docker capabilities (--cap-add=SYS_PTRACE or --privileged).
• Dump analysis (dotnet dump analyze) in on Microsoft SDK Linux docker images throws Unhandled exception: System.DllNotFoundException: Unable to load shared library 'libdl.so' or one of its dependencies exception. Issue #201. A work around is to install the "libc6-dev" package.
• Dump analysis on Windows is not supported. Minidump collection is support. Issue #157.

dotnet-sos

• Does not work on alpine and other MUSL based distros. Issue #195.
• Not supported ARM32 or ARM64. Issue #168.

dotnet-counters

• First version of dotnet-counters. Please see https://github.com/dotnet/diagnostics/tree/master/src/Tools/dotnet-counters for detailed documentation on how to use this tool!