NAME
na.hostmem - network memory buffer pool usage and statistics
DESCRIPTION
na.hostmem reports usage and utilization statistics for the memory buffer pool used by the network routines. These statistics include streams allocation, mbuf usage, etc. By default the agent reads /vmunix to get the kernel namelist.
A reporting interval is specified by the management application. If a reporting interval is not specified, the agent sends a report every 30 seconds.
ATTRIBUTES
The SunOS 4.x version of na.hostmem has three attribute groups, mbuf, mbuf_uses and streams, and one attribute table, dblks.
The SunOS 5.x version of na.hostmem has one attribute group, streams.
The mbuf group reports general statistics about mbuf usage.
mbufused - number of mbufs currently in use (gauge) mbuffree - number of mbufs currently free (gauge) mbuf% - percentage of mbufs currently in use (gauge) mbufmiss - number of mbufs missing (gauge) clused - number of cluster buffers currently in use (gauge) clfree - number of cluster buffers currently free (gauge) cl% - percentage of cluster buffers used (gauge) memused - number of Kbytes allocated to the network currently in use (gauge)
memfree - number of Kbytes allocated to the network currently free (gauge)
mem% - percentage of ``network'' memory currently being used (gauge)
nomem - number of requests for memory that were denied (counter)
delay - (SunOS 4.1.x only) number of requests for memory that were delayed (counter)
drain - (SunOS 4.1.x only) number of calls to protocol drain routines (counter)
space - (SunOS 4.1.x only) number of interface pages obtained from page pool (counter)
The mbuf_uses group reports information about the number of memory buffers used by particular categories of processes.
data - number of mbufs currently allocated to data (gauge) header - number of mbufs currently allocated to packet headers (gauge)
socket - number of mbufs currently allocated to socket structures (gauge)
pcb - number of mbufs currently allocated to protocol control blocks (gauge)
rtable - number of mbufs currently allocated to routing table entries (gauge)
htable - number of mbufs currently allocated to IMP host table entries (gauge)
atable - number of mbufs currently allocated to address resolution table entries (gauge)
ftable - number of mbufs currently allocated to fragment reassembly queue headers (gauge)
soname - number of mbufs currently allocated to socket names and addresses (gauge)
zombie - number of mbufs currently allocated to zombie process information (gauge)
soopts - number of mbufs currently allocated to socket options (gauge)
rights - number of mbufs currently allocated to access rights (gauge)
ifaddr - number of mbufs currently allocated to interface addresses (gauge)
unknown - number of mbufs currently allocated to unknown mbuf types (gauge)
The streams group reports information about streams usage.
strused - number of used streams (gauge) strfree - number of free streams (gauge) str% - percentage of used streams (gauge) strcum - cumulative number of streams allocated (counter) strfail - number of streams allocation failures (counter) qused - number of used queues (gauge)
qfree - number of free queues (gauge)
q% - percentage of used queues (gauge)
qcum - cumulative number of queues allocated (counter) qfail - number of queue allocation failures (counter) mblkused - (SunOS 4.x only) number of used mblks (gauge) mblkfree - (SunOS 4.x only) number of free mblks (gauge) mblk% - (SunOS 4.x only) percentage of used mblks (gauge) mblkcum - (SunOS 4.x only) cumulative number of mblks allocated (counter)
mblkfail - (SunOS 4.x only) number of mblk allocation failures (counter)
msgused - (SunOS 5.x only) used msgs
msgfree - (SunOS 5.x only) free msgs
msg% - (SunOS 5.x only) percent used msgs msgcum - (SunOS 5.x only) cumulative msgs allocated msgfail - (SunOS 5.x only) msgs allocation failures lblkused - (SunOS 5.x only) used linkblks lblkfree - (SunOS 5.x only) free linkblks lblk% - (SunOS 5.x only) percent used linkblks lblkcum - (SunOS 5.x only) cumulative linkblks allocated lblkfail - (SunOS 5.x only) linkblks allocation failures streveused - (SunOS 5.x only) used strevents strevefree - (SunOS 5.x only) free strevents streve% - (SunOS 5.x only) percent used strevents strevecum - (SunOS 5.x only) cumulative strevents allocated strevefail - (SunOS 5.x only) strevents allocation failures
The dblks table reports statistics on the number of allocation requests for data blocks. The key is on the size of the data block, or zero for all data blocks. Under systems prior to SunOS 4.1, valid keys are 0=total, 4, 16, 64, 128, 256, 512, 1024, 2048 and 4096.
size - dblk size in bytes (gauge)
used - number of used dblks (gauge)
free - number of free dblks (gauge)
used% - percentage of used dblks (gauge) cum - cumulative number of dblks allocated (counter) fail - number of dblk allocation failures (counter)
OPTIONS
The SunOS 4.x version accepts one option: the name of an alternate file to use to get the kernel namelist.
The SunOS 5.x version has no options.
ERRORS
can't read kernel memory
The agent uid does not have permission to read kernel memory, /dev/kmem. Run the agent as root (default case if agent started by inetd (1M) ), or give read permission to the uid the agent is running under. The error message can also occur if the agent can't find or read the file containing the kernel namelist.