prometheus/docs
1
0
Fork 0
mirror of https://github.com/prometheus/docs.git synced 2026-02-05 06:45:01 +01:00
Code Issues Releases Activity
3,093 Commits 50 Branches 0 Tags
60c3cf0911848a7517bb0f1636ad06ab3485e06d
Commit Graph

3093 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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
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
Julius Volz
294868ec48 Fix double display of title on Governance page (#2696) 
Signed-off-by: Julius Volz <julius.volz@gmail.com>
 2025-07-17 23:45:50 +02:00
Julius Volz
0afa1ac44c Fix code link in Markdown guide (#2695) 
Signed-off-by: Julius Volz <julius.volz@gmail.com>
 2025-07-17 11:20:31 +02:00
Julius Volz
ba1a20dbb0 Update and improve the docs Markdown writing instructions (#2694) 
Signed-off-by: Julius Volz <julius.volz@gmail.com>
 2025-07-16 16:44:42 +02:00
David Leadbeater
c90124fac1 Add a more explicit note for security scanners and Go (#2693) 
govulncheck is usually right, other things less so.

Signed-off-by: David Leadbeater <dgl@dgl.cx>
 2025-07-16 15:59:43 +10:00
Joe Adams
e72cb2e370 Merge pull request #2687 from prometheus/dependabot/npm_and_yarn/next-15.3.4 
Bump next from 15.3.1 to 15.3.4
 2025-07-14 21:27:35 -04:00
Bryan Boreham
cda26d7c1f Add Release 3.5 as LTS (#2689) 
Signed-off-by: Bryan Boreham <bjboreham@gmail.com>
 2025-07-14 17:54:42 +01:00
Owen Williams
1c2dc97dd5 docs(opentelemtry): Add explanation of UnderscoreEscapingWithoutSuffixes translation strategy (#2688) 
ref: https://github.com/prometheus/prometheus/pull/16849

Signed-off-by: Owen Williams <owen.williams@grafana.com>
 2025-07-11 11:39:42 -04:00
Björn Rabenstein
3b42c6221e Merge pull request #2682 from prometheus/beorn7/histogram 
native histoggram spec: document extrapolation below zero heuristics
 2025-07-08 16:33:55 +02:00
Julius Volz
0f1512d852 Use new frontmatter docs title schema for new Prometheus/Alertmanager docs (#2686) 
Signed-off-by: Julius Volz <julius.volz@gmail.com>
 2025-07-03 23:17:05 +02:00
dependabot[bot]
8725a35540 Bump next from 15.3.1 to 15.3.4 
Bumps [next](https://github.com/vercel/next.js) from 15.3.1 to 15.3.4.
- [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.1...v15.3.4)

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

Signed-off-by: dependabot[bot] <support@github.com>
 2025-07-03 21:04:57 +00:00
George Krajcsovits
e39897e4ee refactor(om2): rename, align Created Value to Created Timestamp (#2685) 
I think it's a bit confusing when we want to refer to the value of a
Created Value, for example when we list values like Sum, Count, Created
Value values.

Also why isn't the token for the Created Value cv@ ? Create Timestamp
seems cleaner to me.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-07-01 15:02:50 +02:00
Arthur Silva Sens
63e50e9942 Update OM 2.0 with proposal#43 Created Timestamp syntax (#2636) 
* Update OM 2.0 with proposal#43
* Update ABNF representation of Created Values

Signed-off-by: Arthur Silva Sens <arthursens2005@gmail.com>
Signed-off-by: George Krajcsovits <krajorama@users.noreply.github.com>
Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com>
 2025-07-01 11:58:34 +02:00
George Krajcsovits
bbf3583e25 fix(nh-spec): update histogram_quantile and histogram_fraction docs (#2676) 
* fix(nh-spec): update histogram_quantile and histogram_fraction docs

Fix TODOs. And align with new implementation.
Related to https://github.com/prometheus/prometheus/issues/16578
Related to https://github.com/prometheus/prometheus/pull/16724
Related to https://github.com/prometheus/prometheus/issues/16580

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-06-25 13:38:14 +02:00
beorn7
6320b3fceb native histoggram spec: document extrapolation below zero heuristics 
This is based on the discussion and insights gained in
https://github.com/prometheus/prometheus/pull/16192 .

Signed-off-by: beorn7 <beorn@grafana.com>
 2025-06-20 00:52:13 +02:00
Sergey Yarlov
2e2c0a4bd4 Add Webhook integration for Alertmanager to Notion Database (#2678) 
* Add Webhook integration for Alertmanager to Notion Database

Signed-off-by: Sergey Yarlov <gdazeysinc@gmail.com>

* Fix backslash in description for for a Notion webhook integration.

Co-authored-by: Julius Volz <julius.volz@gmail.com>
Signed-off-by: Sergey Yarlov <gdazeysinc@gmail.com>

---------

Signed-off-by: Sergey Yarlov <gdazeysinc@gmail.com>
Co-authored-by: Julius Volz <julius.volz@gmail.com>
 2025-06-17 21:21:55 +02:00
Abhinav Sharma
479eb1b5c3 Add KodeKloud to Prometheus training providers (#2681) 
* add kodekloud in Courses and Trainings

Signed-off-by: Abhinav Sharma <abhinav@dreamkube.tech>

* retain order, and add correct label

Signed-off-by: Abhinav Sharma <abhinav@dreamkube.tech>

---------

Signed-off-by: Abhinav Sharma <abhinav@dreamkube.tech>
Co-authored-by: Abhinav Sharma <abhinav@dreamkube.tech>
 2025-06-17 20:55:27 +02:00
George Krajcsovits
e1b02bfad5 Merge pull request #2680 from prometheus/krajo/fix-abnf-checker-errorcode 
fix(abnf-checker): return error on example error
 2025-06-16 13:30:53 +02:00
György Krajcsovits
d8ca0d786e undo dummy change to trigger CI on openmetrics 
Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-06-16 13:17:16 +02:00
György Krajcsovits
b0a3961832 fix(abnf-checker): return error on example error 
We just printed the error before but not set exit code.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-06-16 13:15:18 +02:00
Augustin Husson
19b2d91095 add perses as another visualisation tool (#2673) 
* add perses as another visualisation tool

Signed-off-by: Augustin Husson <augustin.husson@amadeus.com>

* add a short description of Perses and apply review

Signed-off-by: Augustin Husson <augustin.husson@amadeus.com>

---------

Signed-off-by: Augustin Husson <augustin.husson@amadeus.com>
 2025-06-13 10:31:43 +02:00
Augustin Husson
fb6b195a8f add a short description about Grafana (#2674) 
Signed-off-by: Augustin Husson <augustin.husson@amadeus.com>
 2025-06-13 10:25:11 +02:00
George Krajcsovits
377f77fdab Merge pull request #2672 from prometheus/krajo/om2-verify-fix-examples 
test(om2): test that examples follow the spec and fix if not
 2025-06-11 10:53:00 +02:00
György Krajcsovits
37c1486196 test(om2): test that examples follow the spec and fix if not 
I did not want to clutter the examples with adding "# EOF" to all,
so I made a new marker to explicitly add it on request.

There was only one faulty example where we had an extra space, see
the Exemplars section.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-06-11 08:51:40 +02:00