## Install dotnet-counters
```
-dotnet tool install --global dotnet-counters --version 3.0.0-preview7.19365.2
+dotnet tool install --global dotnet-counters --version 3.0.0-preview8.19412.1
```
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-preview7.19365.2
+ $ dotnet tool install -g dotnet-dump --version 3.0.0-preview8.19412.1
You can invoke the tool using the following command: dotnet-dump
- Tool 'dotnet-dump' (version '3.0.0-preview7.19365.2') was successfully installed.
+ Tool 'dotnet-dump' (version '3.0.0-preview8.19412.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-preview7.19365.2') was successfully uninstalled.
+ Tool 'dotnet-dump' (version '3.0.0-preview8.19412.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-preview7.19365.2
+$ dotnet tool install --global dotnet-trace --version 3.0.0-preview8.19412.1
You can invoke the tool using the following command: dotnet-trace
-Tool 'dotnet-trace' (version '3.0.0-preview7.19365.2') was successfully installed.
+Tool 'dotnet-trace' (version '3.0.0-preview8.19412.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-preview7.19365.2
+ $ dotnet tool install -g dotnet-sos --version 3.0.0-preview8.19412.1
You can invoke the tool using the following command: dotnet-sos
- Tool 'dotnet-sos' (version '3.0.0-preview7.19365.2') was successfully installed.
+ Tool 'dotnet-sos' (version '3.0.0-preview8.19412.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-preview7.19365.2/dotnet-sos/3.0.0-preview7.19365.2/tools/netcoreapp2.1/any/linux-x64
+ 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
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-preview7.19365.2/dotnet-sos/3.0.0-preview7.19365.2/tools/netcoreapp2.1/any/linux-x64
+ 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 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-preview7.19365.2') was successfully uninstalled.
+ Tool 'dotnet-sos' (version '3.0.0-preview8.19412.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-preview7.19365.2
+ C:\Users\mikem>dotnet tool install -g dotnet-sos --version 3.0.0-preview8.19412.1
You can invoke the tool using the following command: dotnet-sos
- Tool 'dotnet-sos' (version '3.0.0-preview7.19365.2') was successfully installed.
+ Tool 'dotnet-sos' (version '3.0.0-preview8.19412.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-preview7.19365.2\dotnet-sos\3.0.0-preview7.19365.2\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-preview8.19412.1\dotnet-sos\3.0.0-preview8.19412.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-preview7.19365.2
+> dotnet tool install --global dotnet-counters --version 3.0.0-preview8.19412.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-preview7.19365.2
+> dotnet tool install --global dotnet-trace --version 3.0.0-preview8.19412.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-preview7.19365.2
+> dotnet tool install --global dotnet-dump --version 3.0.0-preview8.19412.1
> ```