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

3143 Commits

Author SHA1 Message Date
SuperQ
8db7d12cc5 Improve HA FAQ entry
Update the high availaibliy FAQ entry with information about data
deduplication.

Remove wording about memberlist as it's confusing to readers that it's
part of the Prometheus HA design.

Signed-off-by: SuperQ <superq@gmail.com>
2025-11-21 08:25:42 +01:00
George Krajcsovits
60c24e4500 feat(om2): exemplar timestamp MAY to SHOULD (#2775)
Make the exemplar timestamp a SHOULD in preparation for complex types
having multiple exemplars at a time. We'll explain why having timestamp
for exemplars of complex types is a good idea there.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
2025-11-20 08:40:58 +01:00
Arve Knudsen
9e02fa111c OpenTelemetry guide: document the info function's churn handling (#2776)
Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com>
2025-11-14 16:44:48 +01:00
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