Application Real-Time Monitoring Service:Configure Sentry SDK Data Ingestion

Method 1: SDK Direct Write

Update the DSN configuration in your client application’s Sentry SDK to point to Alibaba Cloud SLS.

DSN format

Original Sentry DSN format:

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

Revised Alibaba Cloud DSN format:

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

Parameters

Configuration Examples

The following examples show the SDK configuration for each platform.

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",
});

Method 2: Nginx Mirror Dual Write

Use the Nginx mirror module to send data to both your existing Sentry service and Alibaba Cloud SLS.

Scenario: You need to view data in the Standard Edition Sentry console, the RUM Edition Sentry console, and the Alibaba Cloud RUM console.

Configuration steps

1. In your Nginx configuration file, add an upstream for SLS forwarding:

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

2. Add a URI mapping rule. Configure different forwarding paths based on the Sentry project ID:

   map $request_uri $forwarder_path {
       # Default forwarding path
       default /rum/sentry/<workspace>/<service_id>;
       
       # Forward by project 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. Enable traffic mirroring for the Sentry API route:

      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. Reload the Nginx configuration:

   nginx -t && nginx -s reload

Multi-project configuration example

If you have multiple Sentry projects and need to forward them to different RUM applications, you can configure the map rules as follows:

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;
}

Full configuration example

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

    map $request_uri $forwarder_path {
        # Default forwarding path
        default /rum/sentry/<workspace>/<service_id>;
       
        # Forward by project 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 route — enable mirroring
        location ~ ^/api/[1-9]\d*/ {
            proxy_pass http://relay;
            mirror /rum_mirror;
            mirror_request_body on;
        }

        # SLS mirror handling
        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;
        }

        # Other Sentry route configurations
        # ...
    }
}

Parameter description