ziomon_util - monitoring tool for fcp host adapters.
ziomon_util [-h] [-v] [-V] [-Q <msgq_path> -q
<msgq_id> -m <msg_id>] [-s n] [-i n] -d n -a <n> -l
<lun>
ziomon_util monitors various sysfs attributes for a
configurable duration. Output can be written to stdout or alternatively sent
to a message queue in binary format.
This command is not intended to be run on its own - rather use the
ziomon command.
- -h or --help
- Print help information, then exit.
- -v or
--version
- Print version information, then exit.
- -V or
--verbose
- Be verbose.
- -a or
--adapter
- Number of the adapter to monitor. That is,
/sys/class/scsi_host/host<n> must exist.
- -l or --lun
- watch I/O error count of specified LUN. Specify each LUN separately in
h:b:t:l format. That is, /sys/bus/scsi/devices/h:b:t:l/ioerr_cnt
must exist.
- -s or
--sample-length
- Time to elapse between samples in seconds.
- -i or
--interval-length
- Time to elapse between sending data in seconds. The samples will be
aggregated over this period. Defaults to the duration. The interval lengh
must be a multiple of the sample length.
- -d or
--duration
- Overall monitoring duration in seconds. The duration must be a multiple of
the interval length.
- -Q or
--msg-queue-name
- Name for the message queue to use. Note that the usage of a message queue
for the output requires that all of parameters -Q, -q and -m are
specified.
- -q or
--msg-queue-id
- Id for the message queue to use. Must be an integer >0. Note that the
usage of a message queue for the output requires that all of parameters
-Q, -q and -m are specified.
- -m or
--msg-id
- Id for the messages to use when sending to a message queue. Must be an
integer >0. Note that the usage of a message queue for the output
requires that all of parameters -Q, -q and -m are specified.
Monitor adapter 1 and the LUN at 0:0:1:2057 for 5 minutes, sample
every 4 seconds and send the data every 20 seconds to a message queue. The
message queue is named /tmp/ziomon.23943, the id is 95 and the the messages
should carry the id 17:
ziomon_util -s 4 -i 20 -d 300 -Q /tmp/ziomon.23943 -q 95 -m 17 -a
1 -l 0:0:1:2057 -L 18