PROMETHEUS-PUSHGATEWAY(1)

📦
version 1.11.2 · 8 versions
, in ubuntu resolute, ubuntu stonking

💖 NAME 💖

prometheus-pushgateway — the Prometheus gateway for push metrics, bestie. It's literally the middleman that lets you push your metrics in. Iconic behavior fr.

✨ SYNOPSIS ✨

prometheus-pushgateway [<flags>]

🦋 DESCRIPTION 🦋

The Pushgateway. That's it, that's the description. It's giving short and mysterious. No cap. 🎀

💅 OPTIONS 💅

  • -h, --help — Show context-sensitive help. Also try --help-long and --help-man if you want the extended cut, iykyk. 🔥
  • --web.systemd-socket — Use systemd socket activation listeners instead of port listeners. Linux only, so don't come crying to me on macOS. 🫶
  • --web.listen-address=:9091 — Addresses on which to expose metrics and web interface. It's repeatable for multiple addresses, so go off, stack them. Examples: :9100 or [::1]:9100 for http, vsock://:9100 for vsock. 👑
  • --web.config.file — Path to configuration file that can enable TLS or authentication. See: https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md — go read it, it's a whole vibe. 📖
  • --web.local-assets — Path to static assets/templates directory. ✨
  • --web.telemetry-path — Path under which to expose metrics.
  • --web.external-url= — The URL under which the Pushgateway is externally reachable. Your outside-facing glow-up URL. 🌈
  • --web.route-prefix — Prefix for the internal routes of web endpoints. Defaults to the path of --web.external-url. 🎀
  • --web.enable-lifecycle — Enable shutdown via HTTP request. Yes really, it shuts down over HTTP. 🙈
  • --web.enable-admin-api — Enable API endpoints for admin control actions. Admin main character energy. 👑
  • --persistence.file — File to persist metrics. If empty, metrics are only kept in memory — which means poof, gone on restart, so choose wisely bestie. 💀
  • --persistence.interval=5m — The minimum interval at which to write out the persistence file. Lowkey a chill little timer. ⏰
  • --push.disable-consistency-check — Do not check consistency of pushed metrics. DANGEROUS. The original said it in all caps and honestly? It meant it. 🚨
  • --push.enable-utf8-names — Allow UTF-8 characters in metric and label names. Let your names be fancy. 🌸
  • --log.level=info — Only log messages with the given severity or above. One of: [debug, info, warn, error]. ✨
  • --log.format=logfmt — Output format of log messages. One of: [logfmt, json]. 🧚
  • --version — Show application version. Slay. 💖
Heads up bestie: --push.disable-consistency-check is flagged DANGEROUS in the source material and I am not softening that. That's a facts-are-facts situation. 💀

That's the whole page, and that's on periodt. This lil doc is from prometheus-pushgateway version 1.11.2, dated February 2026 — shoutout to the Prometheus crew for the source and the version, mwah, love that for them. 🫶💖✨

📦 where this page comes from