APPENDIX A

Kernel Reader

This appendix provides a summary of the Kernel Reader data hierarchy.

Kernel Reader Data Hierarchy

The Kernel Reader is one of the three system agents. Use the information in this appendix if you want to write event rules that monitor the output of the Kernel Reader.

TABLE A-1 lists the Kernel Reader hierarchy.

The first column contains the name of the node or property.

The second column specifies whether the parameter is a node (N) or a property (P). A node in the hierarchy is a starting point for a branch of the hierarchy. All properties that belong to a node appear below the node and are marked with a P. For example, cpu.busy and cpu.user fall under the cpu node. The node and its properties are grouped together.

The third column lists the value type. The Kernel Reader generates five types of values:

• (I) Instant value at the sample time
• (S) Summary over the last sample interval
• (A) Average value over last sample interval
• (%) Percentage value (100.0 == 100%) over the last sample interval
• (R) Rate value (per second) over the last sample interval

The fourth column describes the node or property.

TABLE A-1

Name of Node or Property	Node or Property	Value Type	Description
KernelReader	N		Kernel Reader root
control	N		Control information
control.pid	P	I	Process ID for the Kernel Reader
cpu	N		CPU usage over all CPUs
cpu.busy	P	%	CPU busy time (user + system)
cpu.user	P	%	User time
cpu.sys	P	%	System time
cpu.wait	P	%	Wait time
cpu.idle	P	%	Idle time
cpu.ncpu	P	I	Number of CPUs
cpu.context_switch	P	R	Context switches rate
cpu.interrupt	P	R	Interrupts rate
cpu.syscalls	P	R	System call rate
cpu.mutex	P	R	Mutex rate
cpu.forks	P	R	Fork call rate
cpu.execs	P	R	Exec call rate
cpu.swapout	P	R	Number of swapouts per second
cpu.swapin	P	R	Number of swapins per second
cpu.pgout	P	R	Number of page-outs per second
cpu.pgin	P	R	Number of page-ins per second
cpu.pgpgout	P	R	Number of pages paged out per second
cpu.pgpgin	P	R	Number of pages paged in per second
cpu.run_queue_length	P	A	Number of jobs waiting to be run
cpu.swap_queue_length	P	A	Number of jobs waiting for page swap
cpu.io_queue_length	P	A	Number of jobs waiting for I/O
cpu.cpuX	N		Individual CPU data (X=0, 1, 2...)
cpu.cpuX.instance	P	I	CPU instance (the X in the label)
cpu.cpuX.busy	P	%	CPU busy time (user + system)

TABLE A-1 (Continued)

Name of Node or Property	Node or Property	Value Type	Description
cpu.cpuX.user	P	%	User time (100.00 == 100%)
cpu.cpuX.sys	P	%	System time
cpu.cpuX.wait	P	%	Wait time
cpu.cpuX.idle	P	%	Idle time)
cpu.cpuX.context_switch	P	R	Context switches rate
cpu.cpuX.interrupt	P	R	Interrupts rate
cpu.cpuX.syscalls	P	R	System call rate
cpu.cpuX.mutex	P	R	Mutex rate
cpu.cpuX.forks	P	R	Fork call rate
cpu.cpuX.execs	P	R	Exec call rate
cpu.cpuX.swapouts	P	R	Number of swapouts per second
cpu.cpuX.swapins	P	R	Number of swapins per second
cpu.cpuX.pgpgout	P	R	Number of pages paged out per second
cpu.cpuX.pgpgin	P	R	Number of pages paged in per second
cpu.cpuX.pgout	P	R	Number of page-outs per second
cpu.cpuX.pgin	P	R	Number of page-ins per second
mem	N		Physical memory
mem.mem_avail	P	I	Total memory available (physmem) (Mbytes)
mem.mem_inuse	P	A	Physical memory in use (Mbytes)
mem.mem_inuse_p	P	%	Physical memory in use
mem.mem_free	P	A	Physical memory free (Mbytes)
mem.mem_free_p	P	%	Physical memory free (%)
mem.swap_avail	P	I	Swap space available (Mbytes)
mem.swap_resv	P	I	Swap space reserved (Mbytes)
mem.swap_alloc	P	I	Swap space allocated (Mbytes)
mem.swap_used	P	I	Swap space used (Mbytes)
disk	N		For disk I/O, summary on all disks
disk.ndisk	P	I	Number of disks
disk.ops	P	R	Average disk operations (r+w) rate (op/s)
disk.reads	P	R	Average disk read rate (op/s)

TABLE A-1 (Continued)

Name of Node or Property	Node or Property	Value Type	Description
disk.write	P	R	Average disk write rate (op/s)
disk.nread	P	R	Number of bytes read (bytes/s)
disk.nwritten	P	R	Number of bytes written (bytes/s)
disk.queuelength	P	A	Average disk queue length
disk.waittime	P	A	Average wait time (ms)
disk.runtime	P	A	Average run time
disk.X	N		Individual disks (disk name as label, such as sd3)
disk.X.reads	P	R	Average disk read rate (op/s)
disk.X.write	P	R	Average disk write rate (op/s)
disk.X.nread	P	R	Number of bytes read (Kbytes/s)
disk.X.nwritten	P	R	Number of bytes written (Kbytes/s)
disk.X.busy	P	%	Disk busy
disk.X.svctime	P	A	Average service time (ms)
disk.X.waittime	P	A	Average wait time (ms)
disk.X.runtime	P	A	Average run time (ms)
disk.X.queuelength	P	A	Average queue length
net	N		Network-related values, all interfaces
net.nnet	P	I	Number of net interface
net.oflo	P	R	Overflow error per second
net.uflo	P	R	Underflow error per second
net.crc	P	R	CRC error per second
net.framming	P	R	Frame error per second
net.collisions	P	R	Collisions per second
net.oerrors	P	R	Output errors per second
net.ierrors	P	R	Input errors per second
net.opackets	P	R	Output packet count (packets/second)
net.ipackets	P	R	Input packet count (packets/second)
net.X	N		Each net interface, name as label (for example le0)
net.X.oflo	P	R	Overflow error per second
net.X.uflo	P	R	Underflow error per second

TABLE A-1 (Continued)

Name of Node or Property	Node or Property	Value Type	Description
net.X.crc	P	R	CRC error per second
net.X.framming	P	R	Frame error per second
net.X.collisions	P	R	Collisions per second
net.X.oerrors	P	R	Output error rate
net.X.ierrors	P	R	Input error rate
net.X.opackets	P	R	Output packet count (packets/second)
net.X.ipackets	P	R	Input packet count (packets/second)

If any component of a hierarchy path contains a period ( . ), you may not be able to use the findlist function to find it. For example, if you search for the mount point /export/a0.test reported by the Config Reader via the path: system.slot.board.io-unit.sbi.dma.esp.sd./export/a0.test the node will not be found. Instead, use: system.slot.board.io-unit.sbi.dma.esp.sd.* to find this node.