用途:配置 OpenTelemetry Collector,通过 Sentry Exporter 把 traces 和 logs 发送到 Sentry,支持多项目路由与自动创建项目。
主要能力:检查已有 Collector 配置;检查或安装 otelcol-contrib(要求 v0.145.0 或更高,可选二进制或 Docker);配置 Sentry 项目自动创建(依据 service.name,需组织内至少有一个 team,新项目归入找到的第一个 team,创建期间初始数据可能被丢弃);编写 Collector 配置并加入 sentry exporter 与相应 pipelines;添加环境变量占位符;校验配置;运行 Collector;验证数据是否到达 Sentry。
使用方式:先查找含 receivers: 的 YAML 或 otel-collector-config.、collector-config.、otelcol.* 文件,决定修改现有配置还是新建 collector-config.yaml。二进制安装示例:curl -LO https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v<numeric_version>/otelcol-contrib_<numeric_version><os><arch>.tar.gz,随后 tar -xzf 并 chmod +x otelcol-contrib。Docker 安装:docker pull otel/opentelemetry-collector-contrib:<numeric_version>。配置需引用 ${env:SENTRY_ORG_SLUG} 与 ${env:SENTRY_AUTH_TOKEN},自动创建项目时加 auto_create_projects: true。校验:set -a && source "<env_file>" && set +a && "<collector_path>" validate --config "<config_file>"。运行:set -a && source "<env_file>" && set +a && "<collector_path>" --config "<config_file>"。Docker 运行映射 4317、4318、13133 端口。
适用场景:需要把 OTel 遥测接入 Sentry、按服务名自动建项目、或排查导出链路时。
限制:凭据须由用户自行填写,工具只添加占位符;自动创建项目要求组织已有 team,且需 Project:Write 权限;token 必须为 Internal Integration token;Docker 挂载需绝对路径;验证失败需按错误修正后重试。