Preview 9 Release

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

dotnet tool install -g dotnet-XXXX --version 3.0.0-preview9.19454.1

where XXXX is counters, dump, sos or trace.

Release Notes

SOS

• Added the setsymbolserver -directory <symbol-search-directory> option so the modules and symbols files for a core dump don't have to be the same layout as they were when the dump was generated.

• WARNING: SOS has been removed from the .NET Core runtime (coreclr repo) in Preview 7. Use "dotnet-sos" to install SOS. See installing sos for more information.

dotnet-dump

• Not supported on MacOS.

dotnet-trace

• The NetPerf format is obsolete and has now been replaced with NetTrace format which serves the identical role. The format is supported in Visual Studio starting with 16.3 Preview 1, TraceEvent version 2.0.43 and PerfView version 2.0.44. The most visible change is that trace files should be smaller than before. It is also faster to write, supports some new metadata on events, and makes some parsing scenarios more efficient. For more details see the file format spec.

Preview 8 Release

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

dotnet tool install -g dotnet-XXXX --version 3.0.0-preview8.19412.1

where XXXX is counters, dump, sos or trace.

Release Notes

SOS

• WARNING: SOS has been removed from the .NET Core runtime (coreclr repo) in Preview 7. Use "dotnet-sos" to install SOS. See installing sos for more information.

dotnet-dump

• ARM32 or ARM64 core dumps are now supported except for issue #15062.
• Not supported on MacOS.

dotnet-trace

• The NetPerf format is obsolete and has now been replaced with NetTrace format which serves the identical role. The format is supported in Visual Studio starting with 16.3 Preview 1, TraceEvent version 2.0.43 and PerfView version 2.0.44. The most visible change is that trace files should be smaller than before. It is also faster to write, supports some new metadata on events, and makes some parsing scenarios more efficient. For more details see the file format spec.

Preview 7 Release

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

Release Notes

SOS

• WARNING: SOS has been removed from the .NET Core runtime (coreclr repo) in Preview 7. Use "dotnet-sos" to install SOS. See installing sos for more information.

dotnet-dump

• 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).
• Fixed when running dotnet-dump on Preview 7 of the runtime: 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).
• Dump analysis on Windows is now supported (issue #157).
• Fixed: Dump collection on Windows doesn't save all the required managed state (related to issue #25083).
• Fixed: Dump collection on CentOS/OpenSuse VMs fails with Core dump generation FAILED 0x80004005 (issue #334).

dotnet-trace

• The NetPerf format is obsolete and has now been replaced with NetTrace format which serves the identical role. The format is supported in Visual Studio starting with 16.3 Preview 1, TraceEvent version 2.0.43 and PerfView version 2.0.44. The most visible change is that trace files should be smaller than before. It is also faster to write, supports some new metadata on events, and makes some parsing scenarios more efficient. For more details see the file format spec.

dotnet-counters

• Active timers count has been added to the list of runtime counters
• Added ctrl-c handler: use Ctrl-C to stop monitoring
• dotnet-counters no longer asks for or gets rundown events from the runtime, so it is more lightweight.
• UI side bug fixes and improvements

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!