PROMETHEUS-BLACKBOX-EXPORTER(1)

💖 PROMETHEUS-BLACKBOX-EXPORTER(1) 💖

okay bestie, so this is the manual page for prometheus-blackbox-exporter, living in the Prometheus section of your manual pages. and honestly? she's iconic. let's get into it 🫶

---

✨ NAME ✨

prometheus-blackbox-exporter — the blackbox prober for Prometheus. she probes things from the outside, like a nosy bestie checking if your website is actually up 💅

---

✨ SYNOPSIS ✨

prometheus-blackbox-exporter [<flags>]

that's it. that's the whole vibe check. just the binary and some flags, no positional args, no drama 🌸

---

✨ DESCRIPTION ✨

literally nothing here in the original, bestie, the DESCRIPTION section is empty, so there's nothing for me to tell you, periodt. the real tea is all down in OPTIONS 👇

---

✨ OPTIONS ✨

• -h, --help — shows you context-sensitive help 🥺 (and if that's not enough, there's also --help-long and --help-man waiting for you, hungry for attention).
• --config.file — the blackbox exporter configuration file. the whole personality of your setup lives here, no cap 📁
• --timeout-offset=0.5 — the offset, in seconds, that gets subtracted from the timeout. default is 0.5 ⏱️
• --config.check — if this is true, it validates the config file and then exits. like a quick vibe check on your config before the real thing, and then she's out 🚪
• --log.prober — the log level from probe requests. one of: [debug, info, warn, error] 📝
• --history.limit=100 — the maximum amount of items to keep in the history. default is 100, so don't come crying when your 101st probe gets ghosted 💀
• --web.external-url=<url> — the URL under which the blackbox exporter is externally reachable (for example, if the blackbox exporter is served via a reverse proxy, iykyk). it's used for generating relative and absolute links back to the blackbox exporter itself. if the URL has a path portion, it will be used to prefix all HTTP endpoints served by the blackbox exporter. if you omit it, the relevant URL components get derived automatically, no effort required ✨
• --web.route-prefix=<path> — prefix for the internal routes of web endpoints. defaults to the path of --web.external-url 🌈
• --web.systemd-socket — use systemd socket activation listeners instead of port listeners. Linux only, bestie, don't try this on your Mac 🙈
• --web.listen-address=:9115 — addresses on which to expose metrics and the web interface. repeatable for multiple addresses. examples: `:9100` or `[::1]:9100` for http, `vsock://:9100` for vsock 👑
• --web.config.file — path to a configuration file that can enable TLS or authentication. see: https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md 🔐
• --log.level=info — only log messages with the given severity or above. one of: [debug, info, warn, error]. default is info ⭐
• --log.format=logfmt — output format of log messages. one of: [logfmt, json]. default is logfmt 🎀
• --version — show the application version. cute for bragging rights 💅

⚠️ heads up: --web.systemd-socket is Linux only, and --config.check dips out immediately after validating, so don't expect it to keep running fr fr.

---

🦋 SEE ALSO 🦋

the original page had no SEE ALSO section, so there's nothing to reference here — go forth and probe, bestie. 🌸

---

and that's the whole page!! 💖 this was prometheus-blackbox-exporter, version 0..., dated August 2025, part of the Prometheus manual, and this rewrite is brought to you with so much love. now go check on your endpoints, they miss you 🫶✨🧚