/aws-rum-web

Amazon CloudWatch RUM Web Client

Primary LanguageTypeScriptApache License 2.0Apache-2.0

Amazon CloudWatch RUM Web Client

This is the CloudWatch RUM web client source code repository. It hosts a JavaScript library which performs real user monitoring (RUM) telemetry on web applications. Data collected by the RUM web client includes page load timing, JavaScript errors and HTTP requests.

Install as a JavaScript Module

See Installing as a JavaScript Module.

Install as an Embedded Script

See Installing as an Embedded Script.

Additional Documentation:

  1. Configuring the web client
  2. Executing commands
  3. Using the web client with Angular
  4. Using the web client with React
  5. Troubleshooting

Getting Help

Use the following community resources for getting help with the SDK. We use the GitHub issues for tracking bugs and feature requests.

Opening Issues

If you encounter a bug with the CloudWatch RUM web client, we want to hear about it. Before opening a new issue, search the existing issues to see if others are also experiencing the issue. Include the version of the CloudWatch RUM web client, Node.js runtime, and other dependencies if applicable. In addition, include the repro case when appropriate.

The GitHub issues are intended for bug reports and feature requests. For help and questions about using the CloudWatch RUM web client, use the resources listed in the Getting Help section. Keeping the list of open issues lean helps us respond in a timely manner.

Contributing

We support and accept PRs from the community.

See CONTRIBUTING

Build from Source

The CloudWatch RUM web client is developed and built using Node.js version 16 or higher.

To build the CloudWatch RUM web client, run the release process:

npm install
npm run release

The release process creates (1) a web bundle and a debug map for distribution via CDN, and (2) JavaScript modules and TypeScript declaration files for distribution via NPM.

The CDN files are:

./build/assets/cwr.js
./build/assets/cwr.map.js

The NPM files are:

./dist/es/index.js
./dist/es/index.d.ts
./dist/cjs/index.js
./dist/cjs/index.d.ts

Run Tests from Source

To perform exploratory testing, run the Webpack DevServer:

npm install
npm run server

In a browser, navigate to http://localhost:9000.

To run (Jest) unit tests:

npm run test

To run (TestCafe) browser integration tests:

npm run integ:headless
npm run integ:browser

To run (TestCafe) integration tests for a specific browser:

npm run integ -- (browserName)
# for example
npm run integ -- chrome:headless
npm run integ -- chrome

Some features perform monkey patching which is incompatible with TestCafe. In these cases, run Nightwatch as a separate browser integration test target:

npm run integ:local:nightwatch

Pre-commit Tasks

The CloudWatch RUM web client uses pre-commit tasks to lint and format its source code. Before submitting code, check that all linter and formatter warnings have been resolved.

Attempt to automatically repair linter warnings:

npm run lint:fix

Format code:

npm run prettier:fix

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.