@opentelemetry/exporter-collector

OpenTelemetry Collector Exporter for web and node

This module provides exporter for web and node to be used with opentelemetry-collector.

Installation

npm install --save @opentelemetry/exporter-collector

Usage in Web

import * as opentelemetry from '@opentelemetry/core';
import { SimpleSpanProcessor } from '@opentelemetry/tracing';
import { WebTracer } from '@opentelemetry/web';
import { CollectorExporter } from '@opentelemetry/exporter-collector'

const collectorOptions = {
  url: '<opentelemetry-collector-url>' // url is optional and can be omitted - default is http://localhost:55678/v1/trace
};

const tracer = new WebTracer();
const exporter = new CollectorExporter(collectorOptions);
tracer.addSpanProcessor(new SimpleSpanProcessor(exporter));

opentelemetry.initGlobalTracer(tracer);

Usage in Node

const opentelemetry = require('@opentelemetry/core');
const { BasicTracerRegistry, SimpleSpanProcessor } = require('@opentelemetry/tracing');
const { CollectorExporter } =  require('@opentelemetry/exporter-collector');

const collectorOptions = {
  url: '<opentelemetry-collector-url>' // url is optional and can be omitted - default is http://localhost:55678/v1/trace
};

const registry = new BasicTracerRegistry();
const exporter = new CollectorExporter(collectorOptions);
registry.addSpanProcessor(new SimpleSpanProcessor(exporter));

opentelemetry.initGlobalTracerRegistry(registry);

Running opentelemetry-collector locally to see the traces

1. Go to examples/basic-tracer-node
2. run npm run collector:docker:ot
3. Open page at http://localhost:9411/zipkin/ to observe the traces

Useful links

• For more information on OpenTelemetry, visit: https://opentelemetry.io/
• For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js
• For help or feedback on this project, join us on gitter

License

Apache 2.0 - See LICENSE for more information.

Changelog

0.3.3

Released 2020-01-22

:rocket: (Enhancement)

• opentelemetry-core, opentelemetry-exporter-collector, opentelemetry-exporter-zipkin, opentelemetry-node, opentelemetry-plugin-dns, opentelemetry-plugin-document-load, opentelemetry-plugin-grpc, opentelemetry-plugin-http, opentelemetry-plugin-https, opentelemetry-plugin-ioredis, opentelemetry-plugin-mongodb, opentelemetry-plugin-mysql, opentelemetry-plugin-postgres, opentelemetry-plugin-redis, opentelemetry-plugin-xml-http-request, opentelemetry-shim-opentracing, opentelemetry-tracing, opentelemetry-types, opentelemetry-web
  • #582 Named Tracers / Tracer Registry
• opentelemetry-node, opentelemetry-plugin-postgres
  • #662 feat: add pg-pool to default list of instrumented plugins
  • #708 Simplify and speed up trace context parsing
• opentelemetry-metrics
  • #700 implement named meter

:sparkles: (Feature)

• opentelemetry-propagator-jaeger
  • #701 add jaeger http trace format
• opentelemetry-exporter-stackdriver-trace
  • #648 Stackdriver Trace exporter

:books: (Refine Doc)

• #673 chore(getting-started): Added a TypeScript version for Getting Started Guide

:bug: (Bug Fix)

• opentelemetry-plugin-ioredis
  • #714 fix: return module exports from ioredis