## Install dotnet-counters
```
-dotnet tool install --global dotnet-counters --version 3.0.0-preview8.19412.1
+dotnet tool install --global dotnet-counters --version 3.0.0-preview9.19454.1
```
Dump collection and analysis utility (dotnet-dump)
==================================================
-The dotnet-dump CLI global tool is way to collect and analyze Windows and Linux dumps all without any native debugger involved like lldb on Linux. This is important on platforms like Alpine Linux where a fully working lldb isn't available. The dotnet-dump tool will allow you to run SOS commands to analyze crashes and the GC, but it isn't a native debugger so things like displaying the native stack frames isn't supported.
+The dotnet-dump CLI global tool is way to collect and analyze Windows and Linux dumps all without any native debugger involved like lldb on Linux. This is important on platforms like Alpine Linux or Linux ARM32/ARM64 where a fully working lldb isn't available. The dotnet-dump tool will allow you to run SOS commands to analyze crashes and the GC, but it isn't a native debugger so things like displaying the native stack frames isn't supported.
Currently not supported on macOS.
The first step is to install the dotnet-dump CLI global tool. This requires at least the 2.1 or greater .NET Core SDK to be installed. If you see the error message `Tool 'dotnet-dump' is already installed`, you will need to uninstall the global tool (see below).
- $ dotnet tool install -g dotnet-dump --version 3.0.0-preview8.19412.1
+ $ dotnet tool install -g dotnet-dump --version 3.0.0-preview9.19454.1
You can invoke the tool using the following command: dotnet-dump
- Tool 'dotnet-dump' (version '3.0.0-preview8.19412.1') was successfully installed.
+ Tool 'dotnet-dump' (version '3.0.0-preview9.19454.1') was successfully installed.
If this is the first global tool installed or you get message `Could not execute because the specified command or file was not found.` you need to add `$HOME/.dotnet/tools` to your path.
## Uninstalling dotnet-dump
$ dotnet tool uninstall -g dotnet-dump
- Tool 'dotnet-dump' (version '3.0.0-preview8.19412.1') was successfully uninstalled.
+ Tool 'dotnet-dump' (version '3.0.0-preview9.19454.1') was successfully uninstalled.
The first step is to install the dotnet-trace CLI global tool.
```cmd
-$ dotnet tool install --global dotnet-trace --version 3.0.0-preview8.19412.1
+$ dotnet tool install --global dotnet-trace --version 3.0.0-preview9.19454.1
You can invoke the tool using the following command: dotnet-trace
-Tool 'dotnet-trace' (version '3.0.0-preview8.19412.1') was successfully installed.
+Tool 'dotnet-trace' (version '3.0.0-preview9.19454.1') was successfully installed.
```
## Using dotnet-trace
The first step is to install the dotnet-sos CLI global tool. This requires at least the 2.1 or greater .NET Core SDK to be installed. If you see the error message `Tool 'dotnet-sos' is already installed`, you will need to uninstall the global tool (see below).
- $ dotnet tool install -g dotnet-sos --version 3.0.0-preview8.19412.1
+ $ dotnet tool install -g dotnet-sos --version 3.0.0-preview9.19454.1
You can invoke the tool using the following command: dotnet-sos
- Tool 'dotnet-sos' (version '3.0.0-preview8.19412.1') was successfully installed.
+ Tool 'dotnet-sos' (version '3.0.0-preview9.19454.1') was successfully installed.
The next step is use this global tool to install SOS.
$ dotnet-sos install
- Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/3.0.0-preview8.19412.1/dotnet-sos/3.0.0-preview8.19412.1/tools/netcoreapp2.1/any/linux-x64
+ Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/3.0.0-preview9.19454.1/dotnet-sos/3.0.0-preview9.19454.1/tools/netcoreapp2.1/any/linux-x64
Creating installation directory...
Copying files...
Updating existing /home/mikem/.lldbinit file - LLDB will load SOS automatically at startup
The installer needs to be run again:
$ dotnet-sos install
- Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/3.0.0-preview8.19412.1/dotnet-sos/3.0.0-preview8.19412.1/tools/netcoreapp2.1/any/linux-x64
+ Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/3.0.0-preview9.19454.1/dotnet-sos/3.0.0-preview9.19454.1/tools/netcoreapp2.1/any/linux-x64
Installing over existing installation...
Creating installation directory...
Copying files...
To remove the SOS installer global tool:
$ dotnet tool uninstall -g dotnet-sos
- Tool 'dotnet-sos' (version '3.0.0-preview8.19412.1') was successfully uninstalled.
+ Tool 'dotnet-sos' (version '3.0.0-preview9.19454.1') was successfully uninstalled.
It is recommended that you update to the newer versions of the Windows debugger, but you can still use the latest SOS with older Windows debuggers by using the dotnet-sos CLI global tool to install. It is not as convenient. You may have to ".unload" the SOS that is loaded from the "runtime" directory.
- C:\Users\mikem>dotnet tool install -g dotnet-sos --version 3.0.0-preview8.19412.1
+ C:\Users\mikem>dotnet tool install -g dotnet-sos --version 3.0.0-preview9.19454.1
You can invoke the tool using the following command: dotnet-sos
- Tool 'dotnet-sos' (version '3.0.0-preview8.19412.1') was successfully installed.
+ Tool 'dotnet-sos' (version '3.0.0-preview9.19454.1') was successfully installed.
Run the installer:
C:\Users\mikem>dotnet-sos install
- Installing SOS to C:\Users\mikem\.dotnet\sos from C:\Users\mikem\.dotnet\tools\.store\dotnet-sos\3.0.0-preview8.19412.1\dotnet-sos\3.0.0-preview8.19412.1\tools\netcoreapp2.1\any\win-x64
+ Installing SOS to C:\Users\mikem\.dotnet\sos from C:\Users\mikem\.dotnet\tools\.store\dotnet-sos\3.0.0-preview9.19454.1\dotnet-sos\3.0.0-preview9.19454.1\tools\netcoreapp2.1\any\win-x64
Creating installation directory...
Copying files...
Execute '.load C:\Users\mikem\.dotnet\sos\sos.dll' to load SOS in your Windows debugger.
In the .NET full/Windows world, we have a myriad of performance counters that can be used to triage and diagnose production issues. For .Net core we have a similar and cross platform story centered around a tool called dotnet-counters. To install the tool, run the following command:
> ```bash
-> dotnet tool install --global dotnet-counters --version 3.0.0-preview8.19412.1
+> dotnet tool install --global dotnet-counters --version 3.0.0-preview9.19454.1
> ```
.NET core includes what is called the 'EventPipe' through which diagnostics data is exposed. The dotnet-trace tool allows you to consume interesting profiling data from your app that can help in scenarios where you need to root cause apps running slow. To install the tool, run the following command:
> ```bash
-> dotnet tool install --global dotnet-trace --version 3.0.0-preview8.19412.1
+> dotnet tool install --global dotnet-trace --version 3.0.0-preview9.19454.1
> ```
In order to generate core dumps for .net core apps, you can use the dotnet-dump tool. To install the tool, run the following command:
> ```bash
-> dotnet tool install --global dotnet-dump --version 3.0.0-preview8.19412.1
+> dotnet tool install --global dotnet-dump --version 3.0.0-preview9.19454.1
> ```