.NET Framework Agent Installation

​

Supported versions

• .NET Framework 4.x: Profiler or NuGet package

​

Profiler

1. Download the Windows profiler ZIP in your browser.
2. Right-click the downloaded .zip → Extract All… and choose a folder such as C:\atatus.
3. Set these environment variables in PowerShell before starting the application:
   $env:COR_ENABLE_PROFILING="1"
   $env:COR_PROFILER="{A6C28362-6F75-472A-B36C-50C1644DA40A}"
   $env:COR_PROFILER_PATH="C:\atatus\atatus_profiler.dll"
   $env:ATATUS_PROFILER_HOME="C:\atatus"
   $env:ATATUS_PROFILER_INTEGRATIONS="C:\atatus\integrations.yml"
   $env:ATATUS_LICENSE_KEY="YOUR_LICENSE_KEY"
   $env:ATATUS_APP_NAME="YOUR_APP_NAME"
   $env:ATATUS_SERVER_URL="YOUR_ON_PREMISE_URL"
   $env:ATATUS_ANALYTICS="true"
   $env:ATATUS_TRACING="true"
   $env:ATATUS_CAPTURE_BODY="all"
   
4. Restart the application.

​

NuGet package

1. Install the package in the Visual Studio Package Manager Console:
   Install-Package Atatus.AspNetFullFramework
   
2. Add your app name and license key to <appSettings> in Web.config:
   <appSettings>
       <add key="Atatus:AppName" value="YOUR_APP_NAME" />
       <add key="Atatus:LicenseKey" value="YOUR_LICENSE_KEY" />
       <add key="Atatus:NotifyUrls" value="YOUR_ON_PREMISE_URL" />
   </appSettings>
   
3. Register AtatusModule in <system.webServer> of the same file:
   <system.webServer>
       <modules>
           <add name="AtatusModule" type="Atatus.AspNetFullFramework.AtatusModule, Atatus.AspNetFullFramework" />
       </modules>
   </system.webServer>
   
4. Publish in Release mode, copy the output and your edited Web.config to the IIS site folder, and recycle the application pool.

protected void Application_Start()
{
    var agentComponents = AtatusModule.CreateAgentComponents();
    Agent.Setup(agentComponents);
    Agent.Subscribe(new SqlClientDiagnosticSubscriber());
}

​

Next steps

• Customizing the agent: analytics, tracing, and request body capture
• Per-integration setup: SQL Client, MongoDB, Redis, Azure Service Bus
• Troubleshooting