Skip to content

Commit

Permalink
Update rollup.md to include the updates to interval logic and minimum…
Browse files Browse the repository at this point in the history
… interval logic (#22393)

* Update rollup.md to include the updates to interval logic and minimum interval logic

We've updated the default interval logic for time series graphs, including lowering the minimum intervals substantially. The docs don't yet reflect these changes, so this PR updates them to describe the system more accurately and in a bit more detail

* Update rollup.md docs per edit feedback

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

* Update per edit feedback

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

---------

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>
  • Loading branch information
mhintz and rtrieu committed Mar 28, 2024
1 parent ee80638 commit 8b899d0
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions content/en/dashboards/functions/rollup.md
Expand Up @@ -43,7 +43,7 @@ Applying the `moving_rollup()` function to a query allows you to combine points

## Rollup interval: enforced vs custom

When graphing, Datadog imposes a limit on the number of points per graph. To respect this limit, Datadog rolls up data points automatically with the `avg` method, effectively displaying the average of all data points within a time interval for a given metric. This default time interval varies depending on how the data is being visualized. See the following chart to reference these default time intervals:
When graphing, Datadog sets a limit on the number of points per timeseries. To retain visual clarity, a series can have up to 1500 points. To respect this limit, Datadog rolls up datapoints automatically, defaulting to the `avg` method, effectively displaying the average of all datapoints within a time interval for a given metric. The default rollup time interval varies depending on how the data is visualized. See the following chart to reference these default time intervals:

| Timeframe | Rollup Interval, Line Graph | Rollup Interval, Bar Graph | Rollup Interval, API |
|---------------------|-----------------------------|----------------------------|----------------------|
Expand All @@ -52,9 +52,9 @@ When graphing, Datadog imposes a limit on the number of points per graph. To res
| The past day | 5m | 20m | 5m |
| The past two days | 10m | 30m | 10m |
| The past week | 1hr | 2hr | 1hr |
| The past month | 2hr | 12hr | 4hr |
| The past month | 4hr | 12hr | 4hr |

A custom `.rollup()` function can be used to enforce the type of time aggregation applied (`avg`, `min`, `max`, `count`, or `sum`) and the time interval to rollup.
A custom `.rollup()` function can be used to enforce the type of time aggregation applied (`avg`, `min`, `max`, `count`, or `sum`) and optionally the time interval to rollup. Using this function, you can set the rollup time interval to a different value than the defaults, up to a limit of 1500 points. This supports up to one point per minute over a day.

**Note**: Queries for `COUNT` and `RATE` type metrics have the `.as_count()` modifier appended automatically in the UI, which sets the rollup method used to `sum` and disables interpolation. This `.as_count()` is explicitly visible at the end of the query:

Expand Down

0 comments on commit 8b899d0

Please sign in to comment.