RUM Source Maps

Information on how to automatically upload your source maps using the RUM Integration Package can be found here.

Overview

Source map files are files commonly used in web development to facilitate the debugging process of minified or transpiled code. When JavaScript or CSS code is minified or transformed into a more compact form for production, it becomes challenging to trace errors back to the original source code due to the loss of meaningful variable names, line numbers, and structure. Source map files address this issue by providing a mapping between the minified code and its original, human-readable source code. This enables developers to debug efficiently by allowing browsers and debugging tools to display accurate error messages and stack traces based on the original code, aiding in the identification and resolution of issues in the development process.

Take advantage of our RUM CLI to easily upload the source maps for your applications to the Coralogix RUM service.

NOTE

The source map folder size limit is 100MB. Please ensure that it does not exceed this limit.

Install the RUM CLI

STEP 1. Open a terminal or command prompt.

STEP 2. Run the following command to install the CLI globally:

npm i @coralogix/rum-cli

STEP 3. Once the installation is complete, you can use the CLI by running the coralogix-rum-cli command in your terminal.

Examples

Here are some example commands for using the Coralogix RUM CLI:

Upload Source Maps

coralogix-rum-cli upload-source-maps -k <privateKey> -a <application> -v <version> -f <folderPath> -e <env> -c <commitHash> -n <repoName> -o <orgName>

Display Help

coralogix-rum-cli upload-source-maps --help

Uploading Source Maps

Three options exist for uploading source maps.

• Upload source maps during the onboarding process.
• Upload source maps from the Coralogix RUM user interface. [Recommended if you didn’t upload during the onboarding process]
• Upload source maps manually using the Coralogix RUM CLI (explained in this document).

When uploading source maps using the RUM CLI, use the following options:

Upload Source Maps Using a Script

To simplify the process of uploading source maps using the Coralogix RUM CLI, you can create a bash script that automates the task. Follow these steps to set up the script for CI and non-CI integrations.

CI Integration

STEP 1. Create a new file named upload-source-maps.sh and open it for editing.

STEP 2. Copy and paste the following script into the file, replacing the placeholder values with your actual information:

#! /usr/bin/env bash

# Replace these values with your actual information
REPO_NAME="your-repo-name"
ORG_NAME="your-github-username"
APPLICATION="your-application-name"
ENV="your-environment"
SOURCE_MAPS_PATH="your-source-maps-path"
PRIVATE_KEY="your-coralogix-private-key"
VERSION="your-application-version"

# Get the commit hash using git rev-parse
COMMIT_HASH=$(git rev-parse HEAD)

# Run Coralogix RUM CLI to upload source maps
coralogix-rum-cli upload-source-maps -k "$PRIVATE_KEY" -a "$APPLICATION" -v "$VERSION" -f "$SOURCE_MAPS_PATH" -e "$ENV" -c "$COMMIT_HASH" -n "$REPO_NAME" -o "$ORG_NAME"

IMPORTANT: The $RELEASE_ID must align with the content of the version field in your CoralogixRum.init() configuration in Coralogix SDK for Browsers.

Non-CI Integration

STEP 1. Open a terminal window.

STEP 2. Run the following command:

coralogix-rum-cli upload-source-maps -k "$PRIVATE_KEY" -a "$APPLICATION" -v "$VERSION" -f "$SOURCE_MAPS_PATH" -e "$ENV" -c "$COMMIT_HASH" -n "$REPO_NAME" -o "$ORG_NAME"

IMPORTANT: The $VERSION must align with the content of the version field in your CoralogixRum.init() configuration in Coralogix SDK for Browsers.

Available Environments

The Coralogix RUM CLI supports the following environments:

• AP1
• AP2
• EU1
• EU2
• US1

Please use the appropriate environment value when specifying the -e, --env option.

Optional GitHub Information

The following options are optional and relate to GitHub information, providing context for source maps:

Additional Resources

Support

Need help?

Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.

Feel free to reach out to us via our in-app chat or by sending us an email at [email protected].