The purpose of the ziorep_utilization report is to provide a central, detailed analysis of adapters' utilizations, errors, and queue fill levels.
The data can be aggregated over time, to make it easier to hunt down resource shortages and critical situations for further analysis. This report uses the data as collected by the ziomon performance monitor, see Collecting FCP performance data with ziomon, and displays the data in a comprehensible manner.
ziorep_utilization syntax >>-ziorep_utilization--+-------------+--+-----------+--+------------+--> '- -b <begin>-' '- -e <end>-' '- -i <time>-' .- ---------------. V | >--+-----+--+-----+----+-------------+-+--+-----------+-- <filename>->< '- -x-' '- -s-' '- -c <chpid>-' '- -t <num>-'
where:
- -b <begin> or --begin=<begin>
- reports data starting from <begin>. Defaults to the start of available data. The format is YYYY-MM-DD HH:MM[:SS], for example, -b "2008-03-21 09:08". The actual dates used will be rounded to the nearest data collection frame. That is, if you started the data collection at 17:00:00 with an interval length of 15 seconds, a specified time of 17:01:32 would be rounded to 17:01:30.
- -e <end> or --end=<end>
- reports data ending at <end>. Defaults to end of available data. Format is YYYY-MM-DD HH:MM[:SS], for example: -e "2008-03-21 09:08:57"
- -i <time> or--interval <time>
- sets the aggregation interval to <time> in seconds.
Must be a multiple of the interval size of the source data. Set to
0 to aggregate over all data.
When the source data was collected using ziomon, a value was specified for the duration between two consecutive data samples. Using -i it is possible to aggregate that source data to achieve a more coarse resolution. Specifying anything other than a multiple or 0 will result in an error.
- -s or --summary
- shows a summary of the data.
- -c or --chpid <chpid>
- specifies the FCP channel as specified in the IODF. The format is a two-byte hexadecimal number, for example -c 32a. You can specify multiple FCP channels by using multiple -c command line switches.
- -x or --export-csv
- exports data to files in CSV format.
- -t or --topline <num>
- repeats topline after every ’num’ frames. Specify 0 for no repeat (default).
- <filename>
- The name of the log file from which you want to generate the report.
- -h or --help
- displays short usage text on console. See the ziorep_utilization man page for more details.
- -v or --version
- displays version number on console, and exit.
- -V or --verbose
- displays more information while processing.