npm install koa-track
Are you having a hard time keeping track of what happened with a erroring flow?
Then this module if perfect for you. Generate a unique id that identifies a request and spread it along with subsequent requests to different services you might be using.
This way you can identify a flow and see what went wrong.
Use requestId middleware wherever you need to generate an id for an incoming request:
var koa = require("koa");
var koaTrack = require("koa-track");
var koaApp = koa();
var requestId = koaTrack.requestId.middleware;
koaApp.use(koaTrack.requestId.middleware());If you need to spread your tracking information to other servers you can do it with spread utility:
var http = require("http");
var koaTrack = require("koa-track");
var spread = koaTrack.spread.spread({ requestId: { write: true } });
var self = this;
// set up your http request options as usual
var requestOptions = {
hostname: "127.0.0.1",
port: 3000,
path: "/user",
method: "GET"
};
// let spread function override options to embed current request id
requestOptions = spread(self, {options: requestOptions, type: "http-request" });
// execute request as usual
var req = http.request(requestOptions, function(res) {
// on res callback
});How do I achieve a koa application reuse tracking information from a request?
var koaTrack = require("koa-track");
var middleware = koaTrack.spread.middleware({ requestId: { read: true } });
koaApp.use(middleware());Overriding default options for requestId middleware.
koaTrack.requestId.middleware({
headerName : "x-rid" // [String] - optional: Specify header name for request-id
})MIT