Commit a7eb9d68 authored by Julius Volz's avatar Julius Volz

Merge pull request #112 from prometheus/keep-common

Update docs regarding `keep_common` modifier.
parents 6e70c62b c07878b6
...@@ -169,14 +169,18 @@ vector of fewer elements with aggregated values: ...@@ -169,14 +169,18 @@ vector of fewer elements with aggregated values:
These operators can either be used to aggregate over **all** label dimensions These operators can either be used to aggregate over **all** label dimensions
or preserve distinct dimensions by including a `by`-clause. or preserve distinct dimensions by including a `by`-clause.
<aggr-op>(<vector expression>) [by (<label list>)] [keeping_extra] <aggr-op>(<vector expression>) [by (<label list>)] [keep_common]
By default, labels that are not listed in the `by` clause will be dropped from By default, labels that are not listed in the `by` clause will be dropped from
the result vector, even if their label values are identical between all the result vector, even if their label values are identical between all
elements of the vector. The `keeping_extra` clause allows to keep those extra elements of the vector. The `keep_common` clause allows to keep those extra
labels (labels that are identical between elements, but not in the `by` labels (labels that are identical between elements, but not in the `by`
clause). clause).
Until Prometheus 0.14.0, the `keep_common` keyword was called `keeping_extra`.
The latter is still supported, but is deprecated and will be removed at some
point.
Example: Example:
If the metric `http_requests_total` had time series that fan out by If the metric `http_requests_total` had time series that fan out by
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment