SuperAPI AI 工具集

sentry-otel-exporter-setup

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:配置 OpenTelemetry Collector,通过 Sentry Exporter 把 traces 和 logs 发送到 Sentry,并支持多项目路由与自动创建项目。

主要能力:检查现有 Collector 配置;检查或安装 otelcol-contrib(要求 v0.145.0 或更高,支持二进制或 Docker);配置 Sentry 项目自动创建(按 service.name 创建,需组织内至少有一个 team,新项目归入找到的第一个 team,创建期间初始数据可能被丢弃);编写 Collector 配置并加入 sentry exporter 与 pipelines;用环境变量占位符管理凭据;校验配置并运行 Collector;验证 traces/logs 是否在 60 秒内出现在 Sentry;为 Python、Ruby、Node.js 的 Sentry SDK 启用 OTLPIntegration 以实现 trace connectedness。

使用方式:按清单逐步执行。先查找含 receivers: 的 YAML 或 otel-collector-config.、collector-config.、otelcol.* 文件,并让用户选择修改现有配置或新建配置。检查 which otelcol-contrib 或 ./otelcol-contrib 的版本。二进制安装示例: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。Docker 安装:docker pull otel/opentelemetry-collector-contrib:<numeric_version>。配置模板取自 Sentry Exporter 文档的 example-config.yaml,凭据使用 ${env:SENTRY_ORG_SLUG}、${env:SENTRY_AUTH_TOKEN},自动创建项目时加 auto_create_projects: true。环境变量占位符为 SENTRY_ORG_SLUG=your-org-slug 与 SENTRY_AUTH_TOKEN=your-token-here,由用户自行替换。校验命令:set -a && source "<env_file>" && set +a && "<collector_path>" validate --config "<config_file>";Docker 校验用 docker run --rm 挂载配置并 --env-file。运行命令由用户自行执行,Docker 需映射 4317、4318、13133 端口。

适用场景:需要把 OTel 遥测接入 Sentry、按服务名自动建项目、或希望 OTel traces 与 Sentry 错误/日志关联的团队。

限制:Sentry Exporter 需 otelcol-contrib v0.145.0 及以上;自动创建项目需 Project:Write 权限且组织内已有 team;trace connectedness 目前仅支持 Python、Ruby、Node.js;使用 otlpIntegration 时不要设置 tracesSampleRate;Docker 挂载需绝对路径。具体收费、价格与效果资料未提供。