Getting Started

Raygun APM provides server-side application performance monitoring that brings a whole new dimension to how you build and maintain software. 

Raygun’s application performance monitoring (APM) delivers both trend and real time server performance and user experience data about your application. Together with Crash Reporting and Real User Monitoring, the Raygun platform monitors your entire technology stack and alerts you when errors and performance issues occur, so you don’t need to.

Raygun APM visualizes your performance data into charts and reports that your team can easily understand.

Our unique automatic issue creation engine curates a list of your most urgent performance issues for you, sorted by priority.

This means your tech teams no longer need to guess at the priority of an issue or where a performance blocker is coming from. With Raygun APM, we proactively identify and alert you to the performance problems, before they impact your end users.

Raygun APM currently supports Ruby, .NET, .NET for Azure App Service, and .NET Core. Other language support will be made available in the near future. You can register your interest in other platforms and languages to be notified when they launch.

APM Deploy Best Practices

Performance profiling can increase usage of CPU and memory. Therefore we recommend the following procedure:

  • Deploy APM on a DEV environment.
  • Profile the DEV environment.
  • Look at the traces for the code you are not interested it, for example, third party library calls.
  • Exclude that code.
  • Deploy the APM on staging environment and run a load test against it. Verify the resource usage of the APM is acceptable.
  • Deploy the APM on a single production box. Monitor the performance.
  • Verify the performance of the box with APM over peak usage time.

Once the above steps are completed, you will need to decide on your roll out strategy - if you want to have APM running on all production servers, or a subset of them. In a typical HA scenario where you’ve got a few production servers behind the load balancer getting similar load, it is acceptable to run APM on just one of the boxes to reduce performance impact on the whole system.

Ready to get started?

Setup instructions will be different depending on which type of customer you are. Select the best option for you: 

New to Raygun

You are new to Raygun if you haven’t taken a trial of any of Raygun’s products before. You will need to start a 14-day trial and implement the following steps. 

  1. Choose an existing app, or create a new app within Raygun to add APM to
  2. Setup and configure your Raygun Agent by following the onscreen instructions
  3. Generate some traffic for your app
  4. Wait a few minutes for Raygun to start receiving your data
  5. Log in to your Raygun account, go to the app you’ve chosen and click on “APM” to start using Raygun APM
  6. If data does not appear after waiting a few minutes, please check your setup and try again or contact Raygun by using the “Contact Raygun” link in the sidebar of your app

System requirements:

.NET and .NET Core

  • .NET 4.5 or .NET Core installed (Windows Server 2008 or above)
  • 1 GHz or faster processor
  • 512 MB of RAM
  • 2 GB available hard disk space (x64)
  • 64-Bit Windows

Supported Ruby versions

  • 2.5.x
  • 2.6.x
  • 2.7.x

Already a Platform plan customer

Standard Platform plan customers have Raygun Crash Reporting and Real User Monitoring. Raygun APM traces are included in these plans.

Custom Platform plans do not include APM. If you’d like to have APM included in your custom plan, you will need to contact us. 

Raygun APM is currently only available for Ruby, .NET, .NET for Azure App Service, and .NET Core.

Already a Single Product only customer

You are a Single Product customer if you have either Raygun Crash Reporting or Real User Monitoring. To get started with Raygun APM, click on “APM” in the sidebar of your Raygun app and then click on the ’Start trial’ button to start your 14 day trial. If you’d like to continue using Raygun APM after your trial, you will need to add a paid Raygun APM plan to your existing subscription.

Alternatively, to get the best value from Raygun, try a Platform Plan. You’ll get Crash Reporting and Real User Monitoring events plus APM traces for a great price. Visit the pricing page for details on pricing. 

Raygun APM is currently only available for Ruby, .NET, .NET for Azure App Service, and .NET Core.

Already a Custom plan customer

A Custom plan is any plan outside of our standard pricing system. This includes both Custom Platform plans as well as Custom Single Product plans.  If you’d like to have APM included in your plan, you will need to contact us. 

Raygun APM is currently only available for Ruby, .NET, .NET for Azure App Service, and .NET Core.

How to use Raygun APM

Further reading