Visual usage statistics for Illumos-based operating systems using prstat, iostat, etc.
Shell Makefile
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
LICENSE
Makefile
README.md

README.md

Visual Usage

A set of tools to get a visual representation of system utilization on an Illumos based operating system.

These tools are not meant to replace system tools like mpstat(1M), prstat(1M), etc. Instead, these tools should make it easier to identify problems from a thousand foot view, such as running these tools and looking for large spikes of red output.

Usage / Installation

In order to use the scripts the shared functions must be added to the scripts, you can do this by running make.

make

make will load the shared functions into the scripts and place the scripts at the root of the repository. You can then install the scripts globally to /opt/local/bin with:

make install

To uninstall use this:

make uninstall

viszones

View CPU and memory utilization from prstat(1M) per zone

~$ viszones -c 30 -b '#' -z 0 1 5

Report CPU and memory usage on zone 0 for 5 times at 1 second intervals, reserving 30 characters for the bar graph using # as the graph character.

Options

-b <char>    : Character to use for the bar graph
-c <columns> : Number of columns to use for the bar graph
-n           : Disable color output
-h           : Print this help message
-z <zoneid>  : Zone ID to report on

Example

dave @ [ datadyne :: (SunOS) ] ~ $ ./viszones
Zone: 0 (global)
Mem:  [||||||||||||||||||                                               ] 30%
CPU:  [                                                                 ] 0.9%
Total: 67 processes, 548 lwps, load averages: 0.05, 0.06, 0.06

viscores

View CPU utilization per core from mpstat(1M)

~$ viscores 1

Report CPU utilization per core, updating every second.

Options

-b <char>    : Character to use for the bar graph
-c <columns> : Number of columns to use for the bar graph
-n           : Disable color output
-h           : Print this help message

Example

dave @ [ datadyne :: (SunOS) ] ~/dev/visusage $ ./viscores
CPU  0: [|||                                                                             ]   4%
CPU  1: [||||                                                                            ]   6%
CPU  2: [|||                                                                             ]   4%
CPU  3: [||                                                                              ]   3%

visdisks

View Disk utilization per disk from iostat(1M)

~$ visdisks 1

Report disk utilization, updating every second

Options

-b <char>    : Character to use for the bar graph
-c <columns> : Number of columns to use for the bar graph
-n           : Disable color output
-h           : Print this help message

Example

  ramdisk1: [                                                                                ]  0%
       sd0: [                                                                                ]  0%
       sd1: [||||||||||||||||||||||||||||||                                                  ] 38%
Wed Jul 25 09:21:27 UTC 2012

visnet

View network utilization statistics per interface with dladm(1M)

~$ visnet 1

Example

link:                     Rx                     Tx                  total
net0:                 966b/s                 888b/s                  1kb/s
net1:                 124b/s                   0b/s                 124b/s
net2:                 120b/s                   0b/s                 120b/s

Copying

Released under the BSD 3-clause license, see LICENSE for details.