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

3164 Commits

Author SHA1 Message Date
Sibasis Padhi
f2dfa4b406 docs: add mixin definition to glossary
Fixes #1806

Added definition for 'mixin' to the glossary, explaining it as
a reusable set of Prometheus alerts, recording rules, and Grafana
dashboards typically packaged using Jsonnet for standardized
monitoring across infrastructure components.

Signed-off-by: Sibasis Padhi <sibasis.padhi@gmail.com>
2026-01-09 00:18:59 -06:00
Owen Williams
cbea98f4e9 docs(instrumenting): Update exposition_formats.md to include quoting syntax (#2800)
Signed-off-by: Owen Williams <owen.williams@grafana.com>
2026-01-06 14:31:35 -05:00
Jan Fajerski
0cdf2d2437 Merge pull request #2797 from akhilesh-ksolves/add-ksolves-under-commercial-support
Add ksolves Prometheus Commercial support
2025-12-16 17:37:23 +01:00
Jan Fajerski
6630be0193 Merge pull request #2705 from Helene/ibm_ess_exporter
Add IBM Storage Scale exporter to the exporters list in documentation
2025-12-16 17:16:56 +01:00
Jan Fajerski
6ba2876e6c Merge pull request #2710 from hao022/main
Add CCF HuaTuo exporter to the exporters list in documentation
2025-12-16 17:15:23 +01:00
Jan Fajerski
9db8c9b08d Merge pull request #2793 from incertum/add-swift-unofficial-client
add swift to unofficial third-party client libraries list
2025-12-16 16:33:41 +01:00
Arve Knudsen
a9b9330823 Add PromQL info function blog post (#2777)
* Add info function blog post

---------

Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com>
Co-authored-by: Owen Williams <owen.williams@grafana.com>
Co-authored-by: Björn Rabenstein <beorn@grafana.com>
2025-12-16 16:01:41 +01:00
Akhilesh
7acd0cf274 Add ksolves Prometheus Commercial support
Signed-off-by: Akhilesh <akhilesh.s@ksolves.com>
2025-12-12 20:24:44 +05:30
George Krajcsovits
3195123296 feat(om2): add native histograms to OpenMetrics2.0 (#2634)
* feat(om2): add native histograms to OpenMetrics2.0

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
Signed-off-by: George Krajcsovits <krajorama@users.noreply.github.com>
Co-authored-by: Bartlomiej Plotka <bwplotka@gmail.com>
Co-authored-by: David Ashpole <dashpole@google.com>
2025-12-10 14:51:34 +01:00
Jan Fajerski
eae7ff3bc6 Merge pull request #2699 from J-Verz/update-dovecot-url
Update the URL to Dovecot's metrics endpoint documentation
2025-12-09 16:40:33 +01:00
Jan Fajerski
6ccc07d8a1 Merge pull request #2792 from prometheus/dependabot/npm_and_yarn/next-15.5.7
build(deps): bump next from 15.5.2 to 15.5.7
2025-12-05 11:54:20 +01:00
Melissa Kilby
467de3d4e0 add swift to unofficial third-party client libraries list
Signed-off-by: Melissa Kilby <mkilby@apple.com>
2025-12-04 15:37:58 -08:00
dependabot[bot]
488d70abae build(deps): bump next from 15.5.2 to 15.5.7
Bumps [next](https://github.com/vercel/next.js) from 15.5.2 to 15.5.7.
- [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.5.2...v15.5.7)

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

Signed-off-by: dependabot[bot] <support@github.com>
2025-12-03 19:09:20 +00:00
Owen Williams
532758b6cf OM2.0: Add info and examples for UTF-8 (#2784)
Signed-off-by: Owen Williams <owen.williams@grafana.com>
2025-12-03 13:56:38 -05:00
Lukas Juozas Janusaitis
61ce601d19 docs(exposition): clarify required Content-type header for scrapes (#2772)
Signed-off-by: Lukas Juozas Janušaitis <lukas.janusaitis@hostinger.com>
2025-12-03 08:02:09 +00:00
Julius Volz
9bd3a6832f Blog post about new relabeling visualizer in Prometheus 3.8.0 (#2787)
* Blog post about new relabeling visualizer in Prometheus 3.8.0

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

* Reword introduction section

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

* Allow screenshots + videos to be slightly taller

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

---------

Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-12-02 13:32:34 +01:00
Julius Volz
48c5bbe57b Fix scrolling to fragment identifiers on newly loaded large pages (#2788)
When following a link to a fragment (#foo) on a long documentation page,
the browser would try to scroll to the fragment too early, before some
additional client-side layout shifts (could be due to font loading,
highlighting, etc.) would cause the scroll position to be wrong again. This
component waits for the layout to settle and then manually scrolls to the
requested fragment again.

You can see the problem by clicking on:

https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

It usually does not scroll directly to the relabeling section, but
somewhere above it.

Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-12-02 11:16:15 +01:00
Julius Volz
6b9ca93373 Make sure there are no line breaks directly before an external link icon (#2789)
Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-12-02 11:16:04 +01:00
Gregor Zeitlinger
3a44f48946 relax stance on metrics with same name but different labels (#2782)
Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
2025-11-24 13:59:36 +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