otel/opentelemetry-collector-opampsupervisor

OpenTelemetry OpAMP监管器镜像

镜像概述

本镜像是一个基于OpAMP（Open Agent Management Protocol）协议的监管工具，专为OpenTelemetry收集器设计。它通过标准OpAMP协议与收集器通信，提供配置管理、状态监控、日志收集等核心能力，帮助用户集中化管理OpenTelemetry收集器实例，简化监控基础设施的运维复杂度。

核心功能与特性

核心功能

• OpAMP协议支持：完整实现OpAMP v1协议规范，确保与OpenTelemetry收集器的标准通信
• 配置生命周期管理：支持远程推送、更新和回滚收集器配置（如管道规则、处理器设置）
• 实时状态监控：追踪收集器健康状态、性能指标（CPU/内存占用、数据吞吐量）及连接状态
• 日志与指标集中化：聚合收集器生成的运行日志和关键指标，支持导出至第三方监控系统
• 多实例监管：支持同时管理多个分布式部署的OpenTelemetry收集器实例

主要特性

• 轻量级架构：容器镜像体积小（<50MB），资源占用低，适合边缘环境部署
• 即插即用集成：无需复杂前置依赖，通过环境变量即可完成基础配置
• 版本兼容性：支持OpenTelemetry收集器v0.50+所有稳定版本
• 安全通信：内置TLS加密支持，可配置双向认证保障监管通道安全性
• 高可用性：支持主从模式部署，避免单点故障影响监管能力

使用场景与适用范围

典型使用场景

• 分布式系统监控：在微服务、云原生架构中，统一管理跨节点的收集器实例
• 大型企业环境：多团队、多区域部署场景下的收集器标准化管理
• 动态配置更新：需频繁调整收集器规则（如增加数据源、修改采样策略）的业务场景
• 边缘计算监管：在资源受限的边缘设备中，实现轻量化收集器的远程管理

适用范围

• OpenTelemetry收集器用户（v0.50及以上版本）
• 需要集中化管理工具的监控平台团队
• 对收集器配置变更频率高的业务场景
• 边缘计算、IoT等资源受限环境中的收集器运维

使用方法与配置说明

前置条件

• Docker Engine 20.10+ 或兼容容器运行时
• 已部署OpenTelemetry收集器（需启用OpAMP支持，配置示例见下文）
• 网络连通性：监管器需能访问收集器的OpAMP端口（默认4320）

基础启动命令

bash
docker run -d \
  --name otel-opamp-supervisor \
  -e OPAMP_SERVER_URL="http://opamp-central:4320" \  # OpAMP服务器地址（可选，内置默认服务器）
  -e COLLECTOR_ENDPOINTS="http://otel-collector-1:4317,http://otel-collector-2:4317" \  # 监管目标列表
  -e LOG_LEVEL="info" \  # 日志级别：debug/info/warn/error
  -p 4321:4321 \  # 监管器API端口（用于状态查询）
  -v ./tls:/etc/supervisor/tls \  # 挂载TLS证书（若启用加密）
  your-registry/otel-opamp-supervisor:latest

环境变量配置

Docker Compose部署示例

yaml
version: '3.8'

services:
  opamp-supervisor:
    image: docker.xuanyuan.run/your-registry/otel-opamp-supervisor:latest
    container_name: otel-opamp-supervisor
    restart: unless-stopped
    environment:
      - OPAMP_SERVER_URL="https://opamp.example.com:4320"
      - COLLECTOR_ENDPOINTS="http://otel-collector-east:4317,http://otel-collector-west:4317"
      - LOG_LEVEL="debug"
      - TLS_ENABLED="true"
      - HEALTH_CHECK_INTERVAL="15"
    volumes:
      - ./tls:/etc/supervisor/tls  # 挂载TLS证书目录
    ports:
      - "4321:4321"  # 监管器API端口
    networks:
      - otel-network

  # 示例收集器配置（需启用OpAMP支持）
  otel-collector-east:
    image: docker.xuanyuan.run/otel/opentelemetry-collector-contrib:0.86.0
    command: ["--config=/etc/otel-collector-config.yaml"]
    volumes:
      - ./collector-config.yaml:/etc/otel-collector-config.yaml
    networks:
      - otel-network

networks:
  otel-network:
    driver: bridge

收集器OpAMP配置示例

被监管的OpenTelemetry收集器需在配置文件中启用OpAMP扩展，示例如下：

yaml
# collector-config.yaml
extensions:
  opamp:
    server_endpoint: "ws://otel-opamp-supervisor:4320/v1/opamp"  # 监管器地址
    instance_id: "collector-east-01"  # 实例唯一标识
    agent_type: "otelcol-contrib"
    auto_accept_config: true  # 自动接受监管器推送的配置

service:
  extensions: [opamp]
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlp]

状态验证

1. 检查监管器运行状态：

   bash
   docker exec -it otel-opamp-supervisor supervisor-cli status
   

   预期输出包含已连接的收集器实例及状态（如 collector-east-01: connected (healthy)）

2. 访问监管器API：

   bash
   curl http://localhost:4321/api/v1/collectors
   

   返回JSON格式的收集器列表及详细状态信息

注意事项

• 生产环境建议通过配置文件（/etc/supervisor/config.yaml）管理复杂参数，环境变量优先级低于配置文件
• 多区域部署时，建议为监管器配置地理分区标签，便于筛选管理
• 监管器自身的监控可通过添加prometheus扩展暴露指标（默认端口9090）
• 配置自动更新前需在测试环境验证兼容性，避免配置错误导致收集器不可用