appdynamics/appd-oc-otel-collector

AppD OC OTel Collector镜像文档

镜像概述

本仓库托管AppD OC OTel Collector镜像，这些镜像基于OpenTelemetry Collector构建，集成了AppDynamics Observability Cloud（OC）的专用组件。镜像旨在简化将应用程序和基础设施的遥测数据（指标、日志、追踪）收集、处理并导出至AppD OC平台的流程，提供开箱即用的集成能力。

核心功能与特性

• 原生AppD OC集成：内置AppD OC导出器，支持直接将遥测数据发送至AppDynamics Observability Cloud
• 标准化数据处理：遵循OpenTelemetry规范，支持多种数据格式和协议（如OTLP、Jaeger、Zipkin等）
• 预配置组件：包含常用处理器（如批处理、过滤、转换）和接收器，减少自定义配置工作量
• 轻量级设计：基于精简基础镜像，优化资源占用，适合容器化部署环境
• 版本同步：与OpenTelemetry Collector核心版本保持同步，确保兼容性和功能更新

使用场景与适用范围

• 云原生应用监控：为Kubernetes、Docker等容器化环境中的微服务提供遥测数据采集方案
• 混合架构可观测性：统一收集来自云服务、本地数据中心的异构系统遥测数据
• DevOps工作流集成：嵌入CI/CD管道，实现应用部署时的可观测性配置自动化
• AppDynamics用户扩展：为已使用AppDynamics APM的用户提供OpenTelemetry生态的扩展能力

使用方法与配置说明

前提条件

• 已注册AppDynamics Observability Cloud账号，获取API密钥和数据接收端点
• 安装Docker Engine（20.10+）或Kubernetes环境

镜像拉取

从仓库拉取最新版本镜像：

bash
docker pull docker.xuanyuan.run/[仓库地址]/appd-oc-otel-collector:latest

注：请替换[仓库地址]为实际镜像仓库地址（如Docker Hub、私有仓库等）

基本运行示例

使用环境变量配置AppD OC连接信息，启动Collector容器：

bash
docker run -d \
  --name appd-oc-otel-collector \
  -e APPD_OC_API_KEY="your-api-key" \
  -e APPD_OC_ENDPOINT="https://your-oc-endpoint" \
  -p 4317:4317  # OTLP gRPC接收端口
  [仓库地址]/appd-oc-otel-collector:latest

自定义配置

如需自定义Collector配置（如添加接收器、处理器），可通过挂载配置文件实现：

1. 创建本地配置文件otel-collector-config.yaml：

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

processors:
  batch:
    timeout: 10s
    send_batch_size: 1024

exporters:
  appd_oc:
    api_key: "${APPD_OC_API_KEY}"
    endpoint: "${APPD_OC_ENDPOINT}"
    tls:
      insecure: false

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

2. 挂载配置文件启动容器：

bash
docker run -d \
  --name appd-oc-otel-collector \
  -e APPD_OC_API_KEY="your-api-key" \
  -e APPD_OC_ENDPOINT="https://your-oc-endpoint" \
  -v $(pwd)/otel-collector-config.yaml:/etc/otelcol/config.yaml \
  -p 4317:4317 \
  -p 4318:4318 \
  docker.xuanyuan.run/[仓库地址]/appd-oc-otel-collector:latest

环境变量说明

注意事项

• 确保网络连通性：容器需能访问AppD OC端点（通常需要443端口 outbound 权限）
• 资源配置：根据数据量调整容器CPU/内存限制，建议起步配置为1CPU/2GB内存
• 版本兼容性：使用前确认镜像版本与OpenTelemetry Collector核心版本的兼容性说明
• 安全最佳实践：通过环境变量注入敏感信息（如API密钥），避免硬编码在配置文件中