.NET Framework

System Requirements

Raygun APM offers support for ASP.NET Framework, ASP.NET MVC ASP.NET Web Forms, ASP.NET WebAPI

  • 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


Installing the agent

Download the Raygun Agent on the server you would like to monitor.


Open the Agent installer you downloaded and follow the on-screen prompts to install the Agent.


Launch the Raygun Profiler Configuration tool. Under the Agent tab of the configuration tool, set the Default API key to your app's API key and then click Register Agent.

  • Default API key | paste_your_api_key_here

profiler configuration default API key

Note: Your app API key is displayed when you create a new application in your Raygun account, or can be viewed in the application settings.


Select the application pool using the dropdown and click Register. Use your API key above.

You may change the API key if you would like the data to be associated with a different application.

Recycle the application pool to start profiling.


We recommended you update the Raygun4Net NuGet package used in your .NET Framework application to the latest release in order to correlate data between Crash Reporting and APM.

You can do this by running the following command from within the directory of your project file or from the NuGet management GUI in the IDE you use.

dotnet add package Mindscape.Raygun4Net

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