Rules

Use sensible defaults or create custom rules around performance

How do you know when there is a performance issue in your app?

Most APM products on the market today rely heavily on the user to create performance parameters (i.e. send me a notification when Apdex score is below 0.70). When a transaction violates these parameters, a notification is created and the user is alerted to come back into the application to investigate.

Raygun APM works differently. Instead of asking you to specify these performance parameters, we've pre-made 8 performance rules, based on known poor performance indicators from the software industry. You can also add your own custom rules, using both basic and compound rules.

Where to find rules?

You can find “Rules” in the sidebar of your Raygun app, under “APM”.

Raygun APM default rules

Here is a list of the default rules that Raygun APM provides:

Slow trace
Creates an issue when a trace takes longer than 3000 milliseconds

Slow query
Creates an issue when a query takes longer than 2000 milliseconds

Slow method
Creates an issue when a method takes longer than 1000 milliseconds

Slow external api
Creates an issue when an external api call takes longer than 2000 milliseconds

Low apdex score
Creates an issue when the apdex score drops below 0.5

Overused api
Creates an issue when an external api is used 5 or more times in a single transaction

N+1 query
Creates an issue when a query occurs 5 or more times in a single transaction

Really chatty api
Creates an issue when an external api endpoint is called 10 or more times in a single transaction

You can edit any of the default rules by clicking on the “Edit” link associated with each rule. Default rules cannot be deleted, but you can hide the list by using the toggle on the top right of this section.

Create custom rules

You can also create your own custom rules, using our custom rule creator.

Simply click on “Create custom rule” button

And specify your conditions: 

You can choose one or multiple conditions. If you are using multiple conditions, an issue will only be created if all of the rule conditions that you've specified are met.

Once you have your conditions finalised, give it a rule name and click on “Create rule”:

You've now created a new custom rule. You can delete, edit, mute or snooze your custom rules at any time.

Mute, snooze and delete rules

Unlike custom rules, default Raygun APM rules cannot be deleted, but you can mute or snooze them. These are handy when it comes to scheduled maintenance or outages. To mute or snooze a rule, simply use the checkbox to select a rule and these two options will appear at the top of the default rules area.

Mute
If you mute one or more rules, these rules will no longer generate any issues for you on the “Issues” page of Raygun APM. Muted rules will stay muted indefinitely and you will need to manually unmute these rules to reactivate them again.



Snooze
Snooze allows you to disable one or more rules for a temporary period of time. You can snooze rules for up to 24 hours. After the selected time has passed, a rule will be reactivated after a snooze.

Delete
You can only delete custom rules. Raygun default rules can only be muted or snoozed, they cannot be deleted.

Documentation missing?

If we don't have documentation about your desired topic, send us a message and we'll create it for you.