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:
These operators can either be used to aggregate over **all** label dimensions
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
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`
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:
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