cleanstart/opentelemetry-collector-contrib

CleanStart Opentelemetry-Collector-Contrib 容器文档

镜像概述与主要用途

CleanStart Opentelemetry-Collector-Contrib镜像是一款面向企业环境优化的生产就绪型安全强化容器。基于最小化基础操作系统构建，具备全面的安全加固措施，提供可靠的应用执行能力和高级安全特性。

📌 基础信息

• 镜像路径：cleanstart/opentelemetry-collector-contrib
• 仓库：cleanstart Registry

核心功能与特性

• 安全强化：采用最小化基础OS，全面安全加固，符合企业级安全标准
• 生产就绪：优化的配置与性能，适合直接用于生产环境部署
• 灵活配置：支持自定义配置文件，适配多样化的遥测数据收集需求
• 多协议支持：内置OTLP等多种协议接收器，兼容主流可观测性工具

使用场景与适用范围

• 企业级分布式应用的可观测性数据（ traces、metrics、logs ）收集
• 生产环境中遥测数据的处理与转发
• 需要高安全性和稳定性的监控系统部署
• Kubernetes集群内的可观测性基础设施构建

使用方法与配置说明

拉取最新镜像

从仓库下载容器镜像：

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

开发版本：

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

基本配置文件

创建配置文件（示例：otel-config.yaml）：

yaml
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

processors:
  batch:

exporters:
  debug:
    verbosity: detailed

service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [debug]
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [debug]
    logs:
      receivers: [otlp]
      processors: [batch]
      exporters: [debug]

基本运行

通过卷挂载配置文件运行容器：

bash
docker run -it --name opentelemetry-collector-contrib \
  -v $(pwd)/otel-config.yaml:/etc/otel/config.yaml \
  docker.xuanyuan.run/cleanstart/opentelemetry-collector-contrib:latest \
  --config /etc/otel/config.yaml

生产环境部署

带安全设置的生产部署：

bash
docker run -d \
  --name opentelemetry-collector-contrib-prod \
  --security-opt=no-new-privileges \
  --user 1000:1000 \
  --restart unless-stopped \
  -v /app:/app \
  -v $(pwd)/otel-config.yaml:/etc/otel/config.yaml:ro \
  docker.xuanyuan.run/cleanstart/opentelemetry-collector-contrib:latest \
  --config /etc/otel/config.yaml

端口转发运行

自定义端口映射的部署：

bash
docker run --name opentelemetry-collector-contrib-prod \
  --security-opt=no-new-privileges \
  --user 1000:1000 \
  --restart unless-stopped \
  -p 4317:4317 \
  -p 4318:4318 \
  -p 8888:8888 \
  -v /app:/app \
  -v $(pwd)/otel-config.yaml:/etc/otel/config.yaml:ro \
  docker.xuanyuan.run/cleanstart/opentelemetry-collector-contrib:latest \
  --config /etc/otel/config.yaml

环境变量

通过环境变量配置容器选项：

Kubernetes安全上下文

Kubernetes部署推荐的安全上下文配置：

yaml
securityContext:
  allowPrivilegeEscalation: false
  capabilities:
    drop:
    - ALL
  readOnlyRootFilesystem: true
  runAsUser: 1000
  runAsGroup: 1000

文档资源

核心链接

• CleanStart镜像：[***]

社区镜像仓库

• Docker Hub：https://hub.docker.com/u/cleanstart
• GitHub：https://github.com/cleanstart-containers
• AWS ECR Public Gallery：[***]

社交媒体

• 社区：[***]
• *****：[*]

贡献容器用例

• https://github.com/cleanstart-dev/cleanstart-use-cases/