.NET on Windows

System Requirements

Raygun APM supports ASP.NET, ASP.NET Web Forms, ASP.NET WebAPI, ASP.NET Core

  • Windows Server 2016 or newer
  • 2 GHz or faster multi-core processor
  • 1 GB of RAM
  • 2 GB available hard disk space
  • 64-Bit Windows


Before setting up your application for profiling, please:

  1. Read about APM Deploy Best Practices
  2. Install the Raygun Agent on the server you would like to monitor
  3. Register the Agent (part of the install process of the Raygun Agent)

The Raygun Configuration Utility is a tool to register and deregister applications and application pools for profiling. It also allows you to register and deregister the agent.

The configuration utility can be found in the start menu under Raygun Profiler.

Select the application pool using the dropdown and Register.

Change the API key if you would like the data to be associated with a different application, then recycle the application pool to start profiling.

In your server side Visual Studio project(s) for this application, we recommended you update the Raygun4Net NuGet package to the latest release in order to correlate data between Crash Reporting and APM.

You can do this by right clicking on the project, or by using the NuGet package manager console. Update the Raygun4Net package you have installed to the latest version.


If an application is no longer being served from a particular application pool or you no longer want a particular application to be monitored, you can deregister that application's application pool in the configuration utility.

  1. Go to the IIS tab of the Raygun Configuration Utility.
  2. Select the registered application pool that you would like to de-register
  3. Click the Deregister button
  4. Click Yes on the dialog to recycle the application pool

If you want to disable monitoring of all the applications on a server, you can deregister the agent using the configuration utility.

  1. Go to the Agent tab in the Raygun Configuration Utility
  2. Click the Deregister button
  3. Once the agent has successfully deregistered, the status in the bottom left will have updated:

For more information on how to get the most out of Raygun APM, check out our getting started guide or view our docs on the APM overview page.


Having trouble receiving traces? Please look at our troubleshooting guides.