mirrors/prometheus
1
0
Fork 0
mirror of https://github.com/prometheus/prometheus.git synced 2025-11-04 02:11:01 +01:00
Code Issues Projects Releases Wiki Activity
14,810 Commits 305 Branches 495 Tags
Commit Graph

49 Commits

Author SHA1 Message Date
Kateryna Pavlova
d6e43b89f4 docs: add regex section in querying basics 
Signed-off-by: Kateryna Pavlova <kathrinett@gmail.com>
 2024-11-24 22:03:04 +01:00
Kateryna Pavlova
bc008f1b0e docs: fix range queries link 
Signed-off-by: Kateryna Pavlova <kathrinett@gmail.com>
 2024-11-24 22:02:01 +01:00
Julius Volz
90f7832447
Merge pull request #15084 from hvnsweeting/patch-1 
docs: Querying basics: remove what can be graphed
 2024-10-08 14:59:07 +02:00
Viet Hung Nguyen
f0a9f62ce8 [DOCS] Querying basics: what can be graphed 
Put a scalar to query, it can be graphed.

So the doc says "an expression that returns an instant vector is the only type which can be graphed." is not correct?

And also, a query_range, which used for graph, always return a range vector <https://promlabs.com/blog/2020/06/18/the-anatomy-of-a-promql-query/#range-queries> , so it's confusing to read the above statement.

Signed-off-by: Viet Hung Nguyen <hvn@familug.org>
 2024-10-08 21:16:26 +09:00
beorn7
08d4b034da docs: Declare "float literals are time durations" as stable 
This unifies the documentation of float literals and time durations
and updates all references to the old definitions.

Signed-off-by: beorn7 <beorn@grafana.com>
 2024-10-07 14:22:49 +02:00
Craig Ringer
15b68e989c Refer to staleness in instant vector documentation 
The instant vector documentation does not explain which metric samples are selected - in particular, it makes no reference to staleness.

It's confusing when reading the docs to understand how exactly Prometheus selects the metrics to report: the most recent sample older than the search timestamp specified in the API request, so long as that metric is not "stale".

Signed-off-by: Craig Ringer <craig.ringer@enterprisedb.com>
 2024-09-26 11:54:31 +12:00
Jan Fajerski
00315ce15e Merge branch 'main' into 3.0-main-sync-24-08-30 
using -Xours

Signed-off-by: Jan Fajerski <jfajersk@redhat.com>
 2024-09-02 11:27:18 +02:00
Kevin Rawal
b0677263c3
Update basics.md 
fix broken URL for feature flags native histograms in querying prometheus documentation

Signed-off-by: Kevin Rawal <84058124+kevinrawal@users.noreply.github.com>
 2024-08-29 23:06:31 +05:30
Jan Fajerski
8a96a75ba8 Merge branch 'main' into 3.0-main-sync-24-08-01 
Signed-off-by: Jan Fajerski <jfajersk@redhat.com>
 2024-08-01 15:44:47 +02:00
Bryan Boreham
cc7dcf5afe [DOCS] Querying basics: explain range and instant queries 
I often see people ask questions that indicate they don't understand
this point, and launching into "instant vector" and "range vector" is
likely to point them in the wrong direction.

Remove the admonishment that the reader mustn't confuse these things.
Remove mention of "inferred sample timestamps" that is never explained.

Signed-off-by: Bryan Boreham <bjboreham@gmail.com>
 2024-07-22 16:31:06 +01:00
Jan Fajerski
adf5d6bce1 Merge branch 'main' into 3.0-main-sync-24-07-18 
Signed-off-by: Jan Fajerski <jfajersk@redhat.com>

Conflicts:
	VERSION
          pick 3.0.0
	promql/promqltest/testdata/histograms.test
          pick changes from c39776c5b5f5e0e7496f8aca3112063a655a50f2,
          but adjust 5m range selectors to 10m to account for
          https://github.com/prometheus/prometheus/pull/13904.
Fixes:
        promql/promqltest/testdata/functions.test
	promql/promqltest/testdata/staleness.test
          Tests added in https://github.com/prometheus/prometheus/pull/9138
          need to be adjusted to account for
          https://github.com/prometheus/prometheus/pull/13904.
 2024-07-18 15:56:40 +02:00
beorn7
706e19912b adjust version number in documentation 
Signed-off-by: beorn7 <beorn@grafana.com>
 2024-07-10 16:59:33 +02:00
darshanime
1a1b09fc3d Add a note about the new syntax 
Signed-off-by: darshanime <deathbullet@gmail.com>
 2024-07-10 15:50:23 +02:00
