File nmon.1.txt of Package nmon

NAME
  nmon - Nigel's performance Monitor for Linux 
SYNOPSIS
  nmon [-h] [-s <seconds>] [-c <count>] [-f -d <disks> -t -r <name>] [-x]
DESCRIPTION
  This systems administrator, tuner, benchmark tool gives you a huge
  amount of important performance information in one go. It can output
  the data in two ways:

  1. On screen (console, telnet, VNC, putty or X Windows) using curses
     for low CPU impact which is updated once every two seconds. You hit
     single characters on you keyboard to enable/disable the various sorts
     of data.
     * You can display the CPU, memory, network, disks (mini graphs or numbers),
       file systems, NFS, top processes, resources (Linux version & processors)
       and on Power micro-partition information.
     * For lots of examples, see the "Screen shots" from the left menu.
     * As you can see on the left lmon12e now in colour 
  2. Save the data to a comma separated file for analysis and longer term data
     capture.
     * Use this together with nmon Analyser Excel 2000 spreadsheet, which loads
       the nmon output file and automatically creates dozens of graphs ready
       for you to study or write performance reports.
     * Filter this data, add it to a rrd database (using an excellent freely
       available utility called rrdtool). This graphs the data to .gif or .png
       files plus generates the webpage .html file and you can then put the
       graphs directly on a website automatically on AIX with no need of a
       Windows based machine.
     * Directly put the data into a rrd database or other database for your
       own analysis

INTERACTIVE MODE COMMANDS
  
  key --- Toggles to control what is displayed ---
  h	Online help information
  r	Machine type, machine name, cache details and OS version + LPAR
  c	CPU by processor stats with bar graphs
  l	long term CPU (over 75 snapshots) with bar graphs
  m	Memory stats
  V	Virtual Memory and Swap stats
  k	Kernel Internal stats
  n	Network stats and errors
  N	NFS Network File System
  d	Disk I/O Graphs
  D	Disk I/O Stats
  o	Disk I/O Map (one character per disk showing how busy it is)
  P	Partitions Disk I/O Stats #ifdef PARTITIONS
  p	Logical Partitions Stats #ifdef POWER
  b	black and white mode (or use -b option)
  "."	minimum mode i.e. only busy disks and processes

  key --- Other Controls ---
  +	double the screen refresh time
  -	halves the screen refresh time
  q	quit (also x, e or control-C)
  0	reset peak counts to zero (peak = ">")
  space	refresh screen now
OPTIONS
  For Interactive-Mode
  -s <seconds> 	between refreshing the screen [default 2]
  -c <number>	of refreshes [default millions]
  -g <filename>	User Defined Disk Groups [hit g to show them]
		* file = on each line: group_name <disks list> space separated
		* like: databse sdb sdc sdd sde
		* upto 32 disk groups, disks can appear more than once
  -b		black and white [default is color]

  For Data-Collect-Mode = spreadsheet format (comma separated values)
  Note: use only one of f,F,z,x or X and make it the first argument
  -f		spreadsheet output format [note: default -s300 -c288]
  		output file is <hostname>_YYYYMMDD_HHMM.nmon
  -F <filename>	same as -f but user supplied filename
  -r <runname>	goes into spreadsheet file [default hostname]
  -t		include top processes in the output
  -T		as -t plus saves command line arguments in UARG section
  -s <seconds>	between snap shots
  -c <number>	of refreshes
  -d <disks>	to increase the number of disks [default 256]
  -l <dpl>	disks/line default 150 to avoid spreadsheet issues. EMC=64.
  -g <filename>	User Defined Disk Groups (see above)
  -N		include NFS Network File System
  -I <percent>	Include precoess and disks busy threshold (default 0.1)
		don't save or show proc/disk using less than this percent
  -m <dir>	nmon changes to this directory before saving to file
  -D		Skip disk configuration sections

  Capacity planning mode - use cron to run each day
  -x		sensible spreadsheet output for CP =  one day
		every 15 mins for 1 day ( i.e. -ft -s 900 -c 96)
  -X		sensible spreadsheet output for CP = busy hour
		every 30 secs for 1 hour ( i.e. -ft -s 30 -c 120)
ENVIRONMENT
  NMON		Startup Control, issues the toggles every time nmon starts
		For example: export NMON=cmdrvtan
  NMONCMD[0..63]	The program names nmon will list

EXAMPLE
  Refresh every second and exit it after 100 seconds.

	$ nmon -s 1 -c 100

  Collect for 1 hour at 30 second intervals with top procs

	$ nmon -f -t -r Test1 -s30 -c120
HINTS
  1. To stop nmon: $ kill -USR2 <nmon-pid>
  2. Use -p and nmon outputs the background process pid
  3. To limit the processes nmon lists (online and to a file)
     Either set NMONCMD0 to NMONCMD63 to the program names
     or use -C cmd:cmd:cmd etc. example: -C ksh:vi:syncd
  4. To pipe nmon output to other commands use a FIFO:

	$ mkfifo /tmp/mypipe

	$ nmon -F /tmp/mypipe &

	$ grep /tmp/mypipe
  5. If nmon fails please report it with:
	* nmon version like: 14f
	* the output of cat /proc/cpuinfo
	* some clue of what you were doing
	* I may ask you to run the debug version
LICENSE
  nmon is free software; you can redistribute it and/or modify it
  under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 3 of the License, or
  (at your option) any later version.

  nmon is distributed in the hope that it will be useful, but WITHOUT
  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  or FITNESS FOR A PARTICULAR PURPOSE.
  See the GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program. If not, see http://www.gnu.org/licenses/.

AUTHOR
  nmon was written by Nigel Griffiths <nag@uk.ibm.com>

  This manual page was written by Stefan Jakobs <projects@localside.net>