koa-newrelic

Koa middleware to allow Newrelic monitor Koa applications like Express. Supported features:

• Name transactions according to router (Only support koa-router)
• Group and name transactions for static resources according to file extensions
• Traces for Koa middlewares
• Traces ctx.render

koa 1.x

See koa-newrelic 1.x for koa 1.x support.

Installation

npm install koa-newrelic

API

1const newrelic = require('newrelic');
2const koaNewrelic = require('koa-newrelic')(newrelic, opts);
3const Koa = require('koa');
4const Router = require('koa-router');
5const views = require('koa-views');
6
7const app = new Koa();
8const router = new Router;
9
10router.get('/', async function (next) {...});
11
12app
13  .use(koaNewrelic);
14  .use(views()) // use views middleware could help instrument ctx.render method
15  .use(router.routes());

To record traces of middlewares, please initialize koa-newrelic before adding any middlewares to app or router

Options

• middlewareTrace Boolean for if need traces for each middleware. Defaults to false
• groupStaticResources Boolean for if need to group transactions by file extension. Defaults to false
• staticExtensions Array of file extensions will be grouped if groupStaticResources is true. Defaults to ['svg','png','jpg','gif','css','js','html']
• customTransactionName Function to customize transaction metrics name by method and route path. Defaults to (method, path) => 'Koajs/' + (path[0] === '/' ? path.slice(1) : path) + '#' + method
• renderMethodName name of render method for the framework. Default to render

Examples

1const koaNewrelic = require('koa-newrelic')(newrelic, {
2  renderMethodName: 'render',
3  middlewareTrace: true,
4  groupStaticResources: true,
5  staticExtensions: ['js', 'css'],
6  customTransactionName: (method, path) => `Koajs/${path.slice(1)}#${method}`
7});
8
9router.get('/index', async function ctrA(ctx) {...});
10router.post('/login', async function ctrB(ctx) {...});
11
12app
13	.use(koaNewrelic)
14  .use(serve('/public'));
15  .use(router.routes());
16
17/*
18  In Newrelic, you will find following transactions
19
20    /index#GET
21	  Middleware serve
22	  Middleware dispatch
23	  Middleware ctrA
24
25	/login#POST
26	  Middleware serve
27	  Middleware dispatch
28	  Middleware ctrB
29
30	/*.js#GET
31	  Middleware serve
32
33	/*.css#GET
34	  Middleware serve  
35*/

Test

npm test

Known Issues

License

Copyright (c) 2017 AfterShip

Licensed under the MIT license.