3 releases

0.0.3 Nov 3, 2022
0.0.2 Aug 31, 2022
0.0.1 Aug 24, 2022

#24 in #distributed-tracing

Download history 181/week @ 2024-04-14 6/week @ 2024-04-21 241/week @ 2024-04-28 283/week @ 2024-05-05 67/week @ 2024-05-12 68/week @ 2024-05-19 55/week @ 2024-05-26 145/week @ 2024-06-02 44/week @ 2024-06-09 42/week @ 2024-06-16 57/week @ 2024-06-23 74/week @ 2024-06-30 197/week @ 2024-07-07 48/week @ 2024-07-14 279/week @ 2024-07-21 132/week @ 2024-07-28

660 downloads per month

MIT license

18KB
422 lines

tctx

npm add tctx makes Trace Contexts simple


⚡ Features

  • Lightweightsee.

  • Efficient — Effective reuse of memory between children see benchmarks.

  • Producer Friendly — Are you a browser? make() and go home.

⚙️ Install

npm add tctx

🚀 Usage

// producer

import { make } from 'tctx';

fetch('/api', {
  headers: {
    traceparent: make(),
  },
});

// consumer

import { parse } from 'tctx';

const parent = parse(request.headers.traceparent);
// Passing true will mark the traceparent as sampled — ends with 01.
const id = parent.child(true);

fetch('/downstream', {
  headers: {
    traceparent: id,
  },
});

💨 Benchmark

via the /bench directory with Node v17.9.0


Validation :: make
✔ tctx
✔ traceparent
✔ trace-context

Benchmark :: make
  tctx                   x 640,126 ops/sec ±0.21% (99 runs sampled)
  traceparent            x 161,062 ops/sec ±0.55% (94 runs sampled)
  trace-context          x 293,268 ops/sec ±0.35% (98 runs sampled)

Validation :: parse
✔ tctx
✔ traceparent
✔ trace-context

Benchmark :: parse
  tctx                   x 5,561,913 ops/sec ±0.14% (100 runs sampled)
  traceparent            x   303,543 ops/sec ±0.42% (91 runs sampled)
  trace-context          x 3,169,835 ops/sec ±0.05% (99 runs sampled)

Validation :: child
✔ tctx
✔ traceparent
✔ trace-context

Benchmark :: child
  tctx                   x 346,827 ops/sec ±0.40% (97 runs sampled)
  traceparent            x 109,942 ops/sec ±0.61% (93 runs sampled)
  trace-context          x 195,381 ops/sec ±0.35% (93 runs sampled)

License

MIT © Marais Rossouw

Dependencies

~165KB