OpenTelemetry Collector Contrib Docker Image

Chainguard OpenTelemetry Collector Contrib 镜像文档

1. 镜像概述和主要用途

Chainguard OpenTelemetry Collector Contrib 镜像是基于 OpenTelemetry Collector Contrib 构建的安全容器镜像，旨在提供低至零 CVE（常见漏洞和暴露）的运行环境。该镜像集成了 Chainguard 对容器安全的优化，支持用户构建、交付和运行安全合规的软件，同时原生支持 OpenTelemetry 生态的遥测数据（指标、日志、追踪）收集、处理与导出功能。

2. 核心功能和特性

2.1 安全强化

• 低至零 CVE 风险：基于 Chainguard 最小化基础镜像构建，通过严格的供应链安全管控，将漏洞暴露风险降至最低。
• 合规支持：提供包含 FIPS（联邦信息处理标准）支持的额外版本，满足敏感行业合规需求。

2.2 功能完整性

• 完整集成 Contrib 组件：包含 OpenTelemetry Collector Contrib 全部功能，支持丰富的接收器（Receiver）、处理器（Processor）、导出器（Exporter）及扩展（Extension），覆盖多场景遥测数据处理需求。

2.3 供应链透明

• SBOM 支持：提供软件物料清单（SBOM），可通过 Chainguard 镜像目录查询，确保供应链可追溯性。
• 安全动态更新：实时关联安全 advisories 和漏洞信息，便于用户及时掌握镜像安全状态。

3. 使用场景和适用范围

3.1 适用场景

• 企业级遥测数据平台：需安全收集、处理、导出多源遥测数据（如 Kubernetes 集群、微服务应用、云服务）的场景。
• 合规敏感环境：***、政务、***等对数据安全和合规性要求高的领域，尤其适合需满足 FIPS 标准的场景。
• 云原生应用监控：在容器化或云原生架构中，作为核心组件构建端到端可观测性体系。

3.2 适用用户

• 关注容器安全与供应链合规的开发/运维团队。
• 基于 OpenTelemetry 构建可观测性平台的技术团队。
• 需要低风险、高可靠遥测数据管道的企业或组织。

4. 详细使用方法和配置说明

4.1 下载镜像

该镜像同时发布于 Docker Hub 和 Chainguard Registry，用户可根据网络环境选择拉取源：

从 Docker Hub 拉取

bash
docker pull docker.xuanyuan.run/chainguard/opentelemetry-collector-contrib:latest

从 Chainguard Registry 拉取

若遇 Docker Hub 速率限制，可切换至 Chainguard Registry：

bash
docker pull cgr.dev/chainguard/opentelemetry-collector-contrib:latest

4.2 Docker 部署示例

4.2.1 基础运行（默认配置）

bash
docker run -d \
  --name otel-collector \
  -p 4317:4317  # 默认 gRPC 接收端口（可根据配置调整） \
  chainguard/opentelemetry-collector-contrib:latest

4.2.2 挂载自定义配置文件

OpenTelemetry Collector 需通过配置文件定义数据处理流程，建议挂载外部配置文件（如 otel-config.yaml）：

bash
docker run -d \
  --name otel-collector \
  -v ./otel-config.yaml:/etc/otelcol-contrib/config.yaml  # 挂载本地配置文件至容器默认路径 \
  -p 4317:4317 \  # gRPC 接收端口  
  -p 4318:4318 \  # HTTP 接收端口（按需开放） \
  chainguard/opentelemetry-collector-contrib:latest

4.2.3 docker-compose 示例

yaml
version: '3.8'
services:
  otel-collector:
    image: docker.xuanyuan.run/chainguard/opentelemetry-collector-contrib:latest
    volumes:
      - ./otel-config.yaml:/etc/otelcol-contrib/config.yaml
    ports:
      - "4317:4317"  # gRPC
      - "4318:4318"  # HTTP
    restart: unless-stopped

4.3 配置参数说明

OpenTelemetry Collector Contrib 的核心配置通过 配置文件 实现（默认路径 /etc/otelcol-contrib/config.yaml），需用户根据实际需求定义。配置文件主要包含以下模块：

• receivers：定义数据输入源（如 otlp、prometheus、filelog 等）。
• processors：定义数据处理逻辑（如 batch、filter、resourcedetection 等）。
• exporters：定义数据输出目标（如 otlphttp、prometheusremotewrite、logging 等）。
• service：关联上述组件，指定运行的 pipelines 和 extensions。

配置示例（otel-config.yaml 片段）：

yaml
receivers:
  otlp:
    protocols:
      grpc:  # 监听 gRPC 端口 4317
      http:  # 监听 HTTP 端口 4318

processors:
  batch:  # 批量处理数据以优化性能

exporters:
  logging:  # 控制台输出调试

service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [logging]

完整配置规则可参考 https://opentelemetry.io/docs/collector/configuration/。

5. 额外资源和支持

5.1 版本与安全信息

• 额外版本（含 FIPS 支持）：https://images.chainguard.dev/directory/image/opentelemetry-collector-contrib/versions
• SBOM 与供应链信息：https://images.chainguard.dev/directory/image/opentelemetry-collector-contrib/sbom
• 安全 advisories 与漏洞：https://images.chainguard.dev/directory/image/opentelemetry-collector-contrib/advisories | https://images.chainguard.dev/directory/image/opentelemetry-collector-contrib/vulnerabilities

5.2 支持渠道

• 若遇速率限制或部署问题，可参考 https://edu.chainguard.dev/chainguard/chainguard-images/faq/
• 技术支持与联系：https://www.chainguard.dev/contact

5.3 官方文档

• 镜像完整概述：https://images.chainguard.dev/directory/image/opentelemetry-collector-contrib/overview