• Log in

NRQL: Segment your data into buckets

Using NRQL, you can split your query results into buckets that cover certain ranges using the buckets function .

Create bucketed NRQL query

To return bucketed results, use the FACET buckets() clause in a NRQL query. A bucketing query has the structure:


Bucketing can be used with any attribute that is stored as a numerical value in the New Relic database.

Bucket query example

To create a chart that shows the average duration of ranges of database calls:

  1. Create a NRQL statement with a SELECT statement for an attribute; for example, SELECT average(duration).
  2. Add a FACET clause that facets on buckets for another attribute; for example, buckets(databaseCallCount,400,10).

This query computes the average duration for each of the 10 buckets, with an upper limit of 400. All values above our upper limit of 400 are grouped in the last bucket, “>=360.0”.

SELECT average(duration) FROM Transaction
SINCE 12 hours ago
FACET buckets(databaseCallCount, 400, 10)

This query returns the following results:

Here' an example of a NRQL query with segments broken out into ten buckets. The bottom bucket will include outliers, so you may want to adjust accordingly.

Copyright © 2022 New Relic Inc.

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