.NET Framework Agent Installation

The Atatus .NET agent monitors your .NET Framework 4.x applications on Windows. Install it using the Profiler or the NuGet package (Web.config).

Supported versions

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

Profiler

The profiler attaches at runtime through environment variables. See the Profiler overview for prerequisites and the full list of variables. For applications on IIS, see the IIS guide.

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:

   copy

   $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_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:

   copy

   Install-Package Atatus.AspNetFullFramework
   

2. Add your app name and license key to <appSettings> in Web.config:

   copy

   <appSettings>
       <add key="Atatus:AppName" value="YOUR_APP_NAME" />
       <add key="Atatus:LicenseKey" value="YOUR_LICENSE_KEY" />
   </appSettings>
   

3. Register AtatusModule in <system.webServer> of the same file:

   copy

   <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.

By default the agent starts on the first request. To start it at application start — for example, to subscribe to diagnostic listeners — call CreateAgentComponents() in Global.asax.cs:

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