whs / opencensus-node

A stats collection and distributed tracing framework

OpenCensus Libraries for Node.js

OpenCensus Node.js is an implementation of OpenCensus, a toolkit for collecting application performance and behavior monitoring data. Right now OpenCensus for Node.js supports custom tracing and automatic tracing for HTTP and HTTPS. Please visit the OpenCensus Node.js package for usage.

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

Please join gitter for help or feedback on this project.

Installation

Install OpenCensus with:

npm install @opencensus/nodejs

Plugins

OpenCensus can collect tracing data automatically using plugins. Users can also create and use their own plugins. Currently, OpenCensus supports automatic tracing for:

• HTTP
• HTTPS

Propagation

OpenCensus collects distributed tracing. It is able to do so by propagating span data through services. Currently, OpenCensus supports:

• B3 Propagation
• Stackdriver Propagation
• Trace Context Propagation

Exporters

OpenCensus is vendor-agnostic and can upload data to any backend with various exporter implementations. Even though, OpenCensus provides support for many backends, users can also implement their own exporters for proprietary and unofficially supported backends. Currently, OpenCensus supports:

• Stackdriver
• Zipkin
• Z-Pages
• Jaeger
• Instana

If no exporter is registered in the tracing instance, as default, a console log exporter is used.

Useful links

• For more information on OpenCensus, visit: https://opencensus.io/
• For help or feedback on this project, join us on gitter