Lightweight, zero-dependency performance monitoring middleware for Node.js servers. perfmon-lite gives you real-time insight into the event loop, memory usage, and request latency without introducing heavy instrumentation or complex setup.

• Event loop lag tracking powered by perf_hooks.monitorEventLoopDelay
• Memory sampling with configurable warnings for high heap usage
• Request latency measurement with per-route averages
• Optional /metrics JSON endpoint for dashboards and health checks
• Works with Express, Fastify, Koa (via middleware) or plain HTTP servers
• No runtime dependencies; compatible with Node.js 16 and newer

npm install perfmon-lite

const express = require("express");
const { perfMon } = require("perfmon-lite");

const app = express();

app.use(
  perfMon({
    enableLag: true,
    enableMemory: true,
    enableLatency: true,
    metricsRoute: "/metrics",
    alertThresholds: {
      lag: 120,
      memory: 350 * 1024 * 1024,
      latency: 750
    }
  })
);

app.get("/hello", (req, res) => {
  res.json({ message: "world" });
});

app.listen(3000, () => {
  console.log("Server listening on http://localhost:3000");
});

Visit http://localhost:3000/metrics to inspect the metrics endpoint. During development, warnings are logged to the console whenever a threshold is exceeded.

Need monitoring without middleware? Set standalone: true to manage the lifecycle manually:

const { perfMon } = require("perfmon-lite");

const monitor = perfMon({ standalone: true });
monitor.start();

setInterval(() => {
  console.log(monitor.getMetrics());
}, 2000);

perfmon-lite exposes the following metrics through monitor.getMetrics() and the /metrics endpoint:

{
  "uptime": 123.45,
  "eventLoopLag": 7.8,
  "memory": {
    "rss": 123456789,
    "heapTotal": 98765432,
    "heapUsed": 55555555,
    "external": 11111111,
    "arrayBuffers": 2222222
  },
  "latency": {
    "lastRequest": {
      "route": "GET /hello",
      "duration": 45.1
    },
    "average": 32.9,
    "totalRequests": 18,
    "perRoute": {
      "GET /hello": {
        "count": 18,
        "average": 32.9
      }
    }
  }
}

The repository includes /examples/express-demo.js with a runnable Express server showcasing middleware integration and live metrics.

Run the bundled unit tests using the Node.js test runner:

npm test

MIT © Haresh Vidja