@opencensus/web-all

OpenCensus Web All (JS bundles)

For overview and usage info see the main OpenCensus Web readme.

This package combines all of the main functionality of the OpenCensus Web packages into a variety of distributions for easy inclusion into web applications via a <script> tag.

The library is in alpha stage and the API is subject to change.

Build commands

To generate production minified JS bundles run npm run build:prod. For non-minified bundles use npm run build:dev.

To serve the bundles from a local webpack server run npm run start:webpack-server.

Generated scripts

These are the generated bundles.

If you don't mind loading a single larger bundle on the initial page load, use:

• ./dist/initial-load-all.js - This script combines the functionality of the instrument-initial-load.js and export-initial-load.js below. That is, it records spans based on the resource timing API for the initial page load and exports it to the OpenCensus Agent based on configured global variables. See the main OpenCensus Web readme for details.

If you would like to minimize the amount of JS loaded initially, you can use these two bundles to do instrumentation first and then an export more lazily:

• ./dist/instrument-initial-load.js - This is a small script that sets up the instrumentation configuration for getting resource timing span data for the initial page load. Specifically, it starts recording Long Tasks and increases the resource timing buffer size. This code should be loaded as part of the initial page load
• ./dist/export-initial-load.js - This script exports the resouce timing and long task information for the initial load to the agent. It can be retrieved after the initial page load has fully completed so it being downloaded and parsed doesn't need to compete with resources for the main page load.

Useful links

• For more information on OpenCensus, visit: https://opencensus.io/
• For more about OpenCensus Web: https://github.com/census-instrumentation/opencensus-web
• For help or feedback on this project, join us on gitter

License

Apache 2.0 - See LICENSE for more information.