Applies To
- .NET Framework 4.6.2 and above
- .NET Core 3.1 and above (NuGet package)
- .NET 5.0 and above (Profiler or NuGet package)
- Applications hosted on IIS, self-hosted, or console applications
1. Identify Your Application Type
Determine whether you’re running a .NET Framework or .NET Core/.NET application:2. Verify Agent Installation
Confirm how the Atatus agent is installed in your application.Option 1: Profiler (auto-instrumentation)
The profiler is not installed to a fixed location, so you download the profiler ZIP and extract it to a directory of your choice (for example,C:\atatus on Windows or ~/atatus on Linux). The agent finds it through the environment variables you set (ATATUS_PROFILER_HOME and CORECLR_PROFILER_PATH, or COR_PROFILER_PATH for .NET Framework).
Confirm the extracted directory contains:
atatus_profiler.dll(Windows) orlibatatus_profiler.so(Linux)integrations.yml- the bundled managed assemblies
Option 2: NuGet Package
If your application uses the Atatus NuGet package, verify the correct package is referenced for your runtime:- .NET Core / ASP.NET Core:
Atatus.NetCoreAll - .NET Framework (ASP.NET):
Atatus.AspNetFullFramework
3. Enable Debug Logging
Enable debug logging to collect detailed information for troubleshooting.Option 1: Configure via appsettings.json
Add or update the Atatus section inappsettings.json:
Option 2: Configure via Environment Variables
Set the following environment variables before starting the application:4. Verify License Key and Account
Check your license key validity:- Go to Atatus Dashboard
- Navigate to Settings → Account Settings → License Keys
- Ensure the license is assigned to your .NET application monitoring
.NET Profiler Issues
These issues are specific to the profiler installation. By default the profiler writes its log files to:- Windows:
%PROGRAMDATA%\atatus-dotnet-agent\logs\ - Linux:
/var/log/atatus-dotnet-agent/
logs folder inside ATATUS_PROFILER_HOME. Log files are named atatus_profiler_<app>_<pid>_<timestamp>.log.
To write logs to a different folder, set ATATUS_LOG_DIRECTORY (the profiler and agent also honor ATATUS_PROFILER_LOG_DIR and OTEL_DOTNET_AUTO_LOG_DIRECTORY).
Check the Windows Event Viewer
When the profiler fails to load on Windows, the .NET runtime records the failure in the Event Viewer. Open Event Viewer → Windows Logs → Application and look for errors from the.NET Runtime source (for example, “Failed to CoCreate the profiler”). Match the HRESULT in the message:
For IIS-hosted applications, see IIS hosted applications data not visible for worker-process (
w3wp.exe) and application-pool specifics.
Still Having Issues?
If data is still not visible, send the following to success@atatus.com- Atatus agent logs
- Application framework version
- Hosting type (IIS / Console / Service)
- Include a detailed description of the issue and steps already tried