Think Thin: Thin Client and Server Based Computing Group Blog

Kent Peacock, one of our illustrious Senior Engineers who helped give birth the to Sun Rays almost 10 years ago in Sun Labs has some great scripts that we use internally for watching how much bandwidth Sun Rays use. I asked him if it would be OK to share these scripts with our user community and he said "Please do!". You can grab a copy the scripts here. (Right click, Save Target/Link As...)

There are two scripts, utbwlist2 and utbw. The utbwlist2 script is for looking at all the Sun Ray devices on a server or host group and utbw is for looking at a single Sun Ray, typically ran by the user of the session from a terminal.

UTBWLIST2

utbwlist2 takes the following options:

-a get information from all members of the failover group
-h <server> target the given server
-f <filter> apply this regular expression filter to the IP addresses of the Sun Rays (useful for selecting subnets)


The output is as follows:

The top block shows bandwidth use of the top Sun Rays, in decreasing order, where:

IP Address is the IP address of one of the top bandwidth consumers
Token/Name is the token presented by the Sun Ray
Pkts/s average packets received per second over the last 20 seconds
Mbps average bandwidth over 20 seconds
KBytes total KBytes received
DTCPU average CPU used on the Sun Ray.

The summary at the end gives totals for either the current server or the server listed using -h, and either just the server or the whole group if -a is present.

The summary block fields are defined as follows:

DTUS:
Active DTUs that have exceeded a small threshhold (1Kbps) of traffic over the last 20 seconds.
Total Total DTUs connected
Idle Number of DTUs that have not exceeded the traffic threshhold in the last minute

Packets:
Lost Total lost packets in last 20 seconds
Total Total packets received by DTUs
RActive "Real" active DTUS (Total - Idle)

Bandwidth Mbps:

Total Total average bandwidth across all Sun Rays in last 20 seconds
Average Average bandwidth per active Sun Ray
Ravg Average bandwidth per RActive Sun Ray

DTU CPU Total per-DTU average CPU use.


UTBW

The output of the utbw program applies to a single Sun Ray. It is usually run it in a shell window on the Sun Ray that you want to get the information about. It can also take a token as an argument, and it will monitor the Sun Ray bound to that token. The output contains the following fields (all measurements over the last 20 seconds):

lost 0/00% pkts 278697 cpu 0% kbytes 249436 0.145 Mbps 1.6(1.6) ms

Output decoded as follows:

lost/pct Lost packets and percent of total
pkts Total packets received
cpu DTU cpu used in last 20 seconds
kbytes Kbytes received
Mbps Average bandwidth
xx(yy) Instantaneous latency in milliseconds (xx) and smoothed average (yy)