astronomerinc/ap-blackbox-exporter

Astronomer平台Blackbox Exporter镜像

镜像概述

Astronomer平台Blackbox Exporter镜像是专为Astronomer数据编排平台设计的监控组件，基于Prometheus Blackbox Exporter构建。该镜像提供网络端点探测能力，用于监控各类网络服务的健康状态、可用性及性能指标，是Astronomer平台可观测性体系的重要组成部分。

核心功能与特性

• 多协议监控支持：兼容HTTP/HTTPS、DNS、TCP、ICMP（ping）等多种网络协议的端点探测
• 全面健康检查：支持状态码验证、证书有效性检测、响应内容匹配、连接超时判断等健康检查机制
• 性能指标采集：收集响应时间、DNS解析延迟、TCP握手耗时、SSL握手耗时等关键性能指标
• 灵活探测规则：通过配置文件自定义探测目标、超时时间、重试策略等探测参数
• Prometheus原生集成：暴露Prometheus兼容的指标接口，支持与Prometheus、Grafana等监控工具无缝对接

使用场景与适用范围

• Astronomer平台组件监控：监控平台内部核心组件（如Airflow Webserver、元数据库、消息队列）的可用性与健康状态
• 外部依赖服务监控：检测Astronomer平台依赖的外部服务（如AWS S3、***、第三方API）的可达性
• 网络端点性能跟踪：持续跟踪关键业务端点的响应性能，识别潜在瓶颈
• 合规性监控：监控SSL证书过期时间、HTTP安全头配置等合规性指标

使用方法

基本运行命令

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

Docker Compose配置示例

yaml
version: '3.8'
services:
  blackbox-exporter:
    image: docker.xuanyuan.run/astronomer/blackbox-exporter:latest
    container_name: astronomer-blackbox-exporter
    restart: always
    ports:
      - "9115:9115"
    volumes:
      - ./blackbox-config.yml:/etc/blackbox_exporter/config.yml
    environment:
      - LOG_LEVEL=info
    command:
      - --config.file=/etc/blackbox_exporter/config.yml
      - --web.listen-address=:9115

配置参数说明

配置文件示例

典型的blackbox-config.yml配置文件结构（详细配置规则参见https://prometheus.io/docs/guides/blackbox-exporter/%EF%BC%89%EF%BC%9A

yaml
modules:
  http_2xx:
    prober: http
    timeout: 5s
    http:
      valid_status_codes: [200, 201, 204]
      method: GET
      no_follow_redirects: false
      tls_config:
        insecure_skip_verify: false
  tcp_connect:
    prober: tcp
    timeout: 5s
    tcp:
      preferred_ip_protocol: "ip4"
  icmp_ping:
    prober: icmp
    timeout: 5s
    icmp:
      preferred_ip_protocol: "ip4"

注意事项

• 运行ICMP协议探测时，容器需具备CAP_NET_RAW权限（添加--cap-add=NET_RAW参数）
• 配置文件需提前创建并通过卷挂载至容器内指定路径
• 确保容器网络可访问目标探测端点，必要时配置网络策略或端口映射
• 高并发场景下建议调整--web.max-requests参数限制并发请求数量