Blackbox Exporter 配置详解：全方位监控探测指南

Blackbox Exporter 配置详解：全方位监控探测指南

blackbox_exporter Blackbox prober exporter 项目地址: https://gitcode.com/gh_mirrors/bl/blackbox_exporter

概述

Blackbox Exporter 是 Prometheus 生态系统中用于黑盒监控的重要组件，它通过主动探测的方式监控外部系统的可用性和性能。本文将深入解析其配置文件的结构与各项参数，帮助您构建高效的监控探测方案。

配置文件基础

Blackbox Exporter 使用 YAML 格式的配置文件，主要包含多个探测模块(modules)的定义。每个模块代表一种特定类型的探测配置。

基本结构

modules:
  http_2xx_check:  # 模块名称
    prober: http   # 探测类型
    timeout: 10s   # 超时时间
    http:          # HTTP探测专用配置
      valid_status_codes: [200, 301]
  tcp_ssh_check:
    prober: tcp
    tcp:
      query_response:
        - expect: "^SSH-"

模块通用配置

所有探测模块都支持以下通用参数：

• prober: 必填项，指定探测协议类型，可选值：http、tcp、dns、icmp、grpc
• timeout: 探测超时时间，默认为全局超时设置
• 协议专用配置：只能指定一种，与prober类型对应

HTTP探测配置详解

HTTP 探测是最常用的探测类型，用于监控 Web 服务的可用性。

核心参数

• valid_status_codes: 可接受的状态码列表，默认接受2xx状态码
• method: HTTP 方法，默认为 GET
• headers: 自定义请求头
• follow_redirects: 是否跟随重定向，默认为 true

高级功能

响应体验证：

fail_if_body_matches_regexp:
  - "Error.*occurred"
fail_if_body_not_matches_regexp:
  - "Welcome to our site"

JSON 响应验证： 支持使用 CEL (Common Expression Language) 表达式验证 JSON 响应

TLS 配置：

tls_config:
  insecure_skip_verify: false
  ca_file: "/path/to/ca.crt"

认证支持：

• Basic Auth
• OAuth 2.0
• Bearer Token

TCP探测配置

TCP 探测用于检查端口可用性和协议交互。

典型配置

tcp:
  query_response:
    - send: "HELO\n"
      expect: "^220"
      starttls: true
  tls: true
  tls_config:
    server_name: "smtp.example.com"

关键特性

• 支持多轮交互对话
• 支持 STARTTLS
• 可验证响应内容

DNS探测配置

DNS 探测用于验证 DNS 解析能力和记录正确性。

配置示例

dns:
  query_name: "example.com"
  query_type: "A"
  valid_rcodes: ["NOERROR"]
  validate_answer_rrs:
    fail_if_not_matches_regexp:
      - "\\d+\\.\\d+\\.\\d+\\.\\d+"

高级功能

• 支持 UDP/TCP 传输
• 支持 DNS over TLS
• 可验证各类型记录(Answer, Authority, Additional)

ICMP探测配置

ICMP 探测用于基本的网络连通性测试。

配置要点

icmp:
  preferred_ip_protocol: "ip4"
  dont_fragment: true
  payload_size: 56
  ttl: 64

gRPC探测配置

gRPC 探测用于监控 gRPC 服务健康状态。

grpc:
  service: "grpc.health.v1.Health"
  tls: true

TLS通用配置

所有支持 TLS 的探测类型共享相同的 TLS 配置结构。

安全最佳实践

tls_config:
  min_version: "TLS12"
  max_version: "TLS13"
  server_name: "example.com"
  ca_file: "/path/to/ca.crt"

最佳实践建议

1. 合理设置超时：根据网络条件和探测类型设置适当的超时时间
2. 验证响应内容：不仅检查服务是否响应，还要验证响应内容是否正确
3. 安全配置：生产环境应始终启用 TLS 验证
4. 模块分类：为不同类型的检查创建专用模块
5. 性能考量：避免过于频繁的探测，特别是资源密集型检查

通过合理配置 Blackbox Exporter，您可以构建全面的外部监控系统，及时发现服务中断、性能下降等问题，为系统可靠性提供有力保障。

blackbox_exporter Blackbox prober exporter 项目地址: https://gitcode.com/gh_mirrors/bl/blackbox_exporter