diff --git a/docs/metrics/introduction/metric-quantization.md b/docs/metrics/introduction/metric-quantization.md index 5e218bf250..96fb5ed62b 100644 --- a/docs/metrics/introduction/metric-quantization.md +++ b/docs/metrics/introduction/metric-quantization.md @@ -9,7 +9,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; Sumo ingests individual metric data points from your metric sources. In metric visualizations, rather than charting individual data points, Sumo presents the aggregated value of the data points received during an interval. -Quantization is the process of aggregating metric data points for time series over an interval, for example, an hour or a minute, using a particular aggregation function: `avg`, `min`, `max`, `sum`, or `count`. +Quantization is the process of aggregating metric data points for time series over an interval, for example, an hour or a minute, using a particular aggregation function: `avg`, `min`, `max`, `sum`, `count`, or `rate`. ### Quantization terminology @@ -38,38 +38,20 @@ By default, Sumo uses the `avg` rollup type. You can specify another rollup type We use the term rollup to refer to the aggregation function Sumo uses when quantizing metrics. This table describes the different rollup types you can select when running a query. - - - - - - - - - - - - - - - - - - - - - - - - - -
Rollup type Description
avg Calculates the average value of the data points for a time series in each bucket.
min Calculates the minimum value among the data points for a time series in each bucket.
max Calculates the maximum value among the data points for a time series in each bucket.
sumCalculates the sum of the values of the data points for a time series in each bucket.
countCalculates the count of data points for a time series in each bucket.
+| Rollup type | Description | +| :-- | :-- | +| [`avg`](/docs/metrics/metrics-operators/avg/) | Calculates the average value of the data points for a time series in each bucket. | +| [`min`](/docs/metrics/metrics-operators/min/) | Calculates the minimum value among the data points for a time series in each bucket. | +| [`max`](/docs/metrics/metrics-operators/max/) | Calculates the maximum value among the data points for a time series in each bucket. | +| [`sum`](/docs/metrics/metrics-operators/sum/) | Calculates the sum of the values of the data points for a time series in each bucket. | +| [`count`](/docs/metrics/metrics-operators/count/) | Calculates the count of data points for a time series in each bucket. | +| [`rate`](/docs/metrics/metrics-operators/rate/) | Calculates the per-second rate of change between data points in a time series in each bucket. | Sumo quantizes metrics upon ingestion and at query time. ### Quantization at ingestion -Upon ingestion, Sumo quantizes raw metric data points to one hour resolutions for all rollup types: `avg`, `min`, `max`, `sum`, and `count`. This data is stored in one hour rollup tables in Sumo. The raw data is stored in a table referred to as the baseline table. For information about retention times, see [Metric Ingestion and Storage](/docs/metrics/manage-metric-volume/metric-ingestion-and-storage.md). +Upon ingestion, Sumo quantizes raw metric data points to one hour resolutions for all rollup types: `avg`, `min`, `max`, `sum`, `count`, and `rate`. This data is stored in one hour rollup tables in Sumo. The raw data is stored in a table referred to as the baseline table. For information about retention times, see [Metric Ingestion and Storage](/docs/metrics/manage-metric-volume/metric-ingestion-and-storage.md). ### Automatic quantization at query time diff --git a/docs/metrics/metrics-operators/quantize.md b/docs/metrics/metrics-operators/quantize.md index 4f082f8c1f..fca312c924 100644 --- a/docs/metrics/metrics-operators/quantize.md +++ b/docs/metrics/metrics-operators/quantize.md @@ -9,7 +9,7 @@ You can use the `quantize` operator to control the Sumo’s quantization behavio You can specify: * The size of the time buckets across which Sumo aggregates your metrics. If you do not specify a quantization interval, Sumo determines an optimum size for time buckets, as described in [Automatic quantization at query time](../introduction/metric-quantization.md).   -* The rollup type that Sumo uses to aggregate the individual data points in a time bucket, which can be one of `avg, min, max, sum,` or `count`. If you do not specify a rollup type in the `quantize` clause of your query, for each time bucket, Sumo presents the average of the data points in that bucket.   +* The rollup type that Sumo uses to aggregate the individual data points in a time bucket, which can be one of `avg`, `min`, `max`, `sum`, `count`, or `rate`. If you do not specify a rollup type in the `quantize` clause of your query, for each time bucket, Sumo presents the average of the data points in that bucket.   ## Syntax @@ -20,7 +20,7 @@ quantize [to INTERVAL] [using ROLLUP] [drop last] where: * `INTERVAL` is the duration over which you want to quantize the metrics, in seconds (`s`), minutes (`m`), hours (`h`), or days (`d`). -* `ROLLUP` is  `avg, min, max, sum`, or `count`. +* `ROLLUP` is  `avg`, `min`, `max`, `sum`, `count`, or `rate`. * `drop last` causes the last time bucket to be dropped, if the end of that bucket is after the end of the query time range. * At least one of the `to INTERVAL` or `using ROLLUP` clauses needs to be present.