Installation¶

This document details how to download and install the .NET agent. Before installing the agent, review the agent requirements below.

Requirements¶

The NerdVision .NET agent requires:

.NET Core 3.0+
.NET Framework 4.6.1+

nuget usage¶

The recommended way to install this agent is to use the nuget package manager.

.NET CLI

dotnet add package NerdVision

Package Manager

Install-Package NerdVision

PackageReference

<PackageReference Include="NerdVision" Version="VERSION" />

Copy the above into the project file to reference the package, updating the VERSION to use.

Configuration¶

Once the agent has been installed, we need to be called to activate the agent. This call should be as early in the application as possible.

    using NerdVision;

    NV.Start("YOUR API KEY")

You can find your apikey on your NerdVision account

We also require that the following settings have been configured in the project settings:

Debugging information - should be set to 'Portable'
Optimize code - should be disabled (optional) - see Optimize code

Visual Studio Config

Project Configuration

Rider Config

Rider Project Configuration

Optimize Code¶

When using NerdVision it is not required to disable the 'Optimize Code' setting.

The NerdVision agent will work and trigger tracepoints successfully with this option enabled. It should be noted however that with this option enabled it is possible that line numbers will not match, and some tracepoints will not fire due to inlined code or optimizations made by the compiler. For the best results from NerdVision it is recommended this setting is disabled.