Zhang Zhanpeng
debbdb8608 make matrix selection and lookback left-open and right-closed 
Signed-off-by: Zhang Zhanpeng <zhangzhanpeng.zzp@alibaba-inc.com>
Signed-off-by: beorn7 <beorn@grafana.com>
Co-authored-by: beorn7 <beorn@grafana.com>
 2024-06-20 22:05:40 +08:00
pschou
b66b0a5288
docs: improve "Querying Prometheus" readability (#8492) 
Signed-off-by: schou <pschou@users.noreply.github.com>
Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com>
Co-authored-by: Bryan Boreham <bjboreham@gmail.com>
 2024-02-09 17:37:14 +00:00
Ted Robertson
73bbeaafbf
Docs: Query Basics: link to rate (#10538) 
Co-authored-by: Julien Pivotto <roidelapluie@o11y.eu>
 2024-01-16 11:09:51 +00:00
Salar Nosrati-Ershad
fd96996b75 docs: fix: correct reference to native histograms feature flag 
Signed-off-by: Salar Nosrati-Ershad <snosratiershad@gmail.com>
 2023-08-19 17:35:20 +03:30
Julien Pivotto
4c81a8f681
Merge pull request #11578 from chancefeick/fix/querying-documentation 
Fix Querying Documentation Links
 2023-08-08 09:21:31 +02:00
Julien Pivotto
fc2e4cd3b9 docs: Fix link to feature flags. 
Signed-off-by: Julien Pivotto <roidelapluie@o11y.eu>
 2023-07-11 13:17:39 +02:00
beorn7
71c57a1292 docs: Clarify that range selectors use a closed interval 
Signed-off-by: beorn7 <beorn@grafana.com>
 2023-03-16 13:55:57 +01:00
Chance Feick
2cfd8da628
Update docs/querying/basics.md 
Co-authored-by: Julien Pivotto <roidelapluie@o11y.eu>
Signed-off-by: Chance Feick <6326742+chancefeick@users.noreply.github.com>
 2022-11-15 08:10:44 -08:00
Chance Feick
52270d6216 Fix relative link to use .md file extension 
Signed-off-by: Chance Feick <cfeick@gitlab.com>
 2022-11-14 13:30:22 -08:00
Björn Rabenstein
41035469d3
Document the native histogram feature flag and PromQL (#11446) 
Signed-off-by: beorn7 <beorn@grafana.com>
Signed-off-by: Ganesh Vernekar <ganeshvern@gmail.com>
Co-authored-by: Ganesh Vernekar <ganeshvern@gmail.com>
 2022-10-14 18:16:12 +05:30
SuperQ
a3dd323a53
Make regex-matching docs more obvious 
Split out the note about regex-matching into a separate paragraph to
make it more obvious. Move it up, closer to the definition.

Signed-off-by: SuperQ <superq@gmail.com>
 2022-01-14 23:18:31 +01:00
beorn7
b39f2739e5 PromQL: Always enable negative offset and @ modifier 
This follows the line of argument that the invariant of not looking
ahead of the query time was merely emerging behavior and not a
documented stable feature. Any query that looks ahead of the query
time was simply invalid before the introduction of the negative offset
and the @ modifier.

Signed-off-by: beorn7 <beorn@grafana.com>
 2022-01-11 17:08:55 +01:00
Levi Harrison
b9b5adfe62 Rename links 
Signed-off-by: Levi Harrison <git@leviharrison.dev>
 2021-08-06 21:54:44 -06:00
schou
65658091ed moved details of feature to disabled features.md 
Signed-off-by: schou <pschou@users.noreply.github.com>
 2021-03-03 21:42:17 -05:00
schou
946dba6a7f small suggested changes 
Signed-off-by: schou <pschou@users.noreply.github.com>
 2021-03-03 21:35:51 -05:00
schou
71712183ac minor wording updates 
Signed-off-by: schou <pschou@users.noreply.github.com>
 2021-02-23 20:26:35 -05:00
schou
22cd48868a adding feature flag, promql-negative-offset 
Signed-off-by: schou <pschou@users.noreply.github.com>
 2021-02-23 20:25:56 -05:00
schou
8aa9cc3978 add blob to basics documentation about negative shift 
Signed-off-by: schou <pschou@users.noreply.github.com>
 2021-02-23 20:25:56 -05:00
Ganesh Vernekar
86c71856e8
Add start() and end() pre-processors for @ modifier (#8425) 
* Add start() and end() pre-processors for @ modifier

Signed-off-by: Ganesh Vernekar <cs15btech11018@iith.ac.in>

* Fix reviews

Signed-off-by: Ganesh Vernekar <cs15btech11018@iith.ac.in>

* Fix review comments

Signed-off-by: Ganesh Vernekar <cs15btech11018@iith.ac.in>

* Fix review comments

Signed-off-by: Ganesh Vernekar <cs15btech11018@iith.ac.in>
 2021-02-09 21:33:16 +05:30
Ganesh Vernekar
9199fcb8d1
'@ <timestamp>' modifier (#8121) 
This commit adds `@ <timestamp>` modifier as per this design doc: https://docs.google.com/document/d/1uSbD3T2beM-iX4-Hp7V074bzBRiRNlqUdcWP6JTDQSs/edit.

An example query:

```
rate(process_cpu_seconds_total[1m]) 
  and
topk(7, rate(process_cpu_seconds_total[1h] @ 1234))
```

which ranks based on last 1h rate and w.r.t. unix timestamp 1234 but actually plots the 1m rate.

Signed-off-by: Ganesh Vernekar <cs15btech11018@iith.ac.in>
 2021-01-20 16:27:39 +05:30
Justin Toh
5f103aaecc
docs: Fix "time duration" link (#8209) 
Signed-off-by: Justin Toh <tohjustin@hotmail.com>
 2020-11-20 12:25:45 +00:00
Julien Pivotto
d867491364
Human-friendly durations in PromQL (#7713) 
* Add support for user-friendly durations

Signed-off-by: Julien Pivotto <roidelapluie@inuits.eu>
 2020-08-04 21:12:41 +02:00
Julius Volz
9da59c856d
Improve scalar literal format documentation (#7651) 
* Improve scalar literal format documentation

Signed-off-by: Julius Volz <julius.volz@gmail.com>

* Address review comments

Signed-off-by: Julius Volz <julius.volz@gmail.com>

* Fixup

Signed-off-by: Julius Volz <julius.volz@gmail.com>
 2020-07-25 13:34:57 +02:00
Brian Brazil
44ad28dd5e
PromQL: Allow more keywords as metric names (#6933) 
* Allow more keywords as metric names
* Add documentation about forbidden keywords

Signed-off-by: Tobias Guggenmos <tobias.guggenmos@uni-ulm.de>
 2020-03-05 13:20:53 +00:00
Tobias Guggenmos
1e0cd28bf6 PromQL: Support trailing commas in grouping opts (#6480) 
* PromQL: Support trailing commas in grouping opts

Fixes #6470

Signed-off-by: Tobias Guggenmos <tguggenm@redhat.com>
 2019-12-20 11:28:56 +00:00
Julien Pivotto
2a190d1168 Fix small typo in docs (#6345) 
Signed-off-by: Julien Pivotto <roidelapluie@inuits.eu>
 2019-11-20 10:12:47 +01:00
Tobias Guggenmos
fbcf41c90b doc: Add documentation about comments in PromQL (#6198) 
* Add documentation about comments

Signed-off-by: Tobias Guggenmos <tguggenm@redhat.com>
 2019-10-25 11:01:59 +01:00
Semyon Slepov
33f085a4d6 Remove bits about substring matching from the docs (#5549) 
Substring matching for labels doesn't work anymore.
These parts are misleading, and contradict with the rest of the
documentation.

Signed-off-by: Semyon Slepov <slepovss@gmail.com>
 2019-05-09 11:12:32 +01:00
Ganesh Vernekar
dbe55c1352 Subquery (#4831) 
Signed-off-by: Ganesh Vernekar <cs15btech11018@iith.ac.in>
 2018-12-22 13:47:13 +00:00
Julius Volz
c96828fb57 Mention PromQL by name in querying basics doc (#4996) 
Signed-off-by: Julius Volz <julius.volz@gmail.com>
 2018-12-18 11:57:00 +01:00
Brian Brazil
cd54add5b8
Clarify that {a="b",a!="c"} is possible. (#4492) 
Signed-off-by: Brian Brazil <brian.brazil@robustperception.io>
 2018-08-13 11:38:57 +01:00
Matthias Rampke
cae4538b3e Docs: state that all regular expressions are RE2. (#3518) 
We already mentioned that regular expressions are RE2 for
[relabeling][0], but left open what the regular expression syntax
anywhere else is.

In the querying examples and reference, make it explicit that _all_
regular expressions are RE2.

[0]: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
 2017-12-01 17:26:06 +00:00
Ben Kochie
40f33f45cb Fix docs that use regexp anchors (#3504) 
Remove/fix docs that use anchors in label regexp matches.
 2017-11-22 12:11:21 +00:00
Brian Brazil
7187771f20
Document new staleness (#3380) 
Remove "interpolation" for this heading, that hasn't
been in these docs for a long time.
 2017-11-01 12:40:47 +00:00
Tobias Schmidt
f432b8176d Consolidate configuration and rules docs in docs/configuration/ 2017-10-27 09:54:02 +02:00
Tobias Schmidt
e6cdc2d355 Import querying documentation from prometheus/docs 2017-10-26 22:36:47 +02:00