@opencensus/exporter-jaeger

OpenCensus Exporter Jeager allows user to send collected traces to Jeager

Usage no npm install needed!

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

README

OpenCensus Jaeger Trace Exporter

Gitter chat

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

Jaeger, inspired by Dapper and OpenZipkin, is a distributed tracing system released as open source by Uber Technologies. It is used for monitoring and troubleshooting microservices-based distributed systems, including:

  • Distributed context propagation
  • Distributed transaction monitoring
  • Root cause analysis
  • Service dependency analysis
  • Performance / latency optimization

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

Quickstart

Prerequisites

Jaeger stores and queries traces exported by applications instrumented with Census. The easiest way to start a Jaeger server is to paste the below:

docker run -d \
    -e COLLECTOR_ZIPKIN_HTTP_PORT=9411 \
    -p5775:5775/udp -p6831:6831/udp -p6832:6832/udp \
    -p5778:5778 -p16686:16686 -p14268:14268 -p9411:9411 \
  jaegertracing/all-in-one:latest

Installation

Install OpenCensus Jaeger Exporter with:

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

Usage

Install 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://127.0.0.1:14268/api/traces is used as default.

For ES6:

import tracing from '@opencensus/nodejs';
import { JaegerTraceExporter } from '@opencensus/exporter-jaeger';

const options = {
  serviceName: 'my-service',
  tags: [], // optional
  host: 'localhost', // optional
  port: 6832, // optional
  maxPacketSize: 65000 // optional
}
const exporter = new JaegerTraceExporter(options);

Now, register the exporter and start tracing.

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

or

tracing.registerExporter(exporter).start();

Useful links