Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

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

Merged
merged 3 commits into from Mar 28, 2024
Merged

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

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
fb704bd
Update rollup.md to include the updates to interval logic and minimum…
mhintz Mar 28, 2024
d06ce9c
Update rollup.md docs per edit feedback
mhintz Mar 28, 2024
9e3a08d
Update per edit feedback
mhintz Mar 28, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
6 changes: 3 additions & 3 deletions content/en/dashboards/functions/rollup.md
View file
Open in desktop
Expand Up @@ -43,7 +43,7 @@

## 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:

Check notice on line 46 in content/en/dashboards/functions/rollup.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.sentencelength 

Suggestion: Try to keep your sentence length to 25 words or fewer.

| Timeframe | Rollup Interval, Line Graph | Rollup Interval, Bar Graph | Rollup Interval, API |
|---------------------|-----------------------------|----------------------------|----------------------|
Expand All @@ -52,9 +52,9 @@
| 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 |
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line graphs were aligned with what the API returns for a 1-month time frame


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