• Log in

NRQL query limits

New Relic's query language, NRQL, has rate limits in place to ensure a high level of availability and reliability for all users.

Understand query limit violations

To see if you're hitting query-related limits, use the Limits UI.

You should rarely encounter rate limiting. Here are some guidelines to follow to ensure query limiting will be rare:

  • Limit the number complex queries (for example, queries with FACET or TIMESERIES clauses, or queries of over a million events) that run at the same time.
  • Limit the number of queries running concurrently over extended periods of time to a maximum of five, especially if they include complex queries.

NRQL query limits

There are a few different NRQL query limits:

  • Number of queries an account can make in a given time range
  • Number of data points an account can query (inspect) in a given time range
  • How long a query can run for before being considered an error and stopping

Note that these limits apply only to customer-initiated NRQL queries, such as queries using the query builder, queries used in custom charts and dashboards, and NRQL queries done with our NerdGraph API. These limits don't apply to queries used in pre-built, "out-of-the-box" New Relic charts and dashboards.

We'll go into more detail on these limits.

Limits on number of queries

The limit on NRQL queries is 3,000 queries per account per minute. When this limit is exceeded, queries may be rejected until the number of queries sent per minute no longer exceeds the limit.

This limit is only applicable to the NRQL Query API requests and not the queries run from the query builder, New Relic UI, or custom dashboards. The limits that govern the rate of resource consumption for this category of queries run on the New Relic UI, query builder, or customer dashboards are only the Inspected count limits.

Limits on number of data points inspected

When you run a NRQL query, it displays the number of data points inspected, as shown below:

In this context, the "events" term is used in a general sense to refer to all NRQL-available data points that are inspected in a query.

Every New Relic account has limits on the total number of data points that can be inspected in a given time range. These limits vary depending on which data option you have:

Query duration limit

The query duration limit is how long a NRQL query can run before it stops running. This limit depends on your data option:

  • Original data option: 1 minute
  • Data Plus: 2 minutes (longer query duration coming soon)
Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.