Application Real-Time Monitoring Service:Bulk upload symbol tables

Prerequisites

Before you begin, make sure that you have:

• An application integrated into RUM with an application ID generated. For details, see Integrate a web application or an HTML5 application, Integrate a mini program, or Monitor apps

• An AccessKey pair with the AliyunSTSAssumeRoleAccess policy attached. For details, see Create an AccessKey pair

• An OSS client installed: either ossutil or an OSS SDK

• Enable OSS batch upload turned on in the File Management section of the Application Settings tab

  

OSS bucket and path format

<uid>/<pid>/<version>/

Upload with ossutil

ossutil is a command-line tool for OSS. It supports directory uploads and is the simplest method for bulk operations.

ossutil cp -r <local-directory>/ oss://<bucket>/<uid>/<pid>/<version>/

ossutil cp -r ./sourcemaps/ oss://arms-rum-sourcemap-hz/1981000187653069/ji7ex7ti31@f1fadb692e6cdc8/1.0.0/

./ossutil64 cp <file-path> oss://<bucket>/<uid>/<pid>/<version>/

./ossutil64 cp examplefile.js.map oss://arms-rum-sourcemap-hz/1981000187653069/ji7ex7ti31@f1fadb692e6cdc8/1.0.0/

Upload with OSS SDKs

Use an OSS SDK when you need programmatic control or want to integrate uploads into your application code. All SDK examples follow the same pattern: authenticate with environment variable credentials, connect to the region-specific bucket, and upload files to the <uid>/<pid>/<version>/ path.

The following Python example uploads a source map file named examplefile.js.map:

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Authenticate using the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())

# Connect to the China (Hangzhou) region bucket
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'arms-rum-sourcemap-hz')

# Build the destination path: <uid>/<pid>/<version>/<filename>
destination = '1981000187653069/ji7ex7ti31@f1fadb692e6cdc8/1.0.0/examplefile.js.map'

# Upload the local file
bucket.put_object_from_file(destination, 'D:\\localpath\\examplefile.js.map')

For other languages, see OSS SDK overview.

Integrate with CI/CD pipelines

You can integrate CI/CD pipelines with ossutil or OSS SDKs to upload symbol tables to the specified OSS bucket.

Upload dSYM files

For iOS apps, compress dSYM files before uploading. RUM automatically parses the UUID from each compressed file.

1. Locate your dSYM files. A typical directory structure:

      .
      ├── AlibabaCloudRUM.framework.dSYM
      │   └── Contents
      │       ├── Info.plist
      │       └── Resources
      │           ├── DWARF
      │           │   └── AlibabaCloudRUM
      │           └── Relocations
      │               └── aarch64
      │                   └── AlibabaCloudRUM.yml
      └── iOSDemo.app.dSYM
          └── Contents
              ├── Info.plist
              └── Resources
                  ├── DWARF
                  │   ├── iOSDemo
                  │   └── iOSDemo.txt
                  └── Relocations
                      └── aarch64
                          └── iOSDemo.yml

2. Compress the dSYM files into a .zip archive:

      zip -r dsyms.zip *.dSYM

3. Upload the archive to OSS. The path must include the version:

      ossutil cp dsyms.zip oss://<bucket>/<uid>/<pid>/<version>/

FAQ

What's next

• Integrate a web application or an HTML5 application

• Integrate a mini program

• Monitor apps