1
0
mirror of https://github.com/prometheus/docs.git synced 2026-02-05 15:45:27 +01:00
Commit Graph

3217 Commits

Author SHA1 Message Date
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
Tonghao Zhang
bcce477656 Add CCF HuaTuo exporter to the exporters list in documentation
Signed-off-by: Tonghao Zhang <tonghao@bamaicloud.com>
2025-08-27 09:12:57 -04: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
hwassman
913328bb1f add grafana-bridge
Signed-off-by: hwassman <hwassman@de.ibm.com>
2025-08-08 21:01:12 +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
J-Verz
b5841f3e0c Update the URL to Dovecot's metrics endpoint documentation.
I've linked to the docs for the main branch instead of for a specific
version so the link doesn't become outdated as quickly.

Signed-off-by: J-Verz <71394762+J-Verz@users.noreply.github.com>
2025-07-27 23:18:19 +02: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