@opencensus/exporter-zipkin

OpenCensus Zipkin Exporter allows the user to send collected traces with OpenCensus Node.js to Zipkin.

Usage no npm install needed!

<script type="module">
  import opencensusExporterZipkin from 'https://cdn.skypack.dev/@opencensus/exporter-zipkin';
</script>

README

OpenCensus Zipkin Trace Exporter

Gitter chat

OpenCensus Zipkin Trace Exporter allows the user to send collected traces with OpenCensus Node.js to Zipkin.

Zipkin is a distributed tracing system. It helps gather timing data needed to troubleshoot latency problems in microservice architectures. It manages both the collection and lookup of this data.

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

Installation

Install OpenCensus Zipkin Exporter with:

npm install @opencensus/nodejs
npm install @opencensus/exporter-zipkin

Usage

To use Zipkin as your exporter, first, download from any of the three available options on Quickstart: through Docker, on Java or manually compiling the source code. Tests were executed running Zipkin with Java, through the following commands on terminal:

curl -sSL https://zipkin.io/quickstart.sh | bash -s
java -jar zipkin.jar

Instance the exporter on your application and pass the options, it must contain a service name and, optionaly, an URL. If no URL is passed, http://localhost:9411/api/v2/spans is used as default.

For javascript:

const tracing = require('@opencensus/nodejs');
const zipkin = require('@opencensus/exporter-zipkin');

// Add your zipkin url (ex http://localhost:9411/api/v2/spans)
// and application name to the Zipkin options
const options = {
  url: 'your-zipkin-url',
  serviceName: 'your-application-name'
}
const exporter = new zipkin.ZipkinTraceExporter(options);

Similarly for Typescript:

import * as tracing from '@opencensus/nodejs';
import { Zipkin } from '@opencensus/exporter-zipkin';

// Add your zipkin url (ex http://localhost:9411/api/v2/spans)
// and application name to the Zipkin options
const options = {
  url: 'your-zipkin-url',
  serviceName: 'your-application-name'
}
const exporter = new Zipkin(options);

Now, register the exporter and start tracing.

tracing.start({'exporter': exporter});

or

tracing.registerExporter(exporter).start();

Viewing your traces:

Please visit the Zipkin UI endpoint http://localhost:9411

Useful links