GitXplorerGitXplorer
s

monitor

public
4 stars
0 forks
0 issues

Commits

List of commits on branch develop.
Unverified
e363c77d0fd9aae0c9ce7285bcd093652c0d777c

Fix typo and improve readme.

committed 13 years ago
Unverified
0a093da1c22418297967d8b53ce311f6ef4f8f4b

Fix typo and improve makefile.

committed 13 years ago
Unverified
d9d9207dd8aede2646ece52f719de626f9c27b7b

Fix typo in install.

committed 13 years ago
Unverified
6c814c5b7a181bb1c5d57b28dc85bb93c8c68ff4

Improves the readme again.

committed 13 years ago
Unverified
7b7b24e75591a8aaeb19b56ad1bfbe67ec7c5aa3

Improve readme.

committed 13 years ago
Unverified
5798a9de9348908c52afa9bc144335cc1fcbb48e

Adjust readme to fit github parser.

committed 13 years ago

README

The README file for this repository.
  • Monitor ** NAME : monitor : a simple system statistic wrapper around sar and others.

The source is at [[https://github.com/sathlan/monitor][github]].

** SYNOPSIS Monitor is a system statistics collector. Useful for testing.

: monitor [--help|-h] [--version|-v] : --action|-a <start|stop> : --log|-l : [--command|-d command:arg1,arg2]

** DESCRIPTION This script start a asynchronous sar collect with 1 second interval in the background and another in the foreground as an option.

This is useful while testing a system to collect:

  • every possible statistic with sar;
  • give the user immediate feedback on the particular subsystem the user is testing.

It as the ability to properly kill itself when the tests are terminated.

** USAGE The synopsis and the example describe the usage. The only catch is for the free form command that can be started in the foreground.

The format is : =:=

If one needs any commas in the option string, they should be escaped like this : =,=.

** EXAMPLE Start a disk intensive test. Then, use monitor to collect every statistic in a file, here db.log, and start a =dstat -df -Dsda,dm-0= in the foreground:

: monitor -a start -l db.log -c dstat:-df,-Dsda1_,_dm-0

Notice how the comma is escaped with ,.

The test end, so let's stop the monitoring:

: monitor -a stop

Now, enjoy the billion records you've got in =db.log= in =csv= format:

: sadf -d -P ALL -- -A 1 1000 db.log > metrics.csv

** BUGS The sar utility imply a Linux based system as it's not available in (Free)BSD system. Maybe =dtrace= can fill the gap. If anyone has pointers, there are welcome.

Only one monitor process should be running, but the utility doesn't enforce it.

This utility is Debian based as the =sadc= command path is hardcoded. See =SAR= at the top of the file, to change it

This utility has been tested on Debian Squeeze only.

Fill issues there: https://github.com/sathlan/monitor/issues

** SEE ALSO

  1. =sar=: [[http://sebastien.godard.pagesperso-orange.fr/][sysstat]]
  2. =roundup=: [[http://bmizerany.github.com/roundup/][for the tests.]]

** AUTHOR sathlan mypublicaddress-code@yahoo.com

** COPYRIGHT This software is Copyright (c) 2012 by sathlan.

This is free software, licensed under:

The GNU Lesser General Public License, Version 3, June 2007