My-monitoring is an application based in Node Application Metrics Dashboard(appmetrics-dash). Provides a very easy-to-use web based dashboard to show the performance metrics of your running Node.js application.
If you want to add the dashboard to all HTTP servers created by your application then simply add:
// Before all other 'require' statements:
require('my-monitoring').attach();
to the very top of your main JavaScript source file.
If you want to add the dashboard to one specific HTTP server then use:
var dash = require('my-monitoring');
// Other 'require' statements here
// Create HTTP server 'myHttpServer' here
dash.monitor({server: myHttpServer});
If you are not creating an HTTP server then use:
// Before all other 'require' statements:
require('my-monitoring').monitor();
The data available on the dashboard is as follows:
- CPU Profiling (via a separate tab)
- HTTP Incoming Requests
- HTTP Throughput
- Average Reponse Times (top 5)
- CPU
- Memory
- Heap
- Event Loop Times
- Environment
- Other Requests
- HTTP Outbound Requests
As well as displaying data, it also provides the ability to generate both Node Report and Heap Snapshots directly from the dashboard. The Node Report will display in a new tab in the browser whilst the Heap Snapshot will be written to disk for loading into the Chrome DevTools for analysis. These can both be triggered from the options menu in the top left of the screen
The dashboard uses Node Application Metrics to monitor the application.
Our testing has shown that the performance overhead in terms of processing is minimal, adding less than 0.5 % to the CPU usage of your application. The additional memory required is around 30 MB to gather information about your system and application which is then visualized in the dashboard.
- options {Object} Options are the same as for
dash.monitor()
.
Auto-attach to all http
servers created after this call, calling dash.monitor(options)
for every server.
Simple example using attach
var dash = require('my-monitoring');
dash.attach();
var http = require('http');
const port = 3000;
const requestHandler = (request, response) => {
response.end('Hello')
}
const server = http.createServer(requestHandler);
server.listen(port, (err) => {
if (err) {
return console.log('An error occurred', err)
}
console.log(`Server is listening on ${port}`)
});
To use options, add the object inside attach()
.
var dash = require('my-monitoring');
dash.attach({
url: '',
titlte: '',
...
})
- options.url {String} Path to serve dashboard from. Optional, defaults to
'/appmetrics-dash'
. - options.console {Object} Some messages are printed to the console using
console.log()
andconsole.error()
. Optional, defaults to the globalconsole
object. - options.server {Object} An instance of a node
http
server to serve the dashboard from. Optional, default is to create a server (seeport
andhost
). - options.port {String|Number} Port to listen on if creating a server. Optional,
unused if
server
option is used. - options.host {String} Host to listen on if creating a server. Optional,
unused if
server
option is used. - options.appmetrics {Object} An instance of
require('appmetrics')
can be injected if the application wants to use appmetrics, since it is a singleton module and only one can be present in an application. Optional, defaults to the appmetrics dependency of this module. - options.nodereport {Object} An instance of
require('node-report')
can be injected if the application wants to use node-report, since it is a singleton module and only one can be present in an application. Optional, defaults to the node-report dependency of this module. The ability to generate reports can be disabled by setting this tonull
orundefined
. - options.title {String} Title for the dashboard.
- options.docs {String} URL link to accompanying documentation.
- options.middleware {Object} Pass in middleware function to be used by server.
This module adopts the Module Long Term Support (LTS) policy, with the following End Of Life (EOL) dates:
Module Version | Release Date | Minimum EOL | EOL With | Status |
---|---|---|---|---|
V4.x.x | Jun 2018 | Dec 2019 | Current |
This software are forked from Application Metrics Dashboard project.
The Node Application Metrics Dashboard is licensed using an Apache v2.0 License.