PROMETHEUS-PROCESS-EXPORTER(1)

📦 version 0.8.7, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

prometheus-process-exporter — bestie, it's a Prometheus exporter that goes digging around in procfs to report on the processes you actually care about. like a lil detective for your process tree 🕵️♀️✨

🦋 SYNOPSIS 🦋

prometheus-process-exporter [option...]

🌸 DESCRIPTION 🌸

okay so real talk: some apps are just impossible to instrument directly. either you don't control the code 😭, or they're written in some language that does not want to play nice with Prometheus. this exporter is the fix — it mines process metrics straight out of procfs. no cap.

The recommended way to do things is to use a config file. but for convenience and for backwards compatibility, the -procnames / -namemapping options also exist as an alternative. iykyk 💅

Now the -children option (default: true) — this one is lowkey iconic. it makes it so that any process that otherwise isn't part of its own group becomes part of the first group found (if any) when you walk the process tree upwards. in other words: the resource usage of subprocesses gets added to their parent's usage, unless the subprocess identifies as a different group name. so like, the kids move back in with the parents unless they've legally changed their surname 🫶

✨ OPTIONS ✨

  • -children — if a proc is tracked, then track any children of it too, as long as those children aren't part of their own group (default true).
  • -config.path string — path to the YAML config file.
  • -debug — log debugging information to stdout. 👀
  • -man — print the manual.
  • -namemapping string — a comma-separated list, alternating between process name and a capturing regex to apply to cmdline.
  • -procfs string — path to read proc data from (default "/proc").
  • -procnames string — a comma-separated list of process names to monitor.
  • -recheck — re-check process names on each scrape. 🔁
  • -web.config.file string — path to the YAML web config file.
  • -web.listen-address string — the address on which to expose metrics and the web interface. (default ":9256").
  • -web.telemetry-path string — the path under which to expose metrics. (default "/metrics").

👑 SEE ALSO 👑

proc(5)

🌈 AUTHOR 🌈

Nick Cabatoff <nick.cabatoff@gmail.com>

and that's the whole page bestie, periodt 💅 this was prometheus-process-exporter, version 0.4.0, dated October 2018 — from the Prometheus manual fam. go forth and export those metrics, you absolute main character 🌟💖🦋

📦 where this page comes from