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

3065 Commits

Author SHA1 Message Date
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
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
Fadi Hamwi
a629ed770f Update exporters.md
I don't know alphabet my bad :)

Signed-off-by: Fadi Hamwi <69624793+Fadi-hamwi@users.noreply.github.com>
2025-05-29 16:55:34 +03:00
György Krajcsovits
91dacf3a45 chore(ci): add action to test abnf syntax and examples in OM2.0 spec
Action item from OpenMetrics 2.0 WG.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
2025-05-29 15:11:53 +02:00
Fadi Hamwi
cafc1274a6 Update exporters.md
Signed-off-by: Fadi Hamwi <69624793+Fadi-hamwi@users.noreply.github.com>
2025-05-29 12:54:15 +03:00
Julius Volz
90377c2418 Merge pull request #2662 from prometheus/standardize-local-doc-titles
Standardize H1 title use in local Markdown docs
2025-05-28 21:06:51 +02:00
Julius Volz
535b63758a Merge pull request #2663 from prometheus/nextjs-google-analytics
Include Google Analytics via Next.js instead of Netlify snippet
2025-05-28 20:43:59 +02:00
Julius Volz
e4bfbc4a12 Include Google Analytics via Next.js instead of Netlify snippet
Following the steps at https://nextjs.org/docs/app/guides/third-party-libraries#google-analytics

Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-05-28 19:58:03 +02:00
Julius Volz
6f30614fc9 Merge pull request #2661 from prometheus/revert-themepicker-breakage
Revert accidentally committed theme selector change
2025-05-28 17:00:17 +02:00
Julius Volz
e3766bda2a Revert accidentally committed theme selector change
This reverts things back to the state of
18209a3827/src/components/ThemeSelector.tsx

Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-05-28 16:55:09 +02:00
Julius Volz
8bdb919e82 Standardize H1 title use in local Markdown docs
See https://groups.google.com/g/prometheus-developers/c/cwL3cM66Em8

In addition, I took the editorial liberty to make slight other
modifications to some of the titles, where it seemed necessary. Also had to
adjust deeper header levels further into the doc when the page started off
with the wrong one.

And I fixed one completely broken list that was close to a title :P

The PR also fixes up the React code to already handle the new titling
scheme for local docs outside of the Markdown content.

Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-05-28 16:46:48 +02:00
Julius Volz
a946db5a6f Merge pull request #2657 from prometheus/move-new-sections
Move some new docs from "Concepts" to "Instrumenting", fix up titles
2025-05-28 16:23:10 +02:00
Julius Volz
eead755ce1 Merge pull request #2660 from prometheus/more-navtitle-usage
Also use `navTitle` over `title` in prev/next buttons and breadcrumbs
2025-05-28 15:55:56 +02:00
Julius Volz
03891f79ba Also use navTitle over title in prev/next buttons and breadcrumbs
Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-05-28 15:32:12 +02:00
Julius Volz
38ce9f69d5 Fix flickering dropdown, clean up popover state handling (#2659)
The main change here is the detaching / hiding of the dropdown when the
target element (the burger icon) is hidden from the screen. This can happen
when opening the dropdown at a screen width where the burger is shown, then
changing the screen width (e.g. by rotating your phone) to a width where
the burger is hidden, and then rotating back to where it's shown. Then the
popup would flicker around wildly after that, and a page reload would be
required to use the burger normally again. With this change, the dropdown
simply stays open (until dismissed) even if the burger disappears.

Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-05-28 11:41:45 +02:00
Julius Volz
59fa73c767 Wrap search results properly in narrow window (#2658)
Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-05-28 10:16:58 +02:00
Julius Volz
79a0d61074 Move some new docs from "Concepts" to "Instrumenting"
See https://github.com/prometheus/docs/pull/2653#issuecomment-2913952990

Also change the titles:

* "Prometheus" is redundant in the context of Prometheus, let's make it
  more about UTF-8
* Make the nav titles shorter so they fit nicer into the nav (title
  on the page itself can still be long)
* We don't use title casing (at least in the "Instrumenting" section), so
  lower-casing the titles

Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-05-27 23:10:04 +02:00
Julius Volz
b69f6b4a4a Merge pull request #2656 from prometheus/docs-next-merge
Merge new Next.js docs site and completely wipe old one
2025-05-27 20:03:43 +02:00
Julius Volz
60c4d88635 Fix sort order for new Concepts pages
Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-05-27 19:50:45 +02:00
Julius Volz
6f6b47c110 Merge branch 'main' into docs-next-merge
Signed-off-by: Julius Volz <julius.volz@gmail.com>
2025-05-27 19:41:55 +02:00
Owen Williams
ed7d9777dd docs[open-telemetry]: Add specifications for content negotation and escaping, and docs for translation strategies for Otel metric name translation (#2653)
Signed-off-by: Owen Williams <owen.williams@grafana.com>
2025-05-27 13:26:39 -04:00