3.1.57502 Release

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

dotnet tool install -g dotnet-XXXX

where XXXX is counters, dump, gcdump, sos or trace.

Release Notes

New "dotnet-gcdump" tool added. See design-docs for more information.

Added a new command collect to dotnet-counters. This command is meant to be used for users who want to export the counter data to a well-known format that can be post-processed, rather than real-time monitoring of the counter data. You can specify --format and --output to specify the format of the exported data and its file name. By default, they are .csv and and counter.csv. Implemented are CSV and JSON formats, but more can be added as if needed.

Issues fixed:

#452 - Add the !u -il SOS command
#434 - Make dotnet-counters aware of DisplayUnits.
#584 - Fix bpmd on Windows.
#15 - Allow bpmd to work before coreclr is loaded.
#563 - Fix incorrect value displayed for rate counters.
#503 - Fix dumpheap failures on certain dumps.

3.0.52901 Release

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

dotnet tool install -g dotnet-XXXX

where XXXX is counters, dump, sos or trace.

Release Notes

• PR: #554

  • Display internal SOS status with sosstatus command
  • Add dumpvc to dotnet-dump/lldb commands.
  • Remove reductant dotnet-dump error message when SOS command fails.
  • Fallback to portable PDB support if getting the module's metadata importer fails.
  • Issue: #511
  • Issue: #508
  • Issue: #509

• PR: #543

  • Refactor out ps command handler and add it to dotnet-dump

• PR: #549

  • Add /ContinueOnError option to speedscope converter
  • Display a warning message when we have to continue on error
  • Only retry if the exception thrown is from a broken trace

3.0.47001 Release

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

dotnet tool install -g dotnet-XXXX

where XXXX is counters, dump, sos or trace.

Release Notes

SOS

• New 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.

• eeversion command enabled for all platforms. Displays the version and commit id of the target runtime.

• 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

• Added a couple more --profile options for doing GC-related performance investigations.

• UI improvements to clarify provider configurations and settings.

• Added --duration option.

• 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

• Fixed an issue where the application being monitored exiting before dotnet-counters crashes dotnet-counters with an unhandled exception.

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!