@coralogix/rum-cli 1.1.6 → 1.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -29
- package/package.json +1 -1
- package/assets/docs-illustration.png +0 -0
package/README.md
CHANGED
|
@@ -4,12 +4,12 @@ The Coralogix RUM CLI is a command-line interface tool that simplifies the proce
|
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@coralogix/browser)
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
# Links
|
|
8
8
|
|
|
9
9
|
- [Coralogix Real User Monitoring Docs](https://coralogix.com/docs/real-user-monitoring/)
|
|
10
10
|
|
|
11
11
|
- [Coralogix SDK for Browsers](https://www.npmjs.com/package/@coralogix/browser)
|
|
12
|
-
|
|
12
|
+
# Installation
|
|
13
13
|
|
|
14
14
|
To install the Coralogix RUM CLI, follow these steps:
|
|
15
15
|
|
|
@@ -17,7 +17,7 @@ To install the Coralogix RUM CLI, follow these steps:
|
|
|
17
17
|
2. Run the following command to install the CLI globally: `npm install -g coralogix-rum-cli`
|
|
18
18
|
3. Once the installation is complete, you can use the CLI by running the `coralogix-rum-cli` command in your terminal.
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
# Examples
|
|
21
21
|
|
|
22
22
|
Here are some examples of how to use the Coralogix RUM CLI:
|
|
23
23
|
|
|
@@ -29,9 +29,9 @@ Here are some examples of how to use the Coralogix RUM CLI:
|
|
|
29
29
|
|
|
30
30
|
- `coralogix-rum-cli upload-source-maps --help`
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
# Upload source maps
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
### Options:
|
|
35
35
|
|
|
36
36
|
- `-k, --private-key <privateKey>`: Private key to authenticate with the Coralogix API.
|
|
37
37
|
- `-a, --application <application>`: Name of the application.
|
|
@@ -43,13 +43,9 @@ To uplaod source maps support the following options:
|
|
|
43
43
|
- `-o, --org-name <orgName>`: GitHub organization name (optional).
|
|
44
44
|
- `-h, --help`: Display help.
|
|
45
45
|
|
|
46
|
-
To use the CLI, execute the following command:
|
|
47
46
|
|
|
48
|
-
## Uploading Source Maps Using a Script
|
|
49
47
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
## For CI Integration:
|
|
48
|
+
### For CI Integration:
|
|
53
49
|
|
|
54
50
|
1. Create a new file named `upload-source-maps.sh` and open it for editing.
|
|
55
51
|
|
|
@@ -74,6 +70,12 @@ COMMIT_HASH=$(git rev-parse HEAD)
|
|
|
74
70
|
coralogix-rum-cli upload-source-maps -k "$PRIVATE_KEY" -a "$APPLICATION" -r "$RELEASE_NAME" -f "$SOURCE_MAPS_PATH" -e "$ENV" -c "$COMMIT_HASH" -n "$REPO_NAME" -o "$ORG_NAME"
|
|
75
71
|
```
|
|
76
72
|
|
|
73
|
+
### For Non-CI Integration:
|
|
74
|
+
1. Open a terminal window,and run the following command:
|
|
75
|
+
```bash
|
|
76
|
+
coralogix-rum-cli upload-source-maps -k "$PRIVATE_KEY" -a "$APPLICATION" -r "$RELEASE_NAME" -f "$SOURCE_MAPS_PATH" -e "$ENV" -c "$COMMIT_HASH" -n "$REPO_NAME" -o "$ORG_NAME"
|
|
77
|
+
```
|
|
78
|
+
|
|
77
79
|
<br>
|
|
78
80
|
|
|
79
81
|
| IMPORTANT: The $RELEASE_ID must align with the content of the version field in your CoralogixRum.init() configuration in [Coralogix SDK for Browsers](https://www.npmjs.com/package/@coralogix/browser) |
|
|
@@ -81,25 +83,7 @@ coralogix-rum-cli upload-source-maps -k "$PRIVATE_KEY" -a "$APPLICATION" -r "$RE
|
|
|
81
83
|
|
|
82
84
|
<br>
|
|
83
85
|
|
|
84
|
-
##
|
|
85
|
-
1. Create a new file named upload-source-maps.sh and open it for editing.
|
|
86
|
-
|
|
87
|
-
2. Copy and paste the script provided above, and replace the placeholder values with your actual information.
|
|
88
|
-
|
|
89
|
-
3. Open a terminal window, navigate to the directory containing the upload-source-maps.sh script, and execute the script using the command:
|
|
90
|
-
|
|
91
|
-
If any of the required arguments are missing, the CLI will display an error message and exit.
|
|
92
|
-
|
|
93
|
-
Please ensure you provide valid values for the options when using the CLI.
|
|
94
|
-
|
|
95
|
-
By following these instructions, you can effortlessly upload source maps using the Coralogix RUM CLI script in both CI and non-CI environments.
|
|
96
|
-
|
|
97
|
-
# Illustration
|
|
98
|
-
Here's an overview of the process, showing the parsed stacktrace in the source map:
|
|
99
|
-
|
|
100
|
-
<img src="assets/docs-illustration.png" alt="Upload Source Maps"/>
|
|
101
|
-
|
|
102
|
-
# Available Environments
|
|
86
|
+
## Available Environments
|
|
103
87
|
|
|
104
88
|
The Coralogix RUM CLI supports the following environments:
|
|
105
89
|
|
|
@@ -122,6 +106,8 @@ The following options are optional and relate to GitHub information, providing c
|
|
|
122
106
|
|
|
123
107
|
|
|
124
108
|
- `-o, --org-name <orgName>`: This option enables you to input your GitHub organization user, helping to attribute the source maps to the appropriate organization user.
|
|
109
|
+
|
|
110
|
+
<br>
|
|
125
111
|
Providing these GitHub-related options can enhance the accuracy of source map management and issue tracking within Coralogix RUM. However, they are not mandatory and can be omitted if not applicable.
|
|
126
112
|
|
|
127
113
|
## License
|
package/package.json
CHANGED
|
Binary file
|