Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
D
docs
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Administrator
docs
Commits
a7eb9d68
Commit
a7eb9d68
authored
Jun 12, 2015
by
Julius Volz
Browse files
Options
Browse Files
Download
Plain Diff
Merge pull request #112 from prometheus/keep-common
Update docs regarding `keep_common` modifier.
parents
6e70c62b
c07878b6
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
6 additions
and
2 deletions
+6
-2
operators.md
content/docs/querying/operators.md
+6
-2
No files found.
content/docs/querying/operators.md
View file @
a7eb9d68
...
@@ -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>)] [keep
ing_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
`keep
ing_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
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment