IIS Agent Installation

The Atatus .NET agent monitors .NET Framework and .NET Core applications hosted on IIS. Install it using the Profiler (per-application-pool environment variables) or the NuGet package.

Profiler

The profiler attaches at runtime through environment variables set on each application pool. See the Profiler overview for prerequisites and the full list of variables. Before you start: IIS 10 or later is recommended because it scopes environment variables per application pool (on IIS 7 to 8.5, set them globally). Run the application pool in Integrated pipeline mode, and make sure its identity has read and execute access to the profiler directory.

1. Download the profiler

Download the Windows profiler ZIP in your browser.

2. Extract the profiler

Extract All… and choose a directory the application pool identity can read, such as C:\atatus. Use this path in the steps below.

3. Set environment variables per application pool

Run the script for your runtime, replacing the pool names, Atatus app names, and <extracted directory>.

.NET Framework

$appcmd = "$($env:systemroot)\system32\inetsrv\AppCmd.exe"
# Define your application pools and their corresponding Atatus app names
$appPools = @{
    "<IISAppPoolName1>" = "<AtatusAppName1>"
    "<IISAppPoolName2>" = "<AtatusAppName2>"
}
# Base environment variables (common to all pools)
$environment = @{
    COR_ENABLE_PROFILING         = "1"
    COR_PROFILER                 = "{A6C28362-6F75-472A-B36C-50C1644DA40A}"
    COR_PROFILER_PATH            = "<extracted directory>\atatus_profiler.dll"
    ATATUS_PROFILER_HOME         = "<extracted directory>"
    ATATUS_PROFILER_INTEGRATIONS = "<extracted directory>\integrations.yml"
    COMPlus_LoaderOptimization   = "1"
    ATATUS_LICENSE_KEY           = "YOUR_LICENSE_KEY"
    ATATUS_SERVER_URL            = "YOUR_ON_PREMISE_URL"
    ATATUS_ANALYTICS             = "true"
    ATATUS_TRACING               = "true"
    ATATUS_CAPTURE_BODY          = "all"
}
# Apply environment variables per app pool
$appPools.GetEnumerator() | ForEach-Object {
    $appPool = $_.Key
    $atatusAppName = $_.Value
    $envVars = $environment.Clone()
    $envVars["ATATUS_APP_NAME"] = $atatusAppName
    $envVars.Keys | ForEach-Object {
        & $appcmd set config -section:system.applicationHost/applicationPools /+"[name='$appPool'].environmentVariables.[name='$_',value='$($envVars[$_])']"
    }
}
# Recycle only the configured app pools to apply changes
$appPools.Keys | ForEach-Object {
    & $appcmd recycle apppool /apppool.name:"$_"
}

.NET Core

$appcmd = "$($env:systemroot)\system32\inetsrv\AppCmd.exe"
# Define your application pools and their corresponding Atatus app names
$appPools = @{
    "<IISAppPoolName1>" = "<AtatusAppName1>"
    "<IISAppPoolName2>" = "<AtatusAppName2>"
}
# Base environment variables (common to all pools)
$environment = @{
    CORECLR_ENABLE_PROFILING     = "1"
    CORECLR_PROFILER             = "{A6C28362-6F75-472A-B36C-50C1644DA40A}"
    CORECLR_PROFILER_PATH        = "<extracted directory>\atatus_profiler.dll"
    ATATUS_PROFILER_HOME         = "<extracted directory>"
    ATATUS_PROFILER_INTEGRATIONS = "<extracted directory>\integrations.yml"
    COMPlus_LoaderOptimization   = "1"
    ATATUS_LICENSE_KEY           = "YOUR_LICENSE_KEY"
    ATATUS_SERVER_URL            = "YOUR_ON_PREMISE_URL"
    ATATUS_ANALYTICS             = "true"
    ATATUS_TRACING               = "true"
    ATATUS_CAPTURE_BODY          = "all"
}
# Apply environment variables per app pool
$appPools.GetEnumerator() | ForEach-Object {
    $appPool = $_.Key
    $atatusAppName = $_.Value
    $envVars = $environment.Clone()
    $envVars["ATATUS_APP_NAME"] = $atatusAppName
    $envVars.Keys | ForEach-Object {
        & $appcmd set config -section:system.applicationHost/applicationPools /+"[name='$appPool'].environmentVariables.[name='$_',value='$($envVars[$_])']"
    }
}
# Recycle only the configured app pools to apply changes
$appPools.Keys | ForEach-Object {
    & $appcmd recycle apppool /apppool.name:"$_"
}

4. Recycle pools later (optional)

To apply the changes during a later maintenance window instead of recycling immediately, run this script when ready:

$appcmd = "$($env:systemroot)\system32\inetsrv\AppCmd.exe"

$appPools = @{
    "<IISAppPoolName1>" = "<AtatusAppName1>"
    "<IISAppPoolName2>" = "<AtatusAppName2>"
}

# Recycle only the configured app pools to apply changes
$appPools.Keys | ForEach-Object {
    & $appcmd recycle apppool /apppool.name:"$_"
}

NuGet package

For a NuGet-based installation on IIS, follow the guide for your runtime:

ASP.NET Core / .NET 5+: .NET Core → NuGet package
ASP.NET Full Framework: .NET Framework → NuGet package

Next steps

Customizing the agent: analytics, tracing, and request body capture
Troubleshooting

​Profiler

​1. Download the profiler

​2. Extract the profiler

​3. Set environment variables per application pool

​.NET Framework

​.NET Core

​4. Recycle pools later (optional)

​NuGet package

​Next steps