Alert policy workflow

An alert policy can apply to one or more New Relic products. It can also contain one or more alert conditions and one or more notification channels. Account Admins and Owners can make an alert policy as simple or as complex as your organization requires.


With New Relic Alerts, maintenance functions are restricted by your assigned role in your New Relic account.

  • The account Owner and Admins can add, change, disable, and delete alert policies, conditions, and channels. They can also view incidents and events.
  • Users and Restricted Users can only view alert policies, conditions, channels, incidents, and events.
  • Any role can acknowledge an incident or close a violation.

This applies both to the New Relic Alerts user interface and to the New Relic REST API (v2).

Basic process

Each account can have a maximum of 5,000 alert policies. For additional data limits, see Minimum and maximum values for New Relic Alerts.

  1. Start by giving the new policy a meaningful name (maximum 64 characters); for example, the group or team's name, or the set of resources or services the alert policy is targeting.
  2. Create one or more conditions in the policy that target your resources monitored by New Relic products (maximum 250 conditions per policy).
  3. Define thresholds that trigger the alert incident.
  4. Make sure each alert condition has a concise and meaningful name, to be used in notification messages to quickly identify the condition.
  5. Optional: Include the runbook URL so that personnel responsible can follow standard procedures efficiently to manage the alert.
  6. Once the policy has been created, create one or more alert notification channels, and assign one or more channels to the policy.
  7. Specify how you want New Relic Alerts to roll up incident records when multiple targets violate one or more alert conditions. Be sure to complete this step, because alert notifications are tied to incident open, incident acknowledge, and incident close events.

  8. Repeat the steps to add more conditions or notification channels to an alert policy as needed.

Alert policies for sub-accounts

If your New Relic account has one or more sub-accounts, the alert policies you create apply only to the selected account. Any sub-accounts do not automatically inherit the master account's alert policies. You must create policies separately for sub-accounts.

For more help

Recommendations for learning more: