process-monitor

process-monitor

Monitors the CPU and memory usage for a PID or collection of PIDs.

Getting Started

(note: this module is not currently available in the npm registry)

Install the module:

npm install git://github.com/onmodulus/process-monitor.git#develop

Use it in your script:

var procmon = require('process-monitor');

Monitor a single PID or mulitple PIDs:

// Single PID
var single = procmon.monitor({ pid: 1, interval: 5000 }).start();

// Multiple PIDs
var multi = procmon.monitor({ pid: [1, 2, 3] }).start();

Handle the stats response - a response will emitted for each of the specified PIDs and includes the PID:

single.on('stats', function(stats) {
  console.dir(stats); // Outputs: { pid: 1, cpu: '0.0', mem: '2248' }
})

Note: if a PID is not found, the resulting cpu and mem properties will be an empty string.

Documentation

Generated code documentation is available in the docs directory. This documentation is generated using docco-husky - to regenerate the documentation, run $ docco-husky lib/*.

Currently the monitor function accepts the following configuration options:

• pid - Either a PID number or an array of PID numbers
• interval - Rate in milliseconds at which the processes are checked and the stats event is emitted (defaults to 1000 ms)

Release History

• 2012/09/14 - v0.1.0 - Initial release.

License

Copyright (c) 2012 Modulus Licensed under the MIT license.