@zaplabs/opencensus-exporter-jaeger

OpenCensus Jaeger Trace Exporter

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

• To know more about Jaeger, visit: https://www.jaegertracing.io/docs/1.8/getting-started/
• 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.14 - 2019-06-04

• Exporter/Stats/Stackdriver: Add support for exemplar
• exporter-stackdriver: Add support the credentials option used for authentication instead of your application default credentials
• Update dependency @types/nock to v10
• Object Trace Exporter for programatic span access
• Update dependency axios to ^0.19.0 [SECURITY]
• Refactor resource util to match specs
• Update dependency jaeger-client to ~3.15.0
• Trace Context Propagation: return null instead of empty spancontext
• Update dependency gcp-metadata to v2
• Fix duplicate spans issue and clean up
• chore(deps): update dependency nyc to v14.1.1
• chore: add node 12 ci job