Infrastructure and Alerts: Add, edit, or view host alert information

With New Relic Infrastructure, you can create alert conditions directly within the context of what you are currently monitoring with New Relic. For example, if you are monitoring a filter set and notice a problem, you do not need to recreate that criteria from New Relic Alerts.

Instead, you can immediately select your filter set, and tailor the alert condition directly from the chart you are viewing. This helps you proactively manage and monitor the alerting system for your environment. Any alert violations will be created per host within the filter set.

Anyone can view alerts tied to your New Relic Infrastructure account. Only Owner, Admins, or Add-on Managers can create, modify, or delete conditions.

Create alert conditions in New Relic Infrastructure

Owner, Admins, or Add-on Managers

To add a New Relic Infrastructure alert condition to a New Relic Alerts policy:

  1. From, select any of these Infrastructure pages: Hosts, Processes, Network, or Storage. Mouse over the chart you want to alert on, select the ellipses [ellipses icon] icon, and then select Create alert.


    From, select Settings > Alerts, then select [bell icon] Create alert condition.

  2. Type a meaningful condition name.
  3. Select the Alert type, or refer to the examples for additional help with which type to select.
  4. Apply filter sets to identify the set of hosts (and any additional options for interfaces, processes, etc. as applicable) that you want the alert condition to apply to.

    For best results, use attributes or partial strings to filter on hosts. Manually selecting hosts is not advised. For more about this, see Alert condition query limitations.

  5. Define the Critical (required) and Warning (optional, if available) thresholds for triggering the alert notification.
  6. Optional: To create the condition criteria proactively but not receive alert notifications at this time, turn off the Enabled checkbox option.
  7. Select an existing policy for the new condition.


    Select the option to create a new policy and identify the email for alert notifications.

  8. Optional: Add a runbook url.

  9. Optional: Set auto-close time period for violations.

  10. Select Create.

Alert conditions apply to alert policies. You can select an existing policy or create a new policy with email notifications from the New Relic Infrastructure UI. If you want to use other types of notification channels, create a New Relic Alerts policy.

The Infrastructure REST API has a limit of 3,700 alert conditions, including both active and disabled conditions. The API, whether used directly or via the UI, will reject all requests to add any additional alert conditions beyond the 3,700 alert condition limit.

Create alert conditions for Infrastructure integrations

Owner, Admins, or Add-on Managers

To create an alert condition for your New Relic Infrastructure integrations, use any one of these options:

  • From New Relic Alerts: Select Alert policies > New alert policy > Create new condition and select Infrastructure as the product. You can also do this by clicking on a pre-existing policy and selecting Add a condition.
  • From New Relic Infrastructure: Select the Integrations page, then select [bell icon] Create alert for any integration.
  • From New Relic Insights: To create an alert condition while viewing your integration data on your dashboard, select Create alert beneath the integration description.

Then continue with the procedures to add an alert condition to Infrastructure.

View host alert events

Anyone included in the policy's notification channel receives alert notifications directly. In addition, anyone with permissions for your New Relic account can view New Relic Infrastructure alert incidents and individual violations through the user interface.

  1. From, select Events.
  2. To change the hosts or time frame, use the search window, Filter set, or Time functions.
  3. From the Events list, select the alert violation.
  4. To view detailed information in New Relic Alerts about the selected violation, select the link.

Update or delete host alert information

Owner, Admins, or add-on managers

To edit, disable (or re-enable), or delete host alert information:

  1. From, select Settings > Alerts.
  2. Optional: Use the search window or Select all checkbox to locate one or more alert conditions.
  3. Select any of the available functions to [pencil icon] edit, disable, enable, or [trash can icon] delete the selected conditions.

Use New Relic Alerts to monitor your entire infrastructure

New Relic Alerts provides a single, coordinated alerting tool across all of your New Relic products. This allows you to manage alert policies and conditions that focus on the metrics for entities that you care about the most, such as Docker containers, JVMs, and more.

Alert features Features in New Relic Infrastructure
Alert policy conditions
Information on alerts
Alert policies

View, add, change, disable, or delete:

  • For policies with a variety of notification channels: Use the New Relic Alerts UI.
  • For policies only needing email notifications: When adding a condition from the New Relic Infrastructure UI: From Infrastructure > Settings > Alerts, select Create a new policy, and add one or more email addresses as needed.

Add host conditions to an existing policy: Use the Infrastructure UI.

Notification channels

To view, add, change, or delete available notification options:

  1. From, select Settings > Alerts.
  2. Optional: Search for the condition or policy name.
  3. From the list of conditions, select the policy link to view notification channel information in the New Relic Alerts UI.

Add or edit a runbook URL

The alert condition creation process includes an option for setting a URL for runbook instructions. This lets you link to information or standard procedures for handling an alert condition violation.

Owner, Admins, or Add-on Managers

To add, update, or delete an alert condition's runbook URL:

  1. Select an alert condition and make changes to the runbook URL.
  2. Save the condition. In order to be saved, the URL must be a valid URL.

Auto-close time period for violations

The violation time limit allows you to define an auto-close time period for violations. This means that when an alert is triggered, it will close automatically after the time you have set. By default, auto-close time is 24 hours.

Owner, Admins, or Add-on Managers

To add, update or remove an alerts condition violation time limit:

  1. Select an alert condition and make changes to the violation time limit.
  2. To remove this limit, select Never.
  3. Save the condition.

Alert conditions that generate too-long NRQL queries

Alert conditions created in Infrastructure rely on behind-the-scenes NRQL queries, and NRQL queries have a 4096-character limit. This means that if your alert generates a very complex NRQL query that filters on many elements (for example, including many hosts, or many tags), it will exceed this limit and display an error message saying that the condition failed.

The solution to this problem is to reduce the number of elements you are using in your alert condition. For example, if you entered a large number of hosts that caused the condition to fail, you could reduce the number of hosts. Other solutions include:

  • Reform your alert condition to target specific attributes that apply to the entities you're trying to target.
  • Create custom attributes for the entities you want to target, and use those attributes in your alert condition.
  • Use substrings to target hosts. For example: instead of targeting prod-host-01, prod-host-02 and prod-host-03, just target all hosts with prod-host-0 in the name.

For more about this issue, see Best practices for filtering in Infrastructure alerts on the Explorer's Hub.

For more help

Recommendations for learning more: