Official Coralogix RUM CLI

The Coralogix RUM CLI is a command-line tool designed to simplify the process of uploading RUM (Real User Monitoring)
data. It provides a streamlined way to authenticate with the Coralogix API and manage source maps, dSYM files, and
ProGuard mappings.


Links

- Coralogix Real User Monitoring Docs
- Coralogix SDK for Browsers

Installation

To install the Coralogix RUM CLI, follow these steps:

1. Open a terminal or command prompt.
2. Run the following command to install the CLI globally:
``bash
npm install -g @coralogix/rum-cli
`
3. Once installed, you can use the CLI by running coralogix-rum-cli in your terminal.

Commands

Here are some examples of how to use the Coralogix RUM CLI:

$3

Upload source maps:

`bash
coralogix-rum-cli upload-source-maps -k -a -v -f -e -c -n -o
`

$3

Upload React Native source maps:

`bash
coralogix-rum-cli upload-react-native-source-maps -k -a -v -f -e -c -n -o
`

$3

Upload dSYM file:

`bash
coralogix-rum-cli upload-dsym -k -a -v -f -e -c -n -o
`

$3

Upload ProGuard file:

`bash
coralogix-rum-cli upload-proguard -k -a -v -f -e -c -n -o
`

Options

- -k, --private-key : Private key to authenticate with the Coralogix API.
- -a, --application : Name of the application.
- -v, --version : The application version (must match the version used by the RUM SDK).
- -f, --folder-path : Path to the folder containing the Source Maps, dSYM file, or ProGuard mapping file.
- -e, --env : Your environment (e.g., EU1, US1).
- -c, --commit-hash : GitHub commit hash (optional).
- -n, --repo-name : GitHub repository name (optional).
- -o, --org-name : GitHub organization name (optional).
- --override: Override existing source maps (optional).
- -h, --help: Display help.

Environments

Specify the appropriate environment using the -e option:

- EU1: https://ng-api-grpc.coralogix.com:443 (eu-west-1, Ireland)
- EU2: https://ng-api-grpc.eu2.coralogix.com:443 (eu-north-1, Stockholm)
- US1: https://ng-api-grpc.coralogix.us:443 (us-east-2, Ohio)
- US2: https://ng-api-grpc.cx498.coralogix.com:443 (us-west-2, Oregon)
- AP1: https://ng-api-grpc.app.coralogix.in:443 (ap-south-1, Mumbai)
- AP2: https://ng-api-grpc.coralogixsg.com:443 (ap-southeast-1, Singapore)
- AP3: https://ng-api-grpc.ap3.coralogix.com:443 (ap-southeast-3, Asia Pacific (Jakarta))

Folder Size Limits

Ensure your files do not exceed the following size limits:

- React Native Source Maps: 200MB per folder
- Source Maps: 200MB per folder
- ProGuard Files: 200MB per folder
- dSYM Files: 400MB per file

Integration

$3

To automate the upload process in your CI pipeline:

1. Create a Shell Script:
- Name it according to the use case (
e.g., upload-source-maps.sh, upload-react-native-source-maps.sh, upload-dsym.sh, or upload-proguard.sh).

2. Template for the Script:
`bash
#! /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"
FILES_PATH="your-files-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 the respective files
coralogix-rum-cli upload- -k "$PRIVATE_KEY" -a "$APPLICATION" -v "$VERSION" -f "$FILES_PATH" -e "$ENV" -c "$COMMIT_HASH" -n "$REPO_NAME" -o "$ORG_NAME"
`

Replace with source-maps, react-native-source-maps, dsym, or proguard based on the file type.

$3

For manual uploads, use the corresponding command in your terminal:

`bash
coralogix-rum-cli upload- -k "$PRIVATE_KEY" -a "$APPLICATION" -v "$VERSION" -f "$FILES_PATH" -e "$ENV" -c "$COMMIT_HASH" -n "$REPO_NAME" -o "$ORG_NAME"
`

Replace with one of the following as needed:

- source-maps
- react-native-source-maps
- dsym
- proguard

| IMPORTANT: The $VERSION parameter must exactly match the version specified in the SDK initialization (init) function configuration in your Coralogix SDK for Browsers |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|

Optional GitHub Information

You can provide additional GitHub-related options to enhance source map management:

- -c, --commit-hash : The commit hash associated with the source maps.
- -n, --repo-name : The repository name where the source code is hosted.
- -o, --org-name `: The organization user associated with the repository.

These options are optional but can improve issue tracking within Coralogix RUM.

License

This project is licensed under the MIT License. See the LICENSE file for details.