CloudProber Docker镜像文档

镜像概述和主要用途

CloudProber是一个轻量级的监控工具，旨在提供快速、可扩展的服务健康检查和性能监控能力。该Docker镜像封装了CloudProber应用程序，使其能够轻松部署在容器化环境中，用于监控各种网络服务、应用程序端点和基础设施组件的可用性与性能。

核心功能和特性

• 支持多种探测类型：HTTP、HTTPS、TCP、ICMP、DNS等
• 可配置的探测频率和超时时间
• 丰富的指标收集和导出功能，支持Prometheus格式
• 低资源消耗，适合大规模部署
• 灵活的配置系统，支持动态更新
• 支持自定义探测逻辑和指标处理
• 内置日志记录和事件通知机制

使用场景和适用范围

• 网站和API端点可用性监控
• 微服务架构中的服务健康检查
• 网络基础设施监控（服务器、路由器、交换机等）
• 云资源和服务的性能监控
• CI/CD管道中的部署验证
• Kubernetes集群内部服务监控
• 跨区域和跨数据中心的连接性测试

详细的使用方法和配置说明

基本使用方法

使用docker run运行

docker run -d --name cloudprober \
  -p 9313:9313 \
  -v /path/to/your/cloudprober.cfg:/etc/cloudprober.cfg \
  cloudprober/cloudprober

使用docker-compose运行

version: '3'
services:
  cloudprober:
    image: cloudprober/cloudprober
    container_name: cloudprober
    ports:
      - "9313:9313"
    volumes:
      - ./cloudprober.cfg:/etc/cloudprober.cfg
    restart: always
    networks:
      - monitoring

networks:
  monitoring:

配置说明

CloudProber使用一个主配置文件（通常为cloudprober.cfg）来定义探测任务和输出格式。以下是一个基本配置示例：

# 全局配置
global {
  project_id: "my-project"
  probe_timeout: 5s
  interval: 10s
}

# HTTP探测示例
probe {
  name: "web_server"
  type: HTTP
  targets {
    host_names: "example.com"
    host_names: "localhost:8080"
  }
  http_probe {
    path: "/health"
    port: 80
    use_https: false
    headers {
      name: "User-Agent"
      value: "cloudprober/1.0"
    }
  }
}

# TCP探测示例
probe {
  name: "ssh_server"
  type: TCP
  targets {
    host_names: "example.com"
  }
  tcp_probe {
    port: 22
  }
  interval: 30s  # 覆盖全局探测间隔
}

# 指标导出配置
prometheus_export {
  port: 9313
  path: "/metrics"
}

详细的使用方法和配置说明

镜像拉取

docker pull cloudprober/cloudprober

基本运行命令

docker run -d -p 9313:9313 --name cloudprober cloudprober/cloudprober

使用自定义配置文件

docker run -d -p 9313:9313 \
  -v /host/path/to/cloudprober.cfg:/etc/cloudprober.cfg \
  --name cloudprober cloudprober/cloudprober \
  --config_file /etc/cloudprober.cfg

Docker Compose部署

version: '3.8'

services:
  cloudprober:
    image: cloudprober/cloudprober
    container_name: cloudprober
    restart: always
    ports:
      - "9313:9313"
    volumes:
      - ./cloudprober.cfg:/etc/cloudprober.cfg:ro
    command: --config_file /etc/cloudprober.cfg
    networks:
      - monitoring
    environment:
      - CLOUDPROBER_LOG_LEVEL=info

networks:
  monitoring:
    driver: bridge

配置参数和环境变量

命令行参数

环境变量

访问指标

CloudProber默认在9313端口提供Prometheus格式的指标：

http://localhost:9313/metrics

参考链接

• 官方网站: cloudprober.org
• GitHub仓库: github.com/cloudprober/cloudprober
• 完整配置文档: cloudprober.org/docs/configuration