stalk-opentracing-js

OpenTracing for javascript/typescript ecosystem

• Built on top of Javascript OpenTracing API 1.0
• Runs on both node.js and browsers
• Comes with a tracer that can report to:
  • Zipkin HTTP API in JSON format
  • Jaeger Collector HTTP API in jaeger.thrift format over binary thrift protocol (requires modern APIs)
  • Stalk Collector, a dead-simple CORS-friendly server that proxies incoming spans to Jaeger, or Zipkin, or both.
• No dependencies
• Written in typescript, comes with type definitions built-in
• Typescript @Trace decorators offering more smooth instrumentation, which can be independently used from tracer. Because it uses opentracing.globalTracer(), you can use any OpenTracing-compatible tracer you want.

Installation

npm i stalk-opentracing --save

Tutorials

• 01 - Hello world to OpenTracing
• 02 - Using jaeger-client-node
• 03 - Stalk Tracer
• 04 - Sending spans to Zipkin Backend
• 05 - Sending spans to Jaeger Backend
• 06 - Stalk Collector
• 07 - Typescript Decorators
• 08 - Context Propagation
• 09 - Context Propagation w/ Typescript Decorators

Building

• Clone the repo
• Install dependencies npm i
• Build npm run build
• Run tests npm t