_group_range = 0 2147483647 to allow any user the ability Your distribution may configure _group_range by default in.Linux: either a user with a group within _group_range, theĬAP_NET_RAW capability or the root user is required.Windows: Administrator privileges are required.The ICMP probe requires elevated privileges to function: Target_label: vhost # and store it in 'vhost' label Target_label: _param_hostname # Make domain name become 'Host' header for probe requests This can be especially useful with dns_sd_config: scrape_configs: HTTP probes can accept an additional hostname parameter that will set Host header and TLS SNI.
Replacement: 127.0.0.1:9115 # The blackbox exporter's real hostname:port. # Target to probe with http on port 8080. The blackbox exporter needs to be passed the target as a parameter, this can be To read the guide Understanding and using the multi-target exporter pattern Prometheus Configurationīlackbox exporter implements the multi-target exporter pattern, so we advice If neither is specified, it defaults to 120 seconds. This can be further limited by the timeout in the Blackbox exporter config file. The timeout of each probe is automatically determined from the scrape_timeout in the Prometheus config, slightly reduced to allow for network delays. HTTP, HTTPS (via the http prober), DNS, TCP socket, ICMP and gRPC (see permissions section) are currently supported.Īdditional modules can be defined to meet your needs. To specify which configuration file to load, use the -config.file flag.Īdditionally, an example configuration is also available. To view all available command-line flags, run. If the new configuration is not well-formed, the changes will not be applied.Ī configuration reload is triggered by sending a SIGHUP to the Blackbox exporter process or by sending a HTTP POST request to the /-/reload endpoint. īlackbox exporter is configured via a configuration file and command-line flags (such as what configuration file to load, what port to listen on, and the logging format and level).īlackbox exporter can reload its configuration file at runtime.
Prometheus blackbox exporter example software#
Building the software Local Build makeĪfter a successful local build: docker build -t blackbox_exporter. metrics for scraping, /probe for probing, and the web UI. Note that the TLS and basic authentication settings affect all HTTP endpoints: To use TLS and/or basic authentication, you need to pass a configuration file The Blackbox Exporter supports TLS and basic authentication. Will return debug information for that probe. Visiting will return metrics for a HTTP probe against. Quay.io/prometheus/blackbox-exporter:latest -config.file=/config/blackbox.yml Note: You may want to enable ipv6 in your docker configuration docker run -rm \ Running this software From binariesĭownload the most suitable binary from the releases tab Unsure where to use whitebox and where to use blackbox monitoring? Contact us.The blackbox exporter allows blackbox probing of endpoints over This makes it easy to alert on soon to expire SSL certs. One nifty feature is that if a module ends up using TLS/SSL, the exporter will automatically expose when the cert chain will expire. The config in blackbox.yml can be expanded to add additional modules that cater to your needs. The blackbox exporter includes some useful modules out of the box, such as HTTP, TCP, POP3S, IRC and ICMP. While this example only checks the local machine, you could get a list of targets from any service discovery method - for example EC2 or Consul instead of just static_configs. You can now see the result of probe_success in the expression browser! # Actually talk to the blackbox exporter though # Ensure port is 22, pass as URL parameter Now let's get Prometheus to use this: wget If you visit :9115/probe?target=127.0.0.1:22&module=ssh_banner it'll test to see if SSH on the local machine is responding. As an example let's check for the SSH returning the banner.įirst we run the blackbox exporter: wget
For this Prometheus offers the blackbox_exporter . Sometimes though you want to check how things look from the outside, which is to say blackbox monitoring. Prometheus is a whitebox monitoring system, ingesting metrics exposed from inside applications.
0 kommentar(er)
