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.
Please always make sure that TypeScript type definitions match source code modifications.
const zipkin = ;// In Node.js, the recommended context API to use is zipkin-context-cls.const CLSContext = ;const ctxImpl = ; // if you want to use CLSconst xtxImpl = ; // Alternative; if you want to pass around the context manually// Tracer will be a one to many relationship with instrumentation that use it (like express)const tracer =ctxImplrecorder: // For easy debugging. You probably want to use an actual implementation, like Kafka or Scribe.sampler: 001 // sample rate 0.01 will sample 1 % of all incoming requeststraceId128Bit: true // to generate 128-bit trace IDs. 64-bit (false) is defaultlocalServiceName: 'my-service' // indicates this node in your service graph;
Sometimes you have activity that precedes a remote request that you want to
capture in a trace.
tracer.local can time an operation, placing a
corresponding span ID in scope so that any downstream commands end up in the
Here's an example tracing a synchronous function:
// A span representing checkout completes before result is returnedconst result = tracer;
Here's an example tracing a function that returns a promise:
// A span is in progress and completes when the promise is resolved.const result = tracer;