otel/opentelemetry-operator-bundle

OpenTelemetry Operator 镜像文档

镜像概述

OpenTelemetry Operator是一个Kubernetes Operator，专门用于管理OpenTelemetry Collectors和Instrumentation Agents。它通过Kubernetes自定义资源定义（CRD）简化了OpenTelemetry组件的部署、配置和生命周期管理，帮助用户在Kubernetes集群中高效部署可观测性基础设施。

核心功能与特性

• 管理OpenTelemetry Collectors：支持部署、扩展、升级和维护OpenTelemetry Collectors实例，统一收集分布式系统的遥测数据（指标、日志、追踪）
• 管理Instrumentation Agents：简化应用程序的自动instrumentation配置，支持多种编程语言的代理注入
• 声明式管理：通过Kubernetes自定义资源（CR）实现OpenTelemetry组件的声明式配置，符合Kubernetes原生操作模式
• 生命周期管理：自动处理组件的升级、故障恢复和资源调整，减少手动运维成本

使用场景与适用范围

适用于在Kubernetes集群中构建和管理可观测性基础设施的场景，主要包括：

• 分布式微服务架构的遥测数据统一收集
• 需要自动化部署和维护OpenTelemetry组件的团队
• 构建基于OpenTelemetry的全链路可观测性平台
• 多语言应用环境的统一instrumentation配置

使用方法与配置说明

部署前提

• Kubernetes集群（版本1.21+）
• 具有集群管理员权限的Kubernetes账户

基本部署步骤

1. 安装Operator
   通过官方资源清单部署Operator：

   bash
   kubectl apply -f https://github.com/open-telemetry/opentelemetry-operator/releases/latest/download/opentelemetry-operator.yaml
   

2. 验证部署
   检查Operator Pod状态：

   bash
   kubectl get pods -n opentelemetry-operator-system
   

3. 管理OpenTelemetry组件
   通过创建自定义资源（CR）管理组件，例如部署Collector：

   yaml
   apiVersion: opentelemetry.io/v1alpha1
   kind: OpenTelemetryCollector
   metadata:
     name: example-collector
   spec:
     mode: deployment
     config: |
       receivers:
         otlp:
           protocols:
             grpc:
             http:
       processors:
         batch:
       exporters:
         logging:
       service:
         pipelines:
           traces:
             receivers: [otlp]
             processors: [batch]
             exporters: [logging]
   

   应用上述配置：

   bash
   kubectl apply -f example-collector.yaml
   

配置说明

详细配置参数及自定义资源说明请参考官方文档，支持通过CR配置Collector的部署模式（Deployment、DaemonSet等）、资源限制、数据处理管道等核心功能。

相关资源

• 官方仓库：https://github.com/open-telemetry/opentelemetry-operator
• 贡献指南：https://github.com/open-telemetry/opentelemetry-operator/blob/main/CONTRIBUTING.md
• 官方文档：opentelemetry.io