Application Real-Time Monitoring Service:Sentry SDK データ取り込みの設定

方法 1：SDK 直接書き込み

クライアントアプリケーションの Sentry SDK における DSN 構成を更新し、Alibaba Cloud SLS を指すようにします。

DSN フォーマット

元の Sentry DSN フォーマット：

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

変更後の Alibaba Cloud 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",
});

方法 2：Nginx ミラー二重書き込み

Nginx ミラーモジュールを使用して、データを既存の Sentry サービスと Alibaba Cloud SLS の両方に送信します。

シナリオ：Standard Edition Sentry コンソール、RUM Edition Sentry コンソール、および Alibaba Cloud 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;
    
    # Project 1 → RUM Application A
    "~^/api/1/envelope/"  /rum/sentry/my-workspace/service-a;
    
    # Project 2 → RUM Application B
    "~^/api/2/envelope/"  /rum/sentry/my-workspace/service-b;
    
    # Project 3 → RUM Application 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 ルート構成
        # ...
    }
}

パラメーターの説明