@opentelemetry/web

OpenTelemetry Web

This module provides automated instrumentation and tracing for Web applications.

For manual instrumentation see the @opentelemetry/tracing package.

How does automatic tracing work?

This package exposes a class WebTracer that will be able to automatically trace things in Browser only.

See the example how to use it.

OpenTelemetry comes with a growing number of instrumentation plugins for well know modules (see supported modules) and an API to create custom plugins (see the plugin developer guide).

Web Tracer currently supports one plugin for document load. Unlike Node Tracer, the plugins needs to be initialised and passed in configuration. The reason is to give user full control over which plugin will be bundled into web page.

You can choose to use the ZoneScopeManager if you want to trace asynchronous operations.

Installation

npm install --save @opentelemetry/web

Usage

import { ConsoleSpanExporter, SimpleSpanProcessor } from '@opentelemetry/tracing';
import { WebTracer } from '@opentelemetry/web';
import { DocumentLoad } from '@opentelemetry/plugin-document-load';
import { ZoneScopeManager } from '@opentelemetry/scope-zone';

// Minimum required setup - supports only synchronous operations
const webTracer = new WebTracer({
  plugins: [
    new DocumentLoad()
  ]
});

webTracer.addSpanProcessor(new SimpleSpanProcessor(new ConsoleSpanExporter()));

// Changing default scopeManager to use ZoneScopeManager - supports asynchronous operations
const webTracerWithZone = new WebTracer({
  scopeManager: new ZoneScopeManager(),
  plugins: [
    new DocumentLoad()
  ]
});
webTracerWithZone.addSpanProcessor(new SimpleSpanProcessor(new ConsoleSpanExporter()));

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