A stats collection and distributed tracing framework
Branch: master
Clone or download
vigneshtdev and mayurkale22 Add instrumentation for grpc (#343)
* Add Trace Parameters limits

* Improve null checking, naming conventions..Address CR comments.

* Add method to allow for registration of basic GRPC views

* Resolve Conflicts

* fix conflict

* Add end of line

* Add limits for Distribution

* Add Javadoc for all methods. Refactorto directly export functions

* Extra spacing b/w numbers cant be removed

* Fix a few JSDoc comments

* Fix formatting
Latest commit 3638ca5 Feb 15, 2019

README.md

OpenCensus Libraries for Node.js

Gitter chat Node Version NPM Published Version codecov Apache License

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:

Propagation

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

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:

Trace exporters

Stats/Metrics exporters

How to setup debugging Z-Pages?

  • If the application owner wants to export in-process tracing and stats data via HTML debugging pages see this Z-Pages.

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

Versioning

This library follows Semantic Versioning.

GA: Libraries defined at a GA quality level are stable, and will not introduce backwards-incompatible changes in any minor or patch releases. We will address issues and requests with the highest priority. If we were to make a backwards-incompatible changes on an API, we will first mark the existing API as deprecated and keep it for 18 months before removing it.

Beta: Libraries defined at a Beta quality level are expected to be mostly stable and we're working towards their release candidate. We will address issues and requests with a higher priority. There may be backwards incompatible changes in a minor version release, though not in a patch release. If an element is part of an API that is only meant to be used by exporters or other opencensus libraries, then there is no deprecation period. Otherwise, we will deprecate it for 18 months before removing it, if possible.

Alpha: Libraries defined at a Alpha quality level can be unstable and could cause crashes or data loss. Alpha software may not contain all of the features that are planned for the final version. The API is subject to change.

Useful links

LICENSE

Apache License 2.0