koa-trace-influxdb

Tracing for koa-trace using influxdb-udp.

Usage

1var app = koa();
2require('koa-trace')(app);
3
4var traceInflux = require('koa-trace-influxdb');
5app.instrument(traceInflux({
6  port: 4444,
7  host: '127.0.0.1'
8}));
9
10app.use(function* (next) {
11  // set an ID for every request.
12  // optionally, make this a request UUID
13  this.id = '1234';
14
15  // optionally set properties to add to all traces
16  this.traces = {
17    user_id: this.session.user_id.toString('hex')
18  };
19
20  // trace something
21  this.trace('start')
22})

This will create a time series called trace.start. Thus, it tracks each event as a separate series. You probably want to track the elapsed time.

1app.use(function* (next) {
2  var start = Date.now();
3
4  yield* next;
5
6  this.trace('response-time', {
7    elapsed: Date.now() - start
8  });
9});

You may want to build your own helper for this.

Options

• host
• port
• prefix - prefix to add to all the series, defaulting to trace.. If you don't want any prefixes, set it as ''.

Limitations

• The trace arguments must only be a single object, if anything at all.
• UDP is used underneath, so you may lose events. There is no error reporting for logging these.