Application Real-Time Monitoring Service：配置 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 路由配置
        # ...
    }
}

參數說明