sumologic/sumologic-otel-collector

Sumo Logic Distribution for OpenTelemetry Collector 镜像文档

镜像概述

Sumo Logic Distribution for OpenTelemetry Collector 是由Sumo Logic官方提供的OpenTelemetry Collector定制发行版。该镜像基于OpenTelemetry Collector构建，针对Sumo Logic平台进行了优化，旨在简化遥测数据（指标、日志、追踪）的收集、处理与导出流程，帮助用户快速实现与Sumo Logic可观测性平台的集成。

核心功能与特性

• 无缝集成Sumo Logic：预配置与Sumo Logic平台的通信协议，支持直接将遥测数据导出至Sumo Logic。
• 多源数据收集：支持从多种数据源（如应用程序、容器、基础设施、日志文件等）采集遥测数据。
• 内置处理能力：包含常用遥测数据处理组件（过滤、转换、聚合等），满足数据预处理需求。
• 简化配置：提供针对Sumo Logic的默认配置模板，减少手动配置复杂度。
• 兼容性：遵循OpenTelemetry规范，兼容标准OpenTelemetry数据源和导出器。

使用场景与适用范围

• 企业可观测性集成：需要将应用程序、服务及基础设施的遥测数据（指标、日志、追踪）集中发送至Sumo Logic平台的场景。
• 多云/混合云环境：在混合云或多云架构中，统一收集不同环境的遥测数据并导出至Sumo Logic。
• DevOps与SRE工作流：支持DevOps和SRE团队通过Sumo Logic分析应用性能与系统健康状态。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令启动Sumo Logic OpenTelemetry Collector容器：

bash
docker run -d --name sumologic-otel-collector \
  -v /path/to/your/config.yaml:/etc/otelcol-sumo/config.yaml \
  sumologic/otelcol-sumo:latest

说明：需提前准备配置文件（config.yaml），定义数据源、处理逻辑和导出配置。详细配置示例可参考https://github.com/SumoLogic/sumologic-otel-collector/%E3%80%82

关键配置说明

配置文件

核心配置文件（config.yaml）需包含以下部分：

• receivers：定义数据接收源（如otlp、filelog、prometheus等）。
• processors：定义数据处理规则（如batch、filter、attributes等）。
• exporters：配置Sumo Logic导出器，需指定Sumo Logic的访问令牌和端点。
• service：组合接收者、处理器和导出器为数据流管道。

环境变量（可选）

可通过环境变量覆盖部分配置（具体支持的变量请参考官方文档）：

• SUMO_LOGIC_ACCESS_ID：Sumo Logic访问ID。
• SUMO_LOGIC_ACCESS_KEY：Sumo Logic访问密钥。
• SUMO_LOGIC_ENDPOINT：遥测数据导出端点（根据部署区域选择）。

获取详细信息

更多配置示例、高级用法及版本更新说明，请访问项目https://github.com/SumoLogic/sumologic-otel-collector/%E3%80%82

注意事项

• 确保配置文件中的Sumo Logic凭证（访问ID/密钥）具有足够权限。
• 根据数据量调整处理器配置（如批处理大小、超时时间）以优化性能。
• 定期更新镜像版本以获取最新功能和安全修复。