配置 Sentry SDK 数据写入

方式一：SDK 直写

修改客户端应用中 Sentry SDK 的 DSN 配置，将数据上报地址指向阿里云 SLS。

DSN 格式

原始 Sentry DSN 格式：

https://<public_key>@<sentry_host>/<project_id>

修改后的 阿里云 DSN 格式：

https://<public_key>@<endpoint>/rum/sentry/<workspace>/<service_id>/<project_id>

参数说明

配置示例

以下为各平台 SDK 的配置示例。

iOS（Swift）

import Sentry

SentrySDK.start { options in
    options.dsn = "https://key@cn-chengdu.log.aliyuncs.com/rum/sentry/my-workspace/abc123@example/21"
    options.debug = true
}

Android（Kotlin）

import io.sentry.android.core.SentryAndroid

SentryAndroid.init(this) { options ->
    options.dsn = "https://key@cn-chengdu.log.aliyuncs.com/rum/sentry/my-workspace/abc123@example/21"
    options.isDebug = true
}

Web（JavaScript）

import * as Sentry from "@sentry/browser";

Sentry.init({
  dsn: "https://key@cn-chengdu.log.aliyuncs.com/rum/sentry/my-workspace/abc123@example/21",
  debug: true,
});

Electron

import * as Sentry from "@sentry/electron";

Sentry.init({
  dsn: "http://key@cn-chengdu.log.aliyuncs.com/rum/sentry/my-workspace/abc123@example/21",
});

Vue

import * as Sentry from "@sentry/vue";

Sentry.init({
  app,
  dsn: "http://key@cn-chengdu.log.aliyuncs.com/rum/sentry/my-workspace/abc123@example/21",
});

方式二：Nginx 镜像双写

通过 Nginx mirror 模块将数据同时写入原 Sentry 服务和阿里云 SLS。

适用场景：需同时在标准版 Sentry、RUM 版 Sentry 和阿里云 RUM 控制台查看数据。

配置步骤

1. 在 Nginx 配置文件中添加 SLS 转发的 upstream：

   upstream rum_forwarder {
       server <endpoint>:80;
       keepalive 2;
   }

2. 添加 URI 映射规则，根据 Sentry 项目 ID 配置对应的转发路径：

   map $request_uri $forwarder_path {
       # 默认转发路径
       default /rum/sentry/<workspace>/<service_id>;
       
       # 按项目 ID 配置不同的转发路径
       "~^/api/<project_id>/envelope/"  /rum/sentry/<workspace>/<service_id_for_project_1>;
       "~^/api/1/envelope/"  /rum/sentry/<workspace>/<service_id_for_project_1>;
       "~^/api/2/envelope/"  /rum/sentry/<workspace>/<service_id_for_project_2>;
   }

3. 在 Sentry API 路由中启用流量镜像：

      location ~ ^/api/[1-9]\d*/ {
          proxy_pass http://relay;
          mirror /rum_mirror;
          mirror_request_body on;
      }
   
      location = /rum_mirror {
          internal;
          
          proxy_pass http://rum_forwarder$forwarder_path$request_uri;
          
          proxy_set_header Host <endpoint>;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_set_header X-Forwarded-Proto $scheme;
          proxy_set_header X-Request-Id $request_id;
          proxy_set_header Connection '';
   
          proxy_read_timeout 5s;
          proxy_send_timeout 5s;
          proxy_connect_timeout 5s;
   
          proxy_ignore_client_abort on;
      }

4. 重新加载 Nginx 配置：

   nginx -t && nginx -s reload

多项目配置示例

如有多个 Sentry 项目需要转发至不同的 RUM 应用，按以下方式配置 map 规则：

map $request_uri $forwarder_path {
    default /rum/sentry/my-workspace/default-service;
    
    # 项目 1 → RUM 应用 A
    "~^/api/1/envelope/"  /rum/sentry/my-workspace/service-a;
    
    # 项目 2 → RUM 应用 B
    "~^/api/2/envelope/"  /rum/sentry/my-workspace/service-b;
    
    # 项目 3 → RUM 应用 C
    "~^/api/3/envelope/"  /rum/sentry/my-workspace/service-c;
}

完整配置示例

http {
    upstream rum_forwarder {
        server <endpoint>:80;
        keepalive 2;
    }

    map $request_uri $forwarder_path {
        # 默认转发路径
        default /rum/sentry/<workspace>/<service_id>;
       
        # 按项目 ID 配置不同的转发路径
        "~^/api/1/envelope/"  /rum/sentry/<workspace>/<service_id_for_project_1>;
        "~^/api/2/envelope/"  /rum/sentry/<workspace>/<service_id_for_project_2>;
   }

    server {
        listen 80;
        server_name sentry.example.com;

        # Sentry API 路由 - 启用镜像
        location ~ ^/api/[1-9]\d*/ {
            proxy_pass http://relay;
            mirror /rum_mirror;
            mirror_request_body on;
        }

        # SLS 镜像处理
        location = /rum_mirror {
            internal;
       
            proxy_pass http://rum_forwarder$forwarder_path$request_uri;
       
            proxy_set_header Host <endpoint>;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            proxy_set_header X-Request-Id $request_id;
            proxy_set_header Connection '';

            proxy_read_timeout 5s;
            proxy_send_timeout 5s;
            proxy_connect_timeout 5s;

            proxy_ignore_client_abort on;
        }

        # 其他 Sentry 路由配置
        # ...
    }
}

参数说明