OS Manuals

/usr/bin/blackbox_exporter

Blackbox prober exporter

From prometheus-blackbox-exporter 0.29.1-r4 (enterprise-packages), captured 2026-11-08 by running blackbox_exporter --help (exit 0). permalink

usage: blackbox_exporter [<flags>]


Flags:
  -h, --[no-]help                Show context-sensitive help (also try --help-long and --help-man).
      --config.file="blackbox.yml"
                                 Blackbox exporter configuration file.
      --timeout-offset=0.5       Offset to subtract from timeout in seconds.
      --[no-]config.check        If true validate the config file and then exit.
      --log.prober="info"        Log level for probe request logs. One of: [debug, info, warn,
                                 error]. Please see the section `Controlling log level for probe
                                 logs` in the project README for more information.
      --[no-]config.enable-auto-reload
                                 When enabled, Blackbox exporter will automatically reload its
                                 configuration file at a specified interval. The interval is defined
                                 by the `--config.auto-reload-interval` flag, which defaults to
                                 `30s`
      --config.auto-reload-interval=30
                                 Specifies the interval in seconds for checking and automatically
                                 reloading configuration file upon detecting changes.
      --history.limit=100        The maximum amount of items to keep in the history.
      --web.external-url=<url>   The URL under which Blackbox exporter is externally reachable (for
                                 example, if Blackbox exporter is served via a reverse proxy).
                                 Used for generating relative and absolute links back to Blackbox
                                 exporter itself. If the URL has a path portion, it will be used to
                                 prefix all HTTP endpoints served by Blackbox exporter. If omitted,
                                 relevant URL components will be derived automatically.
      --web.route-prefix=<path>  Prefix for the internal routes of web endpoints. Defaults to path
                                 of --web.external-url.
      --[no-]web.systemd-socket  Use systemd socket activation listeners instead of port listeners
                                 (Linux only).
      --web.listen-address=:9115 ...
                                 Addresses on which to expose metrics and web interface. Repeatable
                                 for multiple addresses. 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
      --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]
      --[no-]version             Show application version.
Options (12)
OptionDescriptionSource
-hShow context-sensitive help (also try --help-long and --help-man).help
--config.file "blackbox.yml"Blackbox exporter configuration file.help
--timeout-offset 0.5Offset to subtract from timeout in seconds.help
--log.prober "info"Log level for probe request logs.help
--config.auto-reload-interval 30Specifies the interval in seconds for checking and automatically reloading configuration file upon detecting changes.help
--history.limit 100The maximum amount of items to keep in the history.help
--web.external-url urlThe URL under which Blackbox exporter is externally reachable (for example, if Blackbox exporter is served via a reverse proxy).help
--web.route-prefix pathPrefix for the internal routes of web endpoints.help
--web.listen-address :9115Addresses on which to expose metrics and web interface.help
--web.config.file ""Path to configuration file that can enable TLS or authentication.help
--log.level infoOnly log messages with the given severity or above.help
--log.format logfmtOutput format of log messages.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.