prometheus/docs
1
0
Fork 0
mirror of https://github.com/prometheus/docs.git synced 2026-02-05 15:45:27 +01:00
Code Issues Releases Activity
3,116 Commits 49 Branches 0 Tags
2c220462ac08f9cd93486efcf55693498abc4d40
Commit Graph

3116 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
beorn7
2c220462ac spec (histograms): Clarify valid custom values 
Neither +Inf nor NaN are valid custom values.

Signed-off-by: beorn7 <beorn@grafana.com>
 2025-10-08 15:51:46 +02:00
Martyn Dale
ad9ddde70a docs: Fix utf8 escaping parameter in content negotiation docs (#2748) 
Signed-off-by: Martyn Dale <martynd@users.noreply.github.com>
 2025-10-08 10:41:37 +02:00
George Krajcsovits
66bd52f285 feat(om1.1): relax the requirements around unit and total suffixes (#2750) 
* feat(om1.1): relax the requirements around unit and total suffixes

Allow exposers to expose metrics that do not put `_total` or unit
as suffix to metric names.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
Signed-off-by: George Krajcsovits <krajorama@users.noreply.github.com>
Co-authored-by: David Ashpole <dashpole@google.com>
 2025-10-08 09:42:24 +02:00
George Krajcsovits
057e0e6e1c chore(om1.1) Set status of OM 1.1 as draft (#2749) 
Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-10-03 11:15:52 +02:00
Björn Rabenstein
2adaf965bc Merge pull request #2742 from prometheus/beorn7/histogram 
spec: Be explicit about invalidity of negative histograms
 2025-10-02 14:48:10 +02:00
Bartlomiej Plotka
5a0b8f8588 om1: Update release date (#2743) 
OM seemed to be released around Nov 2020:
https://www.robustperception.io/openmetrics-is-released/

Signed-off-by: bwplotka <bwplotka@gmail.com>
 2025-10-02 09:03:24 +02:00
Björn Rabenstein
7790addd94 Merge pull request #2744 from dancer1325/patch-2 
docs: fix typo in content_negotation
 2025-10-01 18:52:45 +02:00
beorn7
96abc1284a spec: Be explicit about invalidity of negative histograms 
Signed-off-by: beorn7 <beorn@grafana.com>
 2025-10-01 18:15:06 +02:00
dancer13
2dab534214 docs: fix typo in content_negotation 
Signed-off-by: dancer13 <alfredotic0809@gmail.com>
 2025-10-01 18:10:42 +02:00
Björn Rabenstein
2daaf90624 Merge pull request #2739 from prometheus/beorn7/histogram 
specs: Clarify federation of NHCB
 2025-09-30 17:06:07 +02:00
beorn7
2e8e4dad14 specs: Clarify federation of NHCB 
Signed-off-by: beorn7 <beorn@grafana.com>
 2025-09-30 16:44:12 +02:00
Mohammad Alavi
09c4b47bda Fix typo in metric name (#2734) 
Signed-off-by: Mohammad Alavi <m.alavi1986@gmail.com>
 2025-09-29 10:05:26 +02:00
Björn Rabenstein
aea54d3d9d Merge pull request #2737 from prometheus/beorn7/histogram 
native histogram spec: More clarifications about schemas
 2025-09-24 18:07:38 +02:00
beorn7
b27dead365 native histogram spec: More clarifications about schemas 
Signed-off-by: beorn7 <beorn@grafana.com>
 2025-09-24 16:01:48 +02:00
Goutham Veeramachaneni
3d2339c49e Merge pull request #2738 from prometheus/revert-2731-revert-2730-promblog-fix 2025-09-24 15:31:51 +02:00
Humberto Evans
f002a8574c Fix link for HeyOnCall integration (#2736) 
HeyOnCall was formerly called Heii On-Call. Just fixing the name and domain on the webhook alert manager integrations documentation.

Signed-off-by: Humberto Evans <hevans66@gmail.com>
 2025-09-24 14:06:08 +02:00
Björn Rabenstein
9f539b8fe6 Merge pull request #2725 from prometheus/beorn7/histogram 
native histograms: clarify schema reduction and schemas 9-52
 2025-09-24 13:45:18 +02:00
Goutham Veeramachaneni
0090184018 Revert "Revert "update promcon blog with latest (sold out) (#2730)" (#2731)" 
This reverts commit dc45de6fdb.
 2025-09-23 09:34:52 +02:00
Bartlomiej Plotka
dc45de6fdb Revert "update promcon blog with latest (sold out) (#2730)" (#2731) 
This reverts commit 7378ba2e2b.
 2025-09-22 21:49:43 +02:00
Bartlomiej Plotka
7378ba2e2b update promcon blog with latest (sold out) (#2730) 
* update promcon blog with latest (sold out)

Turns out it's sold out already, so updating

Signed-off-by: bwplotka <bwplotka@gmail.com>

* Update blog/posts/2025-09-22-promcon-2025.md

Co-authored-by: Joe Adams <github@joeadams.io>
Signed-off-by: Bartlomiej Plotka <bwplotka@gmail.com>

---------

Signed-off-by: bwplotka <bwplotka@gmail.com>
Signed-off-by: Bartlomiej Plotka <bwplotka@gmail.com>
Co-authored-by: Joe Adams <github@joeadams.io>
 2025-09-22 21:48:33 +02:00
Bartlomiej Plotka
8c229351a5 blog: add PromCon25 post (#2724) 
* blog: add PromCon25 post

Signed-off-by: bwplotka <bwplotka@gmail.com>

* Apply suggestions from code review

Co-authored-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
Signed-off-by: Bartlomiej Plotka <bwplotka@gmail.com>

* added livestream links

Signed-off-by: bwplotka <bwplotka@gmail.com>

* update dates

Signed-off-by: bwplotka <bwplotka@gmail.com>

---------

Signed-off-by: bwplotka <bwplotka@gmail.com>
Signed-off-by: Bartlomiej Plotka <bwplotka@gmail.com>
Co-authored-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
 2025-09-22 13:37:16 +02:00
Augustin Husson
b945e92d96 Revert "remove matrix url as it is abandoned" (#2727) 
Signed-off-by: Augustin Husson <augustin.husson@amadeus.com>
 2025-09-19 17:35:11 +02:00
George Krajcsovits
60c3cf0911 OM1.1: create OpenMetrics 1.1 draft and enable CI check of ABNF on it (#2726) 
* copy om1.0 to om1.1 and hide

Also update the front matter a little bit.

* Enable running ABNF check on OM1.1
* enable checking the full example and per metric type

Sync checks with OM2.0.

* fix extra space before value bug in example

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-09-19 16:31:36 +02:00
Julien
a8475b1a0d Merge pull request #2722 from roidelapluie/mssp 
rw2: Add missing space after link
 2025-09-19 13:52:02 +02:00
beorn7
8aad695057 native histograms: clarify schema reduction and schemas 9-52 
Call out that schemas can be reduced upon ingestion and that the
"reserved" schemas 9 to 52 MAY already be accepted if they are reduced
to the currently valid schemas -4 to 8.

Update the section about limiting resolution accordingly.

Signed-off-by: beorn7 <beorn@grafana.com>
 2025-09-18 17:46:24 +02:00
Joe Adams
7942dc61ba Merge pull request #2723 from prometheus/nexucis/remove-matrix-url 
remove matrix url as it is abandoned
 2025-09-18 07:02:34 -04:00
Augustin Husson
dd95677f89 remove matrix url as it is abandoned 
Signed-off-by: Augustin Husson <augustin.husson@amadeus.com>
 2025-09-18 09:27:16 +02:00
Victoria Nduka
eccea3a42f [blog] moved blog files to posts sub dir (#2720) 
* moved blog files to posts sub dir

Signed-off-by: Victoria Nduka <ndukavictoria7@gmail.com>

* Update blog-helpers.ts

point blogPostsDir to blog-posts/posts to restore build


Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>

* rename blog-posts to blog and update blog-helpers.ts

Signed-off-by: Victoria Nduka <ndukavictoria7@gmail.com>

---------

Signed-off-by: Victoria Nduka <ndukavictoria7@gmail.com>
Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
 2025-09-14 19:05:32 +01:00
Julien Pivotto
b79f93dcbb rw2: Add missing space after link 
Signed-off-by: Julien Pivotto <291750+roidelapluie@users.noreply.github.com>
 2025-09-11 11:13:31 +02:00
Bartlomiej Plotka
d21a28013c feat: add mentorship section with some tips for mentees and mentors (#2717) 
* feat: add mentorship section with some tips for mentees and mentors

Signed-off-by: bwplotka <bwplotka@gmail.com>

* Apply suggestions from code review

Co-authored-by: Saswata Mukherjee <saswataminsta@yahoo.com>
Signed-off-by: Bartlomiej Plotka <bwplotka@gmail.com>

* Apply suggestions from code review

Co-authored-by: Julius Volz <julius.volz@gmail.com>
Co-authored-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
Signed-off-by: Bartlomiej Plotka <bwplotka@gmail.com>

---------

Signed-off-by: bwplotka <bwplotka@gmail.com>
Signed-off-by: Bartlomiej Plotka <bwplotka@gmail.com>
Co-authored-by: Saswata Mukherjee <saswataminsta@yahoo.com>
Co-authored-by: Julius Volz <julius.volz@gmail.com>
Co-authored-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
 2025-09-08 10:26:49 +01:00
Bartlomiej Plotka
e1fcda2cba fix: fix build by allowing README file in blog dir (#2718) 
Signed-off-by: bwplotka <bwplotka@gmail.com>
 2025-09-04 07:31:35 +01:00
Victoria Nduka
26ea1fff36 Rename blog-content-guide.md to README.md (#2715) 
Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
 2025-09-04 06:40:59 +01:00
Björn Rabenstein
6e5fe6ae14 Merge pull request #2716 from prometheus/beorn7/histogram 
histogram spec: Fix wording around annotation about counter resets
 2025-09-04 00:33:33 +02:00
beorn7
8d14d8b015 histogram spec: Fix wording around annotation about counter resets 
Previously, we wrongly stated that there will never be an annotation
about conflicting counter resets ever. However, with the
HistogramStatsIterator (used for functions `histogram_count`,
`histogram_sum`, and `histogram_avg`), you could craft a query that
will produce the annotation.

Signed-off-by: beorn7 <beorn@grafana.com>
 2025-09-03 17:23:00 +02:00
dependabot[bot]
ee27e5c532 Bump next from 15.3.4 to 15.5.2 (#2711) 
Bumps [next](https://github.com/vercel/next.js) from 15.3.4 to 15.5.2.
- [Release notes](https://github.com/vercel/next.js/releases)
- [Changelog](https://github.com/vercel/next.js/blob/canary/release.js)
- [Commits](https://github.com/vercel/next.js/compare/v15.3.4...v15.5.2)

---
updated-dependencies:
- dependency-name: next
  dependency-version: 15.5.2
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
 2025-09-03 12:10:31 +01:00
Victoria Nduka
e8b5ca00c6 docs: create blog-content-guide.md (#2713) 
* docs: create blog-content-guide.md

Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>

* create `assets` folder

Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>

* update blog-content-guide.md per feedback

Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>

---------

Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
 2025-09-02 19:46:40 +02:00
Julien
9846b5a7c7 feat(downloads): mark first stable release as Latest (even if LTS) (#2712) 
- Ensure the very first non-prerelease version is always tagged as Latest
- Allow coexistence of Latest + LTS badges on the same release

I recommend using "Hide whitespace changes" option for a clearer diff.

Signed-off-by: Julien Pivotto <291750+roidelapluie@users.noreply.github.com>
 2025-09-02 17:20:34 +02:00
Björn Rabenstein
432c621b67 Merge pull request #2708 from prometheus/beorn7/histogram 
histogram spec: Remove TODO about synthetic zero sample
 2025-08-23 00:10:25 +02:00
beorn7
a0dbf0270d histogram spec: Remove TODO about synthetic zero sample 
https://github.com/prometheus/prometheus/issues/16575 is closed. This
TODO can go.

Signed-off-by: beorn7 <beorn@grafana.com>
 2025-08-21 23:22:12 +02:00
Björn Rabenstein
c349e0710f Merge pull request #2707 from prometheus/beorn7/histogram 
Native histogram spec: Clarify counter reset handling for + and -
 2025-08-19 12:30:44 +02:00
beorn7
41b3c64c2f Native histogram spec: Clarify counter reset handling for + and - 
Also, clarify that the same implications are valid for the `sum` and `avg`
aggregation.

Signed-off-by: beorn7 <beorn@grafana.com>
 2025-08-16 09:33:45 +02:00
Björn Rabenstein
6a370d339f Merge pull request #2706 from prometheus/beorn7/histogram 
native histogram spec: Update section about unary minus
 2025-08-13 17:29:57 +02:00
beorn7
4c85a0970b native histogram spec: Update section about unary minus 
This clarifies the behavior of unary minus WRT the counter reset hint
and that negative histograms are always considered gauges.

This concludes https://github.com/prometheus/prometheus/issues/16579 ,
but we still need sligtly more involved changes here to resolve
https://github.com/prometheus/prometheus/issues/16576 .

Signed-off-by: beorn7 <beorn@grafana.com>
 2025-08-13 17:22:46 +02:00
George Krajcsovits
b6a90f5c6d fix(om2): histograms and negative observed values (#2627) 
OM1.0 required that the Sum of Histograms is not represented when there are negative observations in a histogram.

This PR is removing this requirement in OM2.0. Due to:
The requirement was never implemented by the Go and Java instrumentation libraries. Enforcing it now would be breaking.
The requirement makes it impossible to implement the use case where the user wants to measure the Sum anyway. Which means for example that you'll not be able to calculate average from Sum/Count.
We already warned users in the documentation about the possibility of Sum decreasing and not being usable for rate() 10 years ago: PR.
And native histograms will not take Sum into account when calculating counter resets during rate() , thus this problem won't come up.

Note1: the python reference implementation did follow the requirement.

Note 2: this PR does not make Sum mandatory, that is a different question.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-08-13 12:19:33 +02:00
Owen Williams
d82d764e43 utf8: update doc for deprecated bool (#2702) 
Signed-off-by: Owen Williams <owen.williams@grafana.com>
 2025-08-04 13:54:54 -04:00
Alex Greenbank
09389f107f Merge pull request #2700 from prometheus/alexg/update-email-address 
update Alex company affiliation
 2025-07-29 15:15:36 +01:00
Alex Greenbank
1239945f28 update Alex email address 
Signed-off-by: Alex Greenbank <alex@greenbank.org>
 2025-07-29 11:45:17 +01:00
Owen Williams
4b1b80f5f6 utf8: update doc for deprecated bool (#2698) 
Signed-off-by: Owen Williams <owen.williams@grafana.com>
 2025-07-24 10:49:44 -04:00
Ayoub Mrini
9e8760846f chore(security.md): add more precisions regarding sec bugs reporting (#2692) 
* chore(security.md): add more precisions regarding sec bugs reporting

Signed-off-by: machine424 <ayoubmrini424@gmail.com>

* address review feedback

Signed-off-by: machine424 <ayoubmrini424@gmail.com>

---------

Signed-off-by: machine424 <ayoubmrini424@gmail.com>
 2025-07-21 10:27:39 +02:00
Julius Volz
b0b4136461 Allow referrer info for outgoing links again (#2697) 
It can actually be nice to show other websites that they are getting traffic
from prometheus.io. After deploying the new website, I noticed in my own
Plausible tracking for training.promlabs.com that I (supposedly) wasn't getting
traffic from prometheus.io anymore and was wondering for a second what was
going on.

Signed-off-by: Julius Volz <julius.volz@gmail.com>
 2025-07-19 19:53:07 +02:00