From 8b899d0ead681e1162a74c2a160a5b357c7de6bd Mon Sep 17 00:00:00 2001 From: Mark Hintz Date: Thu, 28 Mar 2024 11:32:47 -0400 Subject: [PATCH] Update rollup.md to include the updates to interval logic and minimum 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> --- content/en/dashboards/functions/rollup.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/dashboards/functions/rollup.md b/content/en/dashboards/functions/rollup.md index 72fa9226e228..459f507b6c16 100644 --- a/content/en/dashboards/functions/rollup.md +++ b/content/en/dashboards/functions/rollup.md @@ -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 | |---------------------|-----------------------------|----------------------------|----------------------| @@ -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: