cputilization

sample your cpu utlization continously

CPUtilization

npm install cputilization

This modules sample the cpu utilization. The interface works via callback or event emitter.

use the callback interface if the cpu usage should be sampled only once:

var cpuu = require('cputilization');
 
cpuu(function(errorsample) {
    //returns after 1000ms with the cpu usage of that time interval 
    console.log( sample.percentageBusy() );
});

supply an options hash to specify the time interval:

var cpuu = require('cputilization');
 
cpuu({timeout: 2000}, function(errorsample) {
    //returns after 2000ms 
    console.log( sample.percentageBusy() );
});

if no callback is supplied the cpu utilization will be sampled continously.

a event emitter is returned than, emits a sample event every 1000ms

var cpuu = require('cputilization');
 
var sampler = cpuu();
 
sampler.on('sample', function(sample) {
    console.log( sample.percentageBusy() );
});

an additional options hash can be provided:

  • interval: the ticking interval, default: 1000ms
  • autoStart: automatically start the ticker, default: true
var cpuu = require('cputilization');
 
var sampler = cpuu({interval:100, autoStart: false});
 
sampler.on('sample', function(sample) {
    console.log( sample.percentageBusy() );
});

if the sampler does not start automatically it can be started via the start command:

var cpuu = require('cputilization');
 
var sampler = cpuu({autoStart: false, interval:100});
 
sampler.on('sample', function(sample) {
    //gets executed every 100ms 
    console.log( sample.percentageBusy() );
});
 
sampler.start();

the returned event emitter features a stop method, use that one to stop sampling:

var cpuu = require('cputilization');
 
var sampler = cpuu({interval:100});
 
sampler.on('sample', function(sample) {
    //gets executed every 100ms 
    console.log(sample.percentageBusy());
});
 
sampler.stop();

An CpuSample object is emitted (EventEmitter interface) or returned via tha callback interface.
The following methods are available:

Returns the average CpuUtilization over the specified sampling interval.

Returns the average Cpu Idle percentage of the specified sampling interval.