@opencensus/web-instrumentation-perf
v0.0.7
Published
OpenCensus Web instrumentation to generate spans for browser performance API data.
Downloads
49
Readme
OpenCensus Web instrumentation for web performance APIs
For overview and usage info see the main OpenCensus Web readme.
This package generates OpenCensus Web trace model spans based on performance API data provided by the browser. Specifically, it generates spans for the initial page load of a site based on the Resource Timing, Navigation Timing, and Long Task browser APIs. It attempts to gracefully degrade for older browsers that do not support those timing APIs, but it has not been tested yet for browser compatibility.
The library is in alpha stage and the API is subject to change.
Usage
Currently the primary intended usage of OpenCensus Web is to collect spans from the resource timing waterfall of an initial page load and trace on-page user interactions with a series of features like automatic tracing for clicks and route transitions, custom spans, and browser Performance API data. See the OpenCensus Web readme for details.
In the future we would like to support collecting spans for XHRs and other operations made after the initial page load and then join those back to the Resrouce Timing API information for more detailed network timings and events.
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.