NAME

HostScope

SYNTAX

hostscope [options]

hostscoped [options]

DESCRIPTION

HostScope is a tool to gather and display key system statistics.

Data is made available on the network via multi-casting. I.e. the view of the hostscope client can switch between multiple hosts on the network that run the hostscoped server.

In contrast to 'top' HostScope also provides information about devices and more detailed data on the memory subsystem. On the other hand process statistics is delivered in a more coarse manner, as it provides per user summary of all available processes.

OPTIONS

-i <filename>

CPU METRICS

The following per CPU metrics are displayed by hostscope:
temp CPU temperature in degrees Celsius.
user Percentage of CPU time spend processing user tasks.
syst Percentage of CPU time spend processing system tasks.
nice Percentage of CPU time spend processing with nice priority.
wait Percentage of CPU time spend waiting for I/O to complete.
virt Percentage of CPU time spend processing virtual guests.

MEMORY METRICS

total Total available physical memory.
free Free available physical memory.
swap Total allocated swap size.
swapped Amount of memory swapped to disk.

PAGES AND PAGING METRICS

anon Amount of memory allocated for anonymous pages (pages not backed by files).
files Amount of memory allocated for pages backed by files.
kstack Amount of memory allocated for kernel stack.
shmem Amount of memory allocated for shared memory used for inter-process-communication.
pgpgin Number of pages per second paged in.
pgpgout Number of pages per second paged out.
pgfree Number of pages per second freed.
pgfault Number of pages that had a page fault.

SYSTEM METRICS

fork Number of processes fork()'ed per second.
ctxsw Number of context switches performed.
intr Number of hardware interrupts handled per second.
sirq Number of software interrupts handled per second.

USER METRICS

The following user summary metrics are displayed by hostscope:
nproc Number of processes running under a specific user.
nthr Number of threads running under a specific user.
rss Resident segment size summary for all processes of a user.
shared Summary of all shared pages of all processes of a user.
minflt Number of minor faults per second accumulated accross of all processes of a user.
majflt Number of major faults per second accumulated accross of all processes of a user.
%usr CPU user time percentage of all processes of a user.
%sys CPU system time percentage of all processes of a user.
rchar/s Number of characters read for all processes of a user.
wchar/s Number of characters written for all processes of a user.

STORAGE METRICS

rd/s Number of reads per second performed.
wr/s Number of writes per second performed.
Brd/s Bytes read per second.
Bwr/s Bytes written per second.
size Size of storage device.
opq Operation queue length.
busy Busy load of storage device.

STORAGE METRICS

rx/s Number of packets received per second.
tx/s Number of packets transmitted per second.
Brx/s Number of bytes received per second.
Btx/s Number of bytes transmitted per second.
drop Number of packets dropped per second.
errs Number of errors occurred transmitting or receiving packets.

FILES

/var/tmp/hostscope.pid File that contains the process-id (PID) of the currently running hostscoped process, used to lock against starting multiple telesocped instances.
/var/tmp/telesocpe.log Default location of the log file.

HOMEPAGE

http://www.maier-komor.de/hostscope.html

LICENSE

This software is published under GNU General Public License V3. See file LICENSE for details.

SEE ALSO

top(1)