APM metric alert conditions

While there are various ways to create APM metric alert conditions, we recommend using NRQL because this provides additional controls, improved detection time, and consistency across all data types.

In 2021, we will be making it easier to create alert NRQL conditions from charts and queries throughout New Relic One. Until that integration is complete, please use the method described below. We'll show an example of how to create an APM external service condition using NRQL.

To set up an APM metric condition, it's a two-part process: you first need to identify the entity and then create the NRQL condition.

Identify the entity

Here's how to get started:

  1. Go to one.newrelic.com, and click APM in the toolbar.
  2. Find the service you’d like to alert on.
  3. Click on the service.
  4. In the left navigation pane, click External services.
  5. Under Top 20 external services, find the service you want and click on it.
    Screen capture showing the list of the top 20 external services to choose from.
  6. On the right side of the page, where you see graphs for Response time and External calls per minute (throughput), decide which of these two options you would like to alert on.
  7. In the upper-right corner of the graph you choose, click the three dots, and select View query.

    If you don’t see these three dots, ensure the Show new view option at the top of the page is enabled.

    Screenshot showing the menu options.
  8. Copy the query to your clipboard.
    • If you choose response time, your query may look like this:
      Example showing a query for response time.
    • If you choose external calls per minute, your query may look like this:
      Example show an external calls query.

When your query is on the clipboard, continue to the next section to create the NRQL alert condition.

Create the NRQL condition

After you generate the query, complete the following:

  1. Navigate to the alert's policy where you’d like to create this condition.
  2. Click Add a condition, select the NRQL tab, and click Next, define thresholds...
  3. In Define your signal, paste the query from your clipboard.
  4. Remove any LIMIT, SINCE...AGO, and TIMESERIES clauses. These must be removed for the NRQL query syntax to be valid.

    If no results are returned, ensure you are in the correct account using the account dropdown in the upper-left corner.

    Screenshot reminding you to remove unnecessary NRQL clauses.
  5. Fill out the remaining fields and save your condition.

See our additional information about querying APM metric timeslice data with NRQL.

For more help

If you need more help, check out these support and learning resources: