zipkin

zipkin

This is the core npm package for Zipkin. It contains the public API which is used by the various plugins (instrumentations and transports).

We include TypeScript definition file which you can also use as documentation.

Developing

Please always make sure that TypeScript type definitions match source code modifications.

Usage

const zipkin = require('zipkin');

// In Node.js, the recommended context API to use is zipkin-context-cls.
const CLSContext = require('zipkin-context-cls');
const ctxImpl = new CLSContext(); // if you want to use CLS
const xtxImpl = new zipkin.ExplicitContext(); // Alternative; if you want to pass around the context manually

const tracer = new zipkin.Tracer({
  ctxImpl,
  recorder: new zipkin.ConsoleRecorder(), // For easy debugging. You probably want to use an actual implementation, like Kafka or Scribe.
  sampler: new zipkin.sampler.CountingSampler(0.01), // sample rate 0.01 will sample 1 % of all incoming requests
  traceId128Bit: true // to generate 128-bit trace IDs. 64-bit (false) is default
});