dwpdigital/blackbox-exporter

blackbox exporter 镜像文档

镜像概述

blackbox exporter是Prometheus生态系统中的核心组件，专注于对网络端点进行黑盒探测。它通过模拟真实用户请求，监控HTTP、HTTPS、DNS、TCP和ICMP等协议的端点可用性、响应时间、状态码等关键指标，为服务健康状态监控提供数据支持。

核心功能和特性

• 多协议支持：全面支持HTTP/HTTPS、DNS、TCP和ICMP协议的端点探测
• 丰富的探测指标：可采集状态码、响应时间、证书有效期（HTTPS）、DNS解析时间、TCP连接时间、ICMP ping响应时间等指标
• 自定义探测规则：通过配置文件定义不同探测场景的参数（超时时间、重试次数、请求头、预期响应等）
• Prometheus集成：原生支持Prometheus指标抓取，可直接接入Prometheus监控系统
• 轻量级部署：容器化设计，资源占用低，易于集成到现有监控架构

使用场景和适用范围

典型使用场景

• 网站/API可用性监控（HTTP/HTTPS状态码、响应时间）
• 微服务健康检查（TCP端口连通性、响应时间）
• DNS服务监控（解析时间、记录类型验证）
• 网络设备监控（ICMP ping测试、连通性验证）
• SSL证书过期预警（HTTPS证书有效期监控）

适用范围

• DevOps工程师监控服务可用性
• SRE团队构建网络监控体系
• 系统管理员监控基础设施连通性
• 云服务/微服务架构的健康状态监控

使用方法和配置说明

Docker部署示例

基本Docker Run命令

bash
docker run -d \
  --name blackbox-exporter \
  -p 9115:9115 \
  -v /path/to/blackbox.yml:/etc/blackbox_exporter/config.yml \
  prom/blackbox-exporter

Docker Compose配置

yaml
version: '3'
services:
  blackbox-exporter:
    image: prom/blackbox-exporter
    container_name: blackbox-exporter
    restart: always
    ports:
      - "9115:9115"
    volumes:
      - ./blackbox.yml:/etc/blackbox_exporter/config.yml
    command:
      - --config.file=/etc/blackbox_exporter/config.yml

配置文件说明

blackbox exporter通过配置文件（默认路径/etc/blackbox_exporter/config.yml）定义探测规则，核心结构为modules，每个module对应一种探测配置：

yaml
modules:
  http_2xx:  # HTTP/HTTPS探测模块，验证状态码是否为2xx
    prober: http
    timeout: 5s
    http:
      valid_status_codes: [200, 201, 204]  # 允许的状态码
      method: GET  # 请求方法
      headers:  # 请求头
        Host: example.com
        User-Agent: blackbox-exporter
      no_follow_redirects: false  # 是否跟随重定向

  icmp_ping:  # ICMP ping探测模块
    prober: icmp
    timeout: 5s
    icmp:
      preferred_ip_protocol: "ip4"  # 优先使用IPv4
      ttl: 64  # TTL值

  dns_query:  # DNS解析探测模块
    prober: dns
    timeout: 5s
    dns:
      query_name: "example.com"  # 查询域名
      query_type: "A"  # 记录类型
      valid_rcodes: ["NOERROR"]  # 允许的响应码

常用配置参数

Prometheus集成配置

在Prometheus配置文件中添加如下job，用于抓取blackbox exporter的探测指标：

yaml
scrape_configs:
  - job_name: 'blackbox'
    metrics_path: /probe
    params:
      module: [http_2xx]  # 使用的探测模块
    static_configs:
      - targets:
        - https://example.com  # 探测目标
        - http://localhost:8080
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: blackbox-exporter:9115  # blackbox exporter地址

指标访问

启动后可通过http://<ip>:9115/probe?target=<目标>&module=<模块>访问特定探测指标，例如：

• http://localhost:9115/probe?target=example.com&module=http_2xx：探测example.com的HTTP状态
• http://localhost:9115/probe?target=8.8.8.8&module=icmp_ping：ICMP ping测试8.8.8.8