node-perfdump

Grabs all performance test data from a Voisus Server and outputs to CSV for off-line analysis

Installation

git clone git@github.com:astilabs/node-perfdump.git
cd node-perfdump
npm link

Updating

To make sure you are using the latest version you just need to pull down the latest changes and re-run npm link:

git pull
npm link

Usage

perfdump --help

Usage: perfdump [options]

Options:

-h, --help                    output usage information
-V, --version                 output the version number
-s, --server <ip>             server ip address
-n, --scenario <scenario id>  scenario id
-i, --ignore <true/false>     ignore failed tests. default: [true]
-o, --outfile <file>          output path. default: /Users/rossk/perf.csv

Example

[~]$ perfdump -s vbs3.hearvoisus.com -n e673f38989514ccda3bf0ffc82083f17 -o ./out.csv
  - server: vbs3.hearvoisus.com
  - scenario: e673f38989514ccda3bf0ffc82083f17
  - ignore: true
  - outfile: ./out.csv
Connecting to: vbs3.hearvoisus.com on scenario: e673f38989514ccda3bf0ffc82083f17
wrote: Performance_test_report-2
ignored: Performance_test_report-1
Complete

Dumped Data

Currently node-perfdump writes out the following data:

• Test Name
• Total Clients
• Server Version
• Memory
• CPU Count
• Memory Used
• Memory Free
• CPU0 %
• CPU1 %
• CPU2 %
• CPU3 %
• Ace-operator Overruns
• Ace-operator Underruns
• Ace-operator Frame Rate
• Ace-operator Average Frame Rate
• Ace-operator Max Time
• Ace-operator Worst Time
• Ace-operator Average Time
• Ace-Radio Overruns
• Ace-Radio Underruns
• Ace-Radio Frame Rate
• Ace-Radio Average Frame Rate
• Ace-Radio Max Time
• Ace-Radio Worst Time
• Ace-Radio Average Time

Automated tests

perfdump has the option to run automated tests. However there is no commandline tool to run these tests. You must edit the file automated-tests.js which is located under the test folder of the module.

Requirements:

Must provide a voisus server ip where the tests will be performed. Must also provide at least one voisus client ip.

// if not using load balancer, use the host ip for loadBalancer
var server = {
  host: "IPAddress",
  loadBalancer: "IPAddress"
};
//
var client = {
  host_1: "IPAddress",
};

Running:

npm test

Adding tests:

To add more tests simply create a new test case (using mocha framework), and modify the test, radios, clients objects. The test will automatically generate a csv file of each test it runs.

example:

it('should run and automated test with 10 clients', function(done) {
    var d = new Date();
    var timestamp = d.getHours()+'.'+d.getMinutes()+'.'+d.getSeconds();
    var test = {
      name: 'automated_test_1 - '+timestamp,
      duration: test_duration || 30,
      preDelay: test_delay || 10,
      template: 'Basic_Example',
      net: 'Coordination',
      role: 'Role_Ex1'
    };
    var radios = {
      host: server.host,
      freq: 140.6
    };
    var clients = [
      {
        total_clients: 10,
        client_host: client.host_1,
        test_rx: true,
        randomize: false,
        host: server.host
      }
    ];
    createTemplateTest(test, radios, clients, function(err) {
      done();
    });
  });