{"id":13461545,"url":"https://github.com/prometheus/blackbox_exporter","last_synced_at":"2025-09-09T21:24:03.490Z","repository":{"id":37431775,"uuid":"41964498","full_name":"prometheus/blackbox_exporter","owner":"prometheus","description":"Blackbox prober exporter","archived":false,"fork":false,"pushed_at":"2025-05-04T17:48:42.000Z","size":7313,"stargazers_count":4999,"open_issues_count":172,"forks_count":1101,"subscribers_count":63,"default_branch":"master","last_synced_at":"2025-05-05T14:53:54.726Z","etag":null,"topics":["blackbox-exporter","icmp","prometheus","prometheus-exporter"],"latest_commit_sha":null,"homepage":"https://prometheus.io","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prometheus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-09-05T14:45:00.000Z","updated_at":"2025-05-04T16:44:40.000Z","dependencies_parsed_at":"2023-02-16T17:20:25.611Z","dependency_job_id":"933e99ca-b10f-41b3-aba4-f03692a14807","html_url":"https://github.com/prometheus/blackbox_exporter","commit_stats":{"total_commits":447,"total_committers":129,"mean_commits":"3.4651162790697674","dds":0.8523489932885906,"last_synced_commit":"909dd33dac4e76742c34c21af02e762ff6412b11"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Fblackbox_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Fblackbox_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Fblackbox_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Fblackbox_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prometheus","download_url":"https://codeload.github.com/prometheus/blackbox_exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253776959,"owners_count":21962602,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blackbox-exporter","icmp","prometheus","prometheus-exporter"],"created_at":"2024-07-31T11:00:43.078Z","updated_at":"2025-09-09T21:24:03.468Z","avatar_url":"https://github.com/prometheus.png","language":"Go","funding_links":[],"categories":["Go","Observability","Metrics","others","Endpoint validation","Prometheus-Exporter","Exporters"],"sub_categories":["Build systems","Miscellaneous"],"readme":"# Blackbox exporter\n\n[![CircleCI](https://circleci.com/gh/prometheus/blackbox_exporter/tree/master.svg?style=shield)][circleci]\n[![Docker Repository on Quay](https://quay.io/repository/prometheus/blackbox-exporter/status)][quay]\n[![Docker Pulls](https://img.shields.io/docker/pulls/prom/blackbox-exporter.svg?maxAge=604800)][hub]\n\nThe blackbox exporter allows blackbox probing of endpoints over\nHTTP, HTTPS, DNS, TCP, ICMP and gRPC.\n\n## Running this software\n\n### From binaries\n\nDownload the most suitable binary from [the releases tab](https://github.com/prometheus/blackbox_exporter/releases)\n\nThen:\n\n    ./blackbox_exporter \u003cflags\u003e\n\n\n### Using the docker image\n\n*Note: You may want to [enable ipv6 in your docker configuration](https://docs.docker.com/v17.09/engine/userguide/networking/default_network/ipv6/)*\n\n    docker run --rm \\\n      -p 9115/tcp \\\n      --name blackbox_exporter \\\n      -v $(pwd):/config \\\n      quay.io/prometheus/blackbox-exporter:latest --config.file=/config/blackbox.yml\n\n### Checking the results\n\nVisiting [http://localhost:9115/probe?target=google.com\u0026module=http_2xx](http://localhost:9115/probe?target=google.com\u0026module=http_2xx)\nwill return metrics for a HTTP probe against google.com. The `probe_success`\nmetric indicates if the probe succeeded. Adding a `debug=true` parameter\nwill return debug information for that probe.\n\nMetrics concerning the operation of the exporter itself are available at the\nendpoint \u003chttp://localhost:9115/metrics\u003e.\n\n### TLS and basic authentication\n\nThe Blackbox Exporter supports TLS and basic authentication. This enables better\ncontrol of the various HTTP endpoints.\n\nTo use TLS and/or basic authentication, you need to pass a configuration file\nusing the `--web.config.file` parameter. The format of the file is described\n[in the exporter-toolkit repository](https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md).\n\nNote that the TLS and basic authentication settings affect all HTTP endpoints:\n/metrics for scraping, /probe for probing, and the web UI.\n\n### Controlling log level for probe logs\n\nIt is possible to control the level at which probe logs related to a scrape are output as.\n\nProbe logs default to `debug` level, and can be controlled by the `--log.prober` flag.\nThis means that probe scrape logs will not be output unless the level configured for the probe logger via `--log.prober` is \u003e= the level configured for the blackbox_exporter via `--log.level`.\n\nSample output demonstrating the use and effect of these flags can be seen below.\n\n\u003e _Note_\n\u003e\n\u003e All log samples below used the following basic `blackbox.yml` configuration file and contain the probe logs of a single scrape generated by `curl`\n\n```bash\n# blackbox.yml\nmodules:\n  http_2xx:\n    prober: http\n\n# generate probe\ncurl \"http://localhost:9115/probe?target=prometheus.io\u0026module=http_2xx\"\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eExample output with `--log.level=info` and `--log.prober=debug` (default)\u003c/summary\u003e\n\n```bash\n./blackbox_exporter --config.file ./blackbox.yml --log.level=info --log.prober=debug\ntime=2025-05-21T04:10:54.131Z level=INFO source=main.go:88 msg=\"Starting blackbox_exporter\" version=\"(version=0.26.0, branch=fix/scrape-logger-spam, revision=7df3031feecba82f1a534336979b4e5920f79b72)\"\ntime=2025-05-21T04:10:54.131Z level=INFO source=main.go:89 msg=\"(go=go1.24.1, platform=linux/amd64, user=tjhop@contraband, date=20250521-04:00:25, tags=unknown)\"\ntime=2025-05-21T04:10:54.132Z level=INFO source=main.go:101 msg=\"Loaded config file\"\ntime=2025-05-21T04:10:54.133Z level=INFO source=tls_config.go:347 msg=\"Listening on\" address=[::]:9115\ntime=2025-05-21T04:10:54.133Z level=INFO source=tls_config.go:350 msg=\"TLS is disabled.\" http2=false address=[::]:9115\n^Ctime=2025-05-21T04:11:03.619Z level=INFO source=main.go:283 msg=\"Received SIGTERM, exiting gracefully...\"\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eExample output with `--log.level=info` and `--log.prober=info`\u003c/summary\u003e\n\n```bash\n./blackbox_exporter --config.file ./blackbox.yml --log.level=info --log.prober=info\ntime=2025-05-21T04:12:09.884Z level=INFO source=main.go:88 msg=\"Starting blackbox_exporter\" version=\"(version=0.26.0, branch=fix/scrape-logger-spam, revision=7df3031feecba82f1a534336979b4e5920f79b72)\"\ntime=2025-05-21T04:12:09.884Z level=INFO source=main.go:89 msg=\"(go=go1.24.1, platform=linux/amd64, user=tjhop@contraband, date=20250521-04:00:25, tags=unknown)\"\ntime=2025-05-21T04:12:09.884Z level=INFO source=main.go:101 msg=\"Loaded config file\"\ntime=2025-05-21T04:12:09.885Z level=INFO source=tls_config.go:347 msg=\"Listening on\" address=[::]:9115\ntime=2025-05-21T04:12:09.885Z level=INFO source=tls_config.go:350 msg=\"TLS is disabled.\" http2=false address=[::]:9115\ntime=2025-05-21T04:12:13.827Z level=INFO source=handler.go:194 msg=\"Beginning probe\" module=http_2xx target=prometheus.io probe=http timeout_seconds=119.5\ntime=2025-05-21T04:12:13.827Z level=INFO source=handler.go:194 msg=\"Resolving target address\" module=http_2xx target=prometheus.io target=prometheus.io ip_protocol=ip4\ntime=2025-05-21T04:12:13.829Z level=INFO source=handler.go:194 msg=\"Resolved target address\" module=http_2xx target=prometheus.io target=prometheus.io ip=172.67.201.240\ntime=2025-05-21T04:12:13.829Z level=INFO source=handler.go:194 msg=\"Making HTTP request\" module=http_2xx target=prometheus.io url=http://172.67.201.240 host=prometheus.io\ntime=2025-05-21T04:12:13.860Z level=INFO source=handler.go:194 msg=\"Received redirect\" module=http_2xx target=prometheus.io location=https://prometheus.io/\ntime=2025-05-21T04:12:13.860Z level=INFO source=handler.go:194 msg=\"Making HTTP request\" module=http_2xx target=prometheus.io url=https://prometheus.io/ host=\"\"\ntime=2025-05-21T04:12:13.860Z level=INFO source=handler.go:194 msg=\"Address does not match first address, not sending TLS ServerName\" module=http_2xx target=prometheus.io first=172.67.201.240 address=prometheus.io\ntime=2025-05-21T04:12:13.974Z level=INFO source=handler.go:194 msg=\"Received HTTP response\" module=http_2xx target=prometheus.io status_code=200\ntime=2025-05-21T04:12:13.974Z level=INFO source=handler.go:194 msg=\"Response timings for roundtrip\" module=http_2xx target=prometheus.io roundtrip=0 start=2025-05-21T00:12:13.829-04:00 dnsDone=2025-05-21T00:12:13.829-04:00 connectDone=2025-05-21T00:12:13.839-04:00 gotConn=2025-05-21T00:12:13.839-04:00 responseStart=2025-05-21T00:12:13.860-04:00 tlsStart=0001-01-01T00:00:00.000Z tlsDone=0001-01-01T00:00:00.000Z end=0001-01-01T00:00:00.000Z\ntime=2025-05-21T04:12:13.974Z level=INFO source=handler.go:194 msg=\"Response timings for roundtrip\" module=http_2xx target=prometheus.io roundtrip=1 start=2025-05-21T00:12:13.860-04:00 dnsDone=2025-05-21T00:12:13.861-04:00 connectDone=2025-05-21T00:12:13.869-04:00 gotConn=2025-05-21T00:12:13.925-04:00 responseStart=2025-05-21T00:12:13.974-04:00 tlsStart=2025-05-21T00:12:13.869-04:00 tlsDone=2025-05-21T00:12:13.925-04:00 end=2025-05-21T00:12:13.974-04:00\ntime=2025-05-21T04:12:13.974Z level=INFO source=handler.go:194 msg=\"Probe succeeded\" module=http_2xx target=prometheus.io duration_seconds=0.14708839\n^Ctime=2025-05-21T04:12:17.818Z level=INFO source=main.go:283 msg=\"Received SIGTERM, exiting gracefully...\"\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eExample output with `--log.level=debug` and `--log.prober=info`\u003c/summary\u003e\n\n```bash\n./blackbox_exporter --config.file ./blackbox.yml --log.level=debug --log.prober=info \ntime=2025-05-21T04:13:18.497Z level=INFO source=main.go:88 msg=\"Starting blackbox_exporter\" version=\"(version=0.26.0, branch=fix/scrape-logger-spam, revision=7df3031feecba82f1a534336979b4e5920f79b72)\"\ntime=2025-05-21T04:13:18.497Z level=INFO source=main.go:89 msg=\"(go=go1.24.1, platform=linux/amd64, user=tjhop@contraband, date=20250521-04:00:25, tags=unknown)\"\ntime=2025-05-21T04:13:18.497Z level=INFO source=main.go:101 msg=\"Loaded config file\"\ntime=2025-05-21T04:13:18.498Z level=DEBUG source=main.go:116 msg=http://contraband:9115\ntime=2025-05-21T04:13:18.498Z level=DEBUG source=main.go:130 msg=/\ntime=2025-05-21T04:13:18.498Z level=INFO source=tls_config.go:347 msg=\"Listening on\" address=[::]:9115\ntime=2025-05-21T04:13:18.498Z level=INFO source=tls_config.go:350 msg=\"TLS is disabled.\" http2=false address=[::]:9115\ntime=2025-05-21T04:13:23.169Z level=INFO source=handler.go:194 msg=\"Beginning probe\" module=http_2xx target=prometheus.io probe=http timeout_seconds=119.5\ntime=2025-05-21T04:13:23.169Z level=INFO source=handler.go:194 msg=\"Resolving target address\" module=http_2xx target=prometheus.io target=prometheus.io ip_protocol=ip4\ntime=2025-05-21T04:13:23.170Z level=INFO source=handler.go:194 msg=\"Resolved target address\" module=http_2xx target=prometheus.io target=prometheus.io ip=104.21.60.220\ntime=2025-05-21T04:13:23.170Z level=INFO source=handler.go:194 msg=\"Making HTTP request\" module=http_2xx target=prometheus.io url=http://104.21.60.220 host=prometheus.io\ntime=2025-05-21T04:13:23.202Z level=INFO source=handler.go:194 msg=\"Received redirect\" module=http_2xx target=prometheus.io location=https://prometheus.io/\ntime=2025-05-21T04:13:23.202Z level=INFO source=handler.go:194 msg=\"Making HTTP request\" module=http_2xx target=prometheus.io url=https://prometheus.io/ host=\"\"\ntime=2025-05-21T04:13:23.202Z level=INFO source=handler.go:194 msg=\"Address does not match first address, not sending TLS ServerName\" module=http_2xx target=prometheus.io first=104.21.60.220 address=prometheus.io\ntime=2025-05-21T04:13:23.316Z level=INFO source=handler.go:194 msg=\"Received HTTP response\" module=http_2xx target=prometheus.io status_code=200\ntime=2025-05-21T04:13:23.319Z level=INFO source=handler.go:194 msg=\"Response timings for roundtrip\" module=http_2xx target=prometheus.io roundtrip=0 start=2025-05-21T00:13:23.171-04:00 dnsDone=2025-05-21T00:13:23.171-04:00 connectDone=2025-05-21T00:13:23.181-04:00 gotConn=2025-05-21T00:13:23.181-04:00 responseStart=2025-05-21T00:13:23.201-04:00 tlsStart=0001-01-01T00:00:00.000Z tlsDone=0001-01-01T00:00:00.000Z end=0001-01-01T00:00:00.000Z\ntime=2025-05-21T04:13:23.319Z level=INFO source=handler.go:194 msg=\"Response timings for roundtrip\" module=http_2xx target=prometheus.io roundtrip=1 start=2025-05-21T00:13:23.202-04:00 dnsDone=2025-05-21T00:13:23.203-04:00 connectDone=2025-05-21T00:13:23.212-04:00 gotConn=2025-05-21T00:13:23.268-04:00 responseStart=2025-05-21T00:13:23.316-04:00 tlsStart=2025-05-21T00:13:23.212-04:00 tlsDone=2025-05-21T00:13:23.268-04:00 end=2025-05-21T00:13:23.319-04:00\ntime=2025-05-21T04:13:23.319Z level=INFO source=handler.go:194 msg=\"Probe succeeded\" module=http_2xx target=prometheus.io duration_seconds=0.150580389\n^Ctime=2025-05-21T04:13:27.945Z level=INFO source=main.go:283 msg=\"Received SIGTERM, exiting gracefully...\"\n```\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\u003csummary\u003eExample output with `--log.level=debug` and `--log.prober=debug`\u003c/summary\u003e\n\n```bash\n./blackbox_exporter --config.file ./blackbox.yml --log.level=debug --log.prober=debug\ntime=2025-05-21T04:14:55.621Z level=INFO source=main.go:88 msg=\"Starting blackbox_exporter\" version=\"(version=0.26.0, branch=fix/scrape-logger-spam, revision=7df3031feecba82f1a534336979b4e5920f79b72)\"\ntime=2025-05-21T04:14:55.621Z level=INFO source=main.go:89 msg=\"(go=go1.24.1, platform=linux/amd64, user=tjhop@contraband, date=20250521-04:00:25, tags=unknown)\"\ntime=2025-05-21T04:14:55.622Z level=INFO source=main.go:101 msg=\"Loaded config file\"\ntime=2025-05-21T04:14:55.622Z level=DEBUG source=main.go:116 msg=http://contraband:9115\ntime=2025-05-21T04:14:55.622Z level=DEBUG source=main.go:130 msg=/\ntime=2025-05-21T04:14:55.623Z level=INFO source=tls_config.go:347 msg=\"Listening on\" address=[::]:9115\ntime=2025-05-21T04:14:55.623Z level=INFO source=tls_config.go:350 msg=\"TLS is disabled.\" http2=false address=[::]:9115\ntime=2025-05-21T04:15:03.048Z level=DEBUG source=handler.go:194 msg=\"Beginning probe\" module=http_2xx target=prometheus.io probe=http timeout_seconds=119.5\ntime=2025-05-21T04:15:03.049Z level=DEBUG source=handler.go:194 msg=\"Resolving target address\" module=http_2xx target=prometheus.io target=prometheus.io ip_protocol=ip4\ntime=2025-05-21T04:15:03.050Z level=DEBUG source=handler.go:194 msg=\"Resolved target address\" module=http_2xx target=prometheus.io target=prometheus.io ip=172.67.201.240\ntime=2025-05-21T04:15:03.050Z level=DEBUG source=handler.go:194 msg=\"Making HTTP request\" module=http_2xx target=prometheus.io url=http://172.67.201.240 host=prometheus.io\ntime=2025-05-21T04:15:03.089Z level=DEBUG source=handler.go:194 msg=\"Received redirect\" module=http_2xx target=prometheus.io location=https://prometheus.io/\ntime=2025-05-21T04:15:03.089Z level=DEBUG source=handler.go:194 msg=\"Making HTTP request\" module=http_2xx target=prometheus.io url=https://prometheus.io/ host=\"\"\ntime=2025-05-21T04:15:03.089Z level=DEBUG source=handler.go:194 msg=\"Address does not match first address, not sending TLS ServerName\" module=http_2xx target=prometheus.io first=172.67.201.240 address=prometheus.io\ntime=2025-05-21T04:15:03.211Z level=DEBUG source=handler.go:194 msg=\"Received HTTP response\" module=http_2xx target=prometheus.io status_code=200\ntime=2025-05-21T04:15:03.212Z level=DEBUG source=handler.go:194 msg=\"Response timings for roundtrip\" module=http_2xx target=prometheus.io roundtrip=0 start=2025-05-21T00:15:03.050-04:00 dnsDone=2025-05-21T00:15:03.050-04:00 connectDone=2025-05-21T00:15:03.061-04:00 gotConn=2025-05-21T00:15:03.061-04:00 responseStart=2025-05-21T00:15:03.089-04:00 tlsStart=0001-01-01T00:00:00.000Z tlsDone=0001-01-01T00:00:00.000Z end=0001-01-01T00:00:00.000Z\ntime=2025-05-21T04:15:03.212Z level=DEBUG source=handler.go:194 msg=\"Response timings for roundtrip\" module=http_2xx target=prometheus.io roundtrip=1 start=2025-05-21T00:15:03.089-04:00 dnsDone=2025-05-21T00:15:03.090-04:00 connectDone=2025-05-21T00:15:03.102-04:00 gotConn=2025-05-21T00:15:03.163-04:00 responseStart=2025-05-21T00:15:03.211-04:00 tlsStart=2025-05-21T00:15:03.102-04:00 tlsDone=2025-05-21T00:15:03.163-04:00 end=2025-05-21T00:15:03.212-04:00\ntime=2025-05-21T04:15:03.212Z level=DEBUG source=handler.go:194 msg=\"Probe succeeded\" module=http_2xx target=prometheus.io duration_seconds=0.163695815\n^Ctime=2025-05-21T04:15:07.862Z level=INFO source=main.go:283 msg=\"Received SIGTERM, exiting gracefully...\"\n```\n\u003c/details\u003e\n\n## Building the software\n\n### Local Build\n\n    make\n\n\n### Building with Docker\n\nAfter a successful local build:\n\n    docker build -t blackbox_exporter .\n\n## [Configuration](CONFIGURATION.md)\n\nBlackbox exporter is configured via a [configuration file](CONFIGURATION.md) and command-line flags (such as what configuration file to load, what port to listen on, and the logging format and level).\n\nBlackbox exporter can reload its configuration file at runtime. If the new configuration is not well-formed, the changes will not be applied.\nA configuration reload is triggered by sending a `SIGHUP` to the Blackbox exporter process or by sending a HTTP POST request to the `/-/reload` endpoint.\n\nTo view all available command-line flags, run `./blackbox_exporter -h`.\n\nTo specify which [configuration file](CONFIGURATION.md) to load, use the `--config.file` flag.\n\nAdditionally, an [example configuration](example.yml) is also available.\n\nHTTP, HTTPS (via the `http` prober), DNS, TCP socket, ICMP and gRPC (see permissions section) are currently supported.\nAdditional modules can be defined to meet your needs.\n\nThe timeout of each probe is automatically determined from the `scrape_timeout` in the [Prometheus config](https://prometheus.io/docs/operating/configuration/#configuration-file), slightly reduced to allow for network delays. \nThis can be further limited by the `timeout` in the Blackbox exporter config file. If neither is specified, it defaults to 120 seconds.\n\n## Prometheus Configuration\n\nBlackbox exporter implements the multi-target exporter pattern, so we advice\nto read the guide [Understanding and using the multi-target exporter pattern\n](https://prometheus.io/docs/guides/multi-target-exporter/) to get the general\nidea about the configuration.\n\nThe blackbox exporter needs to be passed the target as a parameter, this can be\ndone with relabelling.\n\nExample config:\n```yml\nscrape_configs:\n  - job_name: 'blackbox'\n    metrics_path: /probe\n    params:\n      module: [http_2xx]  # Look for a HTTP 200 response.\n    static_configs:\n      - targets:\n        - http://prometheus.io    # Target to probe with http.\n        - https://prometheus.io   # Target to probe with https.\n        - http://example.com:8080 # Target to probe with http on port 8080.\n    relabel_configs:\n      - source_labels: [__address__]\n        target_label: __param_target\n      - source_labels: [__param_target]\n        target_label: instance\n      - target_label: __address__\n        replacement: 127.0.0.1:9115  # The blackbox exporter's real hostname:port.\n  - job_name: 'blackbox_exporter'  # collect blackbox exporter's operational metrics.\n    static_configs:\n      - targets: ['127.0.0.1:9115']\n```\n\nHTTP probes can accept an additional `hostname` parameter that will set `Host` header and TLS SNI. This can be especially useful with `dns_sd_config`:\n```yaml\nscrape_configs:\n  - job_name: blackbox_all\n    metrics_path: /probe\n    params:\n      module: [ http_2xx ]  # Look for a HTTP 200 response.\n    dns_sd_configs:\n      - names:\n          - example.com\n          - prometheus.io\n        type: A\n        port: 443\n    relabel_configs:\n      - source_labels: [__address__]\n        target_label: __param_target\n        replacement: https://$1/  # Make probe URL be like https://1.2.3.4:443/\n      - source_labels: [__param_target]\n        target_label: instance\n      - target_label: __address__\n        replacement: 127.0.0.1:9115  # The blackbox exporter's real hostname:port.\n      - source_labels: [__meta_dns_name]\n        target_label: __param_hostname  # Make domain name become 'Host' header for probe requests\n      - source_labels: [__meta_dns_name]\n        target_label: vhost  # and store it in 'vhost' label\n```\n\n## Permissions\n\nThe ICMP probe requires elevated privileges to function:\n\n* *Windows*: Administrator privileges are required.\n* *Linux*: either a user with a group within `net.ipv4.ping_group_range`, the\n  `CAP_NET_RAW` capability or the root user is required.\n  * Your distribution may configure `net.ipv4.ping_group_range` by default in\n    `/etc/sysctl.conf` or similar. If not you can set\n    `net.ipv4.ping_group_range = 0  2147483647` to allow any user the ability\n    to use ping.\n  * Alternatively the capability can be set by executing `setcap cap_net_raw+ep\n    blackbox_exporter`\n* *BSD*: root user is required.\n* *OS X*: No additional privileges are needed.\n\n[circleci]: https://circleci.com/gh/prometheus/blackbox_exporter\n[hub]: https://hub.docker.com/r/prom/blackbox-exporter/\n[quay]: https://quay.io/repository/prometheus/blackbox-exporter\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprometheus%2Fblackbox_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprometheus%2Fblackbox_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprometheus%2Fblackbox_exporter/lists"}