Create, edit, or find an alert policy

In New Relic Alerts, an alert policy is a group of one or more alert conditions. This document explains how to create a policy through the Alerts UI and how to view existing policies. You can also use the REST API.

For an explanation of how policies interact with conditions and other Alerts components, see Concepts and workflow.

Admins, Owner, or add-on managers: The basic setup process is the same, regardless of which New Relic product (APM, Browser, etc.) uses the alert policy. The types of metrics and thresholds for alert conditions vary depending on the monitored data source.

Best practices for naming alert policies

New Relic recommends three common patterns and practices for structuring and naming alert policies:

  • Targets or resources in your architecture that have people responsible for their well being
  • Teams that are responsible for part of the architecture
  • Individual policies for specific users
Policies organized by... Comments

Targets or resources in your organization may have different people responsible for their well-being. Common segments may include the environment type (production, staging, integration, development) or the target or resource type (app server code, client-side code, databases, hosts, etc.).

To make these types of alert policies easier to identify, you can give them names based on your architecture. For example:

  • Product A website (production)
  • Product B website (staging)
  • Mobile product app (iOS)
  • Hosts (production)
  • Databases (production)
Teams Specific teams may be responsible for parts of your architecture. For example, you may want to name their alert policy Team: Site engineering, Team: Website development, etc.

Alert policies set up for specific individuals may be useful when they want to personally keep an eye on a particular resource or metric. This provides them the freedom to add and remove conditions as well as adjust thresholds whenever they want, without having to communicate those changes to others.

To make these types of alert policies easier to identify, you can include the person's name in the alert policy; for example, User: John Doe's metrics, User: Jane Doe (production), etc.

Create an alert policy

Admins or Owner

As part of the alert policy workflow in New Relic Alerts, start by giving the policy a meaningful name:

  1. Go to > Alert policies.
  2. From the Alert policies index, select [plus icon] New alert policy.
  3. Type a meaningful name for the policy (maximum 64 characters).
  4. Select the incident preference.
  5. Select Create alert policy.

You can continue from here to define the alert conditions and assign one or more notification channels. If you decide to continue later, select the alert policy's name from the Alert policies index.

Change a policy's name

Admins or Owner

For your convenience, we allow you to use the same name for different policies, conditions, and notification channels. If you want to use unique names, review or search the index before adding or changing a name.

To rename an existing alert policy:

  1. Go to > Alert policies > (select a policy).
  2. Mouse over the policy's name, then select the edit [pencil icon] icon.
  3. Type a meaningful name for the policy (maximum 64 characters), then save.

New Relic Alerts automatically updates any associated alert conditions and notification channels for the policy.

View existing policies

The alert policies index lists policies in alphabetical order. To view or search for existing alert policies:

  1. Go to > Alert policies.
  2. Use the search box, sort any column, or scroll the list.
  3. To view detailed information, select the policy's name.

To view policy and condition information for a specific entity, select the Settings > Alert conditions page from the entity's New Relic product UI.

For more help

Recommendations for learning more: