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

3140 Commits

Author SHA1 Message Date
Bartlomiej Plotka
98ccc3adf7 Redirect openmetrics.io domain to om dir (#2774)
Signed-off-by: bwplotka <bwplotka@gmail.com>
2025-11-13 19:56:55 +01:00
Bartlomiej Plotka
4a5230e6bc Redirect top level spec/<proj> dir to the latest version (#2773)
This is to allow redirect of openmetrics.io domain to
https://prometheus.io/docs/specs/om/ on CNCF side and then be able to
dynamically switch latest on our side.

Signed-off-by: bwplotka <bwplotka@gmail.com>
2025-11-12 14:02:09 +01:00
George Krajcsovits
a04d7ce0f3 chore(om2.0): rename created timestamp to start timestamp (#2770)
From dev summit decision on 23rd October 2023.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
2025-11-11 08:57:06 +01:00
Victoria Nduka
9b2c67b76b Update 2025-10-30-non-code-contribution.md (#2771)
I noticed that the hyperlink to the blog content guide was leading to a 404 error on the live site, even though it worked correctly on GitHub. I think the issue was caused by using a relative link. I’ve updated the link to use an absolute URL so it resolves properly in the published blog.

Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
2025-11-06 14:10:59 +01:00
Matthias Friedrich
fca6b9ba91 Adds another exporter for Azure Health (replaces the FXinnovation/azure-health-exporter since the repo no longer exists) (#2769)
Signed-off-by: Matthias Friedrich <1573457+matzefriedrich@users.noreply.github.com>
2025-11-05 16:56:04 +01:00
Owen Williams
65a6ca0265 feat(om2.0): Add UTF-8 metric names and labels (#2746)
Part of https://github.com/prometheus/prometheus/issues/16093

Signed-off-by: Owen Williams <owen.williams@grafana.com>
2025-11-05 08:25:31 +01:00
Bartlomiej Plotka
2530b2cdfd RW 2.0-rc.4 (breaking): Move CT from TimeSeries to Sample; Rename to ST (Start Timestamp) (#2762)
* prw2(breaking): Move 2.0 CT to Sample; Rename to ST (Start Timestamp)

Given the recent movement for Prometheus native support of ST
([PROM-60](https://github.com/prometheus/proposals/pull/60)) and plans
for delta temporality
([PROM-48](https://github.com/prometheus/proposals/pull/48)) it might be
beneficial to make (hopefully) last change to Remote Write 2.0 before
stabilizing, so:

* Raname Created Timestamp to Start Timestamp
* Move CT/ST from TimeSeries to Sample and Histogram messages.
* Clarified optionality (0 value meaning unset)

See implementation change that will follow:
https://github.com/prometheus/prometheus/pull/17411. Notice that only
receiver part was implemented for CT/ST. Given no sending part was done
we expect this feature (ST/CT) not being used, thus breakage impact is
minimal. This has been confirmed with early adopters like Mimir
(Grafana), Chronosphere, Thanos, Cortex and Google.

See previous discussions and 3 expilcit approvals:
https://github.com/prometheus/prometheus/pull/17036

Additionally:
* I updated link to proto
* Updated links to new compliance tests
* Update native histogram spec link

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

* Update docs/specs/prw/remote_write_spec_2_0.md

Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com>
Signed-off-by: Bartlomiej Plotka <bwplotka@gmail.com>

* Update docs/specs/prw/remote_write_spec_2_0.md

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: George Krajcsovits <krajorama@users.noreply.github.com>
2025-11-04 18:47:09 +00:00
Victoria Nduka
044fd991b6 add 'read more' marker instruction to blog guidelines (#2767)
Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
2025-11-03 08:44:39 +01:00
Victoria Nduka
1189f16f6c Add post about non-code contributions (#2765)
* add post about non-code contributions

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

* added a "read more" marker

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

* update date

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

---------

Signed-off-by: Victoria Nduka <122698422+nwanduka@users.noreply.github.com>
2025-11-01 07:55:51 +01:00
George Krajcsovits
ca94ec0ccc feat(om2.0): relax suffix rules for total and unit (#2763)
Fixes: https://github.com/prometheus/OpenMetrics/issues/286

Based on #2750 and #2751

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
2025-10-31 08:16:34 +01:00
pako-23
3dbdf491d5 reworiding exporter announcing documentation (#2753)
Signed-off-by: pako-23 <pasqualepolverino98@gmail.com>
2025-10-30 13:02:58 +01:00
Bartlomiej Plotka
db005cb7b5 om2: Update authors; update intro (#2754)
* om2: Update authors; update intro

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

* added emails

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

---------

Signed-off-by: bwplotka <bwplotka@gmail.com>
2025-10-29 09:17:56 +00:00
Gaurav Maheshwari
1934595d49 Add Oodle as a remote write receiver (#2757)
Signed-off-by: Gaurav Maheshwari <gaurav.maheshwari@oodle.ai>
2025-10-27 16:19:28 +01:00
Julien
6de3a98bc5 Merge pull request #2761 from roidelapluie/affiliation
Update affiliation
2025-10-27 14:00:01 +01:00
Julien Pivotto
9bcb1bc493 Update affiliation
Signed-off-by: Julien Pivotto <291750+roidelapluie@users.noreply.github.com>
2025-10-27 12:50:13 +01:00
Ben Kochie
eb9ce37e77 Merge pull request #2760 from d0ugal/fix-exporters-link
Fix exporters link path in writing_exporters.md
2025-10-25 23:04:02 +02:00
Dougal Matthews
09e8eccc47 Fix exporters link path in writing_exporters.md
- Remove incorrect 'content/' prefix from the exporters link
- Link now correctly points to docs/instrumenting/exporters.md

Signed-off-by: Dougal Matthews <dougal@grafana.com>
2025-10-25 21:16:28 +01:00
George Krajcsovits
74c5ee2507 feat(nh): remove experimental from native histograms (#2741)
* feat(nh): remove experimental from native histograms

Remove "experimental" word from native histograms docs.

Also fix a bunch of typos.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
Signed-off-by: George Krajcsovits <krajorama@users.noreply.github.com>
Co-authored-by: Björn Rabenstein <beorn@grafana.com>
2025-10-24 12:08:55 +02:00
Arve Knudsen
5a056203fb OTel guide: recommend using the info function for joining with target_info (#2756)
Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com>
2025-10-22 18:24:14 +02:00
Björn Rabenstein
a923400e48 Merge pull request #2752 from prometheus/beorn7/histogram
Various native histogram spec updates
2025-10-22 13:38:50 +02:00
beorn7
f24c4e662b spec (histograms): Clarify that the zeroth custom bucket includes -Inf
Signed-off-by: beorn7 <beorn@grafana.com>
2025-10-22 13:35:08 +02:00
beorn7
58b069adce spec (histograms): Clarify counter reset hints after aggregations
We are currently not really implementing this, but we should. It's
just a minor issue, but see
https://github.com/prometheus/prometheus/issues/17308 to get it right.

Signed-off-by: beorn7 <beorn@grafana.com>
2025-10-16 14:48:53 +02:00
beorn7
5b2f031e8a spec (histograms): Further clarify NHCB federation
Signed-off-by: beorn7 <beorn@grafana.com>
2025-10-16 14:48:53 +02:00
beorn7
9822c48708 spec (histograms): Add NHCB bucket layout reconciliation
We originally planned to not include this in the initial feature set.
But now https://github.com/prometheus/prometheus/pull/17278 is
underway, so let's aim for it.

Signed-off-by: beorn7 <beorn@grafana.com>
2025-10-16 14:48:53 +02:00
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