@zaplabs/opencensus-nodejs-base

OpenCensus for Node.js Base

OpenCensus Node.js Base is an implementation of OpenCensus, a toolkit for collecting application performance and behavior monitoring data.

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 Base with:

npm install @opencensus/nodejs-base

Traces

Automatically Instrumenting an Application

For automatic insturmentation see the @opencensus/nodejs package.

Manually Instrumenting an Application

With @opencensus/nodejs-base you have a full control over instrumentation and span creation. The base package doesn't load Continuation Local Storage (CLS) or any instrumentation plugin by default.

const rootSpanOptions = { name: 'your root span' };
tracing.tracer.startRootSpan(rootSpanOptions, (rootSpan) => {

    // You can create as many child spans as needed
    childSpan = tracing.tracer.startChildSpan({
        name: 'name of your child span'
    });
    // Do some operation...
    // Finish the child span at the end of it's operation
    childSpan.end();

    // Finish the root span at the end of the operation
    rootSpan.end();
});

Tracing Options

See the @opencensus/nodejs package for the full API documentation.

Useful links

• For more information on OpenCensus, visit: https://opencensus.io/
• To checkout the OpenCensus for Node.js, visit: https://github.com/census-instrumentation/opencensus-node
• For help or feedback on this project, join us on gitter

Changelog

0.0.14 - 2019-06-04

• Exporter/Stats/Stackdriver: Add support for exemplar
• exporter-stackdriver: Add support the credentials option used for authentication instead of your application default credentials
• Update dependency @types/nock to v10
• Object Trace Exporter for programatic span access
• Update dependency axios to ^0.19.0 [SECURITY]
• Refactor resource util to match specs
• Update dependency jaeger-client to ~3.15.0
• Trace Context Propagation: return null instead of empty spancontext
• Update dependency gcp-metadata to v2
• Fix duplicate spans issue and clean up
• chore(deps): update dependency nyc to v14.1.1
• chore: add node 12 ci job