Wondering what’s next for npm?Check out our public roadmap! »

express-middleware-server-timing

3.1.0 • Public • Published

express-middleware-server-timing

Automagic expressjs middleware performance monitoring.

There are many server-timing libraries out there for expressjs, but I couldn't find any that provided any out-of-the-box value.

Installation

npm install --save express-middleware-server-timing

Usage

const app = express()

// any time before `app.listen(...)`
require('express-middleware-server-timing')(app, [options])

The following table describes the properties of the options object.

Property Description Type Default
name name of the server timing metric String 'mw'
description description of the server timing metric String undefined
disabled set true if you want to disable Boolean false

A server-timing entry named <name> (with optional description of <description>) will be generated for every request that passes through express.

Manual instrumentation

serverTimingStart / serverTimingStop

To create a server-timing entry reporting the duration between two check points of the same response, try:

app.get(path, function (req, res, next) {
  res.serverTimingStart('foo', 'bar')

  // some time later, maybe in different middleware handler
  res.serverTimingStop('foo')

  // ...
})

A header like this will be written to the response:

Server-Timing: foo; dur=[time in ms]; desc="bar"

serverTimingSync

To create a server-timing entry reporting the duration it took to execute a syncronous method, try:

app.get(path, function (req, res, next) {
  const result = res.serverTimingSync(function() {
    // slow syncronous code here
  }, 'slowMethod1', 'sometimes this method is slow')

  // ...
})

A header like this will be written to the response:

Server-Timing: slowMethod1; dur=[time in ms]; desc="sometimes this method is slow"

Browser Collection

For browsers that suport server-timing (Chrome 65+, Opera 52+), the entries can be accessed like this:

['navigation', 'resource']
  .forEach(function(entryType) {
    performance.getEntriesByType(entryType).forEach(function({name: url, serverTiming}) {
      serverTiming.forEach(function({name, duration, description}) {
        console.info('expressjs middleware =',
          JSON.stringify({url, entryType, name, duration, description}, null, 2))
      })
    })
})

Conditionally disable (example: based on environment)

require('express-middleware-server-timing')(app, {
  disabled: process.env.NODE_ENV === 'production'
})

License

MIT

Install

npm i express-middleware-server-timing

DownloadsWeekly Downloads

45

Version

3.1.0

License

MIT

Unpacked Size

5.74 kB

Total Files

3

Last publish

Collaborators

  • avatar