首页/云/可观测性速查/blackbox 探测模块:http、tcp、icmp、dns
Prometheus 与采集64 条

blackbox 探测模块:http、tcp、icmp、dns

blackbox_exporter 内置多种探测类型:http(状态码与内容断言)、tcp 连接、icmp ping、dns 解析;模块在配置文件中预定义,抓取时用参数选择。

可观测性速查云更新于 2026-10-12

多模块配置示例

多模块配置示例
modules:
  http_2xx:
    prober: http
    timeout: 5s
  tcp_connect:
    prober: tcp
    timeout: 5s
  icmp_ping:
    prober: icmp
    timeout: 3s
  dns_udp:
    prober: dns
    dns:
      query_name: 'example.com'
      query_type: 'A'

探测结果关键指标

探测结果关键指标
probe_success{instance="https://example.com"}          # 1 成功 / 0 失败
probe_duration_seconds{}                                 # 探测总耗时
probe_http_status_code{}                                 # HTTP 场景状态码
icmp 探测常受权限限制:容器部署需要相应能力(如 NET_RAW),否则模块报权限错误。

易错点

  • probe_success 为 0 时看分段耗时指标(DNS 解析、连接、TLS)判断失败环节
  • relabel 忘传 module 参数会落到默认模块,探测类型与预期不符

数据来源与参考

  • blackbox_exporter 项目文档(github.com/prometheus/blackbox_exporter)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