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.
dotnet add package NerdVision
Install-Package NerdVision
<PackageReference Include="NerdVision" Version="VERSION" />
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")
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
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.