ZIOMON_UTIL(8)

NAME
ziomon_util - monitoring tool for fcp host adapters.

SYNOPSIS
ziomon_util [-h] [-v] [-V] [-Q <msgq_path> -q <msgq_id> -m <msg_id>] [-s n] [-i n] -d n -a <n> -l <lun>

DESCRIPTION
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.

OPTIONS

-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.

EXAMPLES
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

SEE ALSO
ziomon(8), ziomon_mgr(8), ziomon_zfcpdd(8)