From da22492abc4d1e90ab8876a129f4b590a344ef6d Mon Sep 17 00:00:00 2001 From: Pavel Rysnik <126406830+sakuuj@users.noreply.github.com> Date: Sun, 22 Mar 2026 18:37:19 +0300 Subject: [PATCH 1/4] docs: fix 'stdvar' detailed explanation Signed-off-by: Pavel Rysnik <126406830+sakuuj@users.noreply.github.com> --- docs/querying/operators.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/querying/operators.md b/docs/querying/operators.md index f822709c7c..3e6cb43128 100644 --- a/docs/querying/operators.md +++ b/docs/querying/operators.md @@ -563,7 +563,7 @@ an info-level annotation. #### `stdvar` -`stdvar(v)` returns the standard deviation of `v`. +`stdvar(v)` returns the standard variance of `v`. `stdvar` only works with float samples, following IEEE 754 floating point arithmetic. Histogram samples in the input vector are ignored, flagged by From e680e9bf49e9016bc4ee195e44bd34a744d49b72 Mon Sep 17 00:00:00 2001 From: Pavel Rysnik <126406830+sakuuj@users.noreply.github.com> Date: Mon, 23 Mar 2026 11:12:46 +0300 Subject: [PATCH 2/4] docs: clarify 'stdvar' operator description Updated the description of the stdvar operator to clarify that it calculates variance instead of standard variance. Signed-off-by: Pavel Rysnik <126406830+sakuuj@users.noreply.github.com> --- docs/querying/operators.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/querying/operators.md b/docs/querying/operators.md index 3e6cb43128..82b0be78db 100644 --- a/docs/querying/operators.md +++ b/docs/querying/operators.md @@ -400,7 +400,7 @@ vector of fewer elements with aggregated values: * `count_values(l, v)` (count number of elements with the same value) * `stddev(v)` (calculate population standard deviation over dimensions) -* `stdvar(v)` (calculate population standard variance over dimensions) +* `stdvar(v)` (calculate population variance over dimensions) * `quantile(φ, v)` (calculate φ-quantile (0 ≤ φ ≤ 1) over dimensions) These operators can either be used to aggregate over **all** label dimensions @@ -563,7 +563,7 @@ an info-level annotation. #### `stdvar` -`stdvar(v)` returns the standard variance of `v`. +`stdvar(v)` returns the variance of `v`. `stdvar` only works with float samples, following IEEE 754 floating point arithmetic. Histogram samples in the input vector are ignored, flagged by From 354c0b262a7541a767d5dfd62d5785968eb52e0b Mon Sep 17 00:00:00 2001 From: Pavel Rysnik <126406830+sakuuj@users.noreply.github.com> Date: Mon, 23 Mar 2026 18:42:45 +0300 Subject: [PATCH 3/4] docs: change 'standard variance' to 'variance' Update functions.md file, change 'standard variance' to 'variance' in function descriptions Signed-off-by: Pavel Rysnik <126406830+sakuuj@users.noreply.github.com> --- docs/querying/functions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/querying/functions.md b/docs/querying/functions.md index 64e172000f..883f788a9b 100644 --- a/docs/querying/functions.md +++ b/docs/querying/functions.md @@ -459,7 +459,7 @@ the zero bucket and for buckets with custom boundaries, the arithmetic mean is u For the usual exponential buckets, the geometric mean is used. Float samples are ignored and do not show up in the returned vector. -Similarly, `histogram_stdvar(v instant-vector)` returns the estimated standard +Similarly, `histogram_stdvar(v instant-vector)` returns the estimated variance of observations for each native histogram sample in `v`. ## `hour()` @@ -866,7 +866,7 @@ over time and return an instant vector with per-series aggregation results: * `count_over_time(range-vector)`: the count of all samples in the specified interval. * `quantile_over_time(scalar, range-vector)`: the φ-quantile (0 ≤ φ ≤ 1) of all float samples in the specified interval. * `stddev_over_time(range-vector)`: the population standard deviation of all float samples in the specified interval. -* `stdvar_over_time(range-vector)`: the population standard variance of all float samples in the specified interval. +* `stdvar_over_time(range-vector)`: the population variance of all float samples in the specified interval. * `last_over_time(range-vector)`: the most recent sample in the specified interval. * `present_over_time(range-vector)`: the value 1 for any series in the specified interval. From 69f6ade9762614bd222e8fb3533fe215babca25e Mon Sep 17 00:00:00 2001 From: Pavel Rysnik Date: Thu, 26 Mar 2026 10:47:28 +0300 Subject: [PATCH 4/4] docs: update promql autocomplete Signed-off-by: Pavel Rysnik --- web/ui/mantine-ui/src/promql/functionDocs.tsx | 72 +++++++++---------- 1 file changed, 36 insertions(+), 36 deletions(-) diff --git a/web/ui/mantine-ui/src/promql/functionDocs.tsx b/web/ui/mantine-ui/src/promql/functionDocs.tsx index 75a4a767a7..fd94895996 100644 --- a/web/ui/mantine-ui/src/promql/functionDocs.tsx +++ b/web/ui/mantine-ui/src/promql/functionDocs.tsx @@ -518,8 +518,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -838,8 +838,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -1153,8 +1153,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -1581,8 +1581,8 @@ const funcDocs: Record = {

    - Similarly, histogram_stdvar(v instant-vector) returns the estimated standard variance of - observations for each native histogram sample in v. + Similarly, histogram_stdvar(v instant-vector) returns the estimated variance of observations for + each native histogram sample in v.

    ), @@ -1597,8 +1597,8 @@ const funcDocs: Record = {

    - Similarly, histogram_stdvar(v instant-vector) returns the estimated standard variance of - observations for each native histogram sample in v. + Similarly, histogram_stdvar(v instant-vector) returns the estimated variance of observations for + each native histogram sample in v.

    ), @@ -1958,8 +1958,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -2109,8 +2109,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -2219,8 +2219,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -2329,8 +2329,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -2545,8 +2545,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -2655,8 +2655,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -3137,8 +3137,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -3247,8 +3247,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -3357,8 +3357,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -3623,8 +3623,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -3733,8 +3733,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -3843,8 +3843,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval. @@ -3953,8 +3953,8 @@ const funcDocs: Record = { specified interval.
  • - stdvar_over_time(range-vector): the population standard variance of all float samples in the - specified interval. + stdvar_over_time(range-vector): the population variance of all float samples in the specified + interval.
  • last_over_time(range-vector): the most recent sample in the specified interval.