@opencensus/propagation-stackdriver

OpenCensus Stackdriver Propagation for Node.js

OpenCensus Stackdriver Propagation allow other services to create spans with the right context.

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

Installation

Install OpenCensus Stackdriver Propagation with:

npm install @opencensus/propagation-stackdriver

Usage

To propagate span context arround services with Stackdriver Propagation, pass an instance of Stackdriver Propagation to your tracing instance. For Javascript:

const tracing = require('@opencensus/nodejs');
const propagation = require('@opencensus/propagation-stackdriver');

const sd = propagation.v1;

tracing.start({propagation: sd});

Similarly for Typescript:

import * as tracing from '@opencensus/nodejs';
import * as propagation from '@opencensus/propagation-stackdriver';

const sd = propagation.v1;

tracing.start({propagation: sd});

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.13 - 2019-05-20

• Exporter/Stats/Prometheus: Fix missing tags for HTTP metrics
• http-instrumentation: add support for the addition of custom attributes to spans
• Set CurrentRootSpan correctly
• Chore: update GRPC to 1.12.3
• Fix: handle infinite loop caused by get traceState()
• Chore: upgrade engines field to >=8
• Chore: Fix js-yaml vulnerability from Codecov
• Change CLS import to do stats type more general

This release has a breaking change. Please test your code accordingly after upgrading.

• Remove Span's startChildSpan(nameOrOptions?: string|SpanOptions, kind?: SpanKind) interface, now only SpanOptions object interface is supported.