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,184 Commits 50 Branches 0 Tags
4865cc4147aba67a4b79f94fddad969d3e05dd38
Commit Graph

3184 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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
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
Marc
6893aca9ec feat: add the exporter scraparr 
Signed-off-by: Marc <mbg14.gaming@gmail.com>
 2025-06-13 14:38:28 +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
Matan Baruch
f52f7a0c9a Add NetBird exporter to the exporters list in documentation (#2669) 
Signed-off-by: matanbaruch <matan.baruch@unity3d.com>
 2025-06-05 23:58:39 +02:00
Julius Volz
b8f281d0f5 Allow anonymous GitHub usage without GITHUB_TOKEN env variable (#2670) 
In case the env var isn't present (like in a Netlify deploy without
sensitive variables), this makes sure that "auth" is undefined rather than
an invalid empty string.

Signed-off-by: Julius Volz <julius.volz@gmail.com>
 2025-06-05 20:52:43 +02:00
Simon Prickett
cbfa1f27c7 Fixed a couple of small typos/phrasing issues in the Alerting based on metrics tutorial (new website version). (#2667) 
* Fixed some minor typos.

Signed-off-by: Simon Prickett <simon.prickett@grafana.com>

* Removed H1.

Signed-off-by: Simon Prickett <simon.prickett@grafana.com>

* Fixed locla links.

Signed-off-by: Simon Prickett <simon.prickett@grafana.com>

* Fixed alerting doc link.

Signed-off-by: Simon Prickett <simon.prickett@grafana.com>

---------

Signed-off-by: Simon Prickett <simon.prickett@grafana.com>
 2025-06-04 23:04:55 +02:00
Julius Volz
e79e4bdb8b Merge pull request #2666 from sysadmind/blog-feed 
Update blog RSS feed with rendered content
 2025-06-04 10:24:58 +02:00
Joe Adams
1b377fc4ef Update blog RSS feed with rendered content 
After migrating to Next.js in #2656, the blog RSS feed was missing the rendered markdown content for the blog. This uses the unified package, similar to how we render the blog entires, to render the entries to HTML inside the feed.

Signed-off-by: Joe Adams <github@joeadams.io>
 2025-06-03 22:07:07 -04:00
George Krajcsovits
73e11b8fb3 Merge pull request #2665 from prometheus/krajo/ci-abnf-check 
chore(ci): add action to test abnf syntax and examples in OM2.0 spec
 2025-05-30 07:53:09 +02:00
György Krajcsovits
aec9f25239 Move abnf test to their own directory 
Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-05-30 07:50:05 +02:00
Julius Volz
e58e0f1f9f Merge pull request #2664 from Fadi-hamwi/patch-2 
Added OpenVPN exporter to the exporters.md
 2025-05-29 19:54:24 +02:00
György Krajcsovits
2ebe3605b0 pin abnf version 
Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
 2025-05-29 17:16:53 +02:00