ziorep_traffic - Analyze systems I/O traffic through FCP channels

Edit online

The ziorep_traffic command produces a report that provides a central, detailed analysis of the systems I/O traffic through FCP channels.

The main focus is on the latencies as they appear in the channel, fabric, or the whole I/O subsystem. The data can be:
  • Aggregated over time
  • Reduced to certain devices only
This report uses data as collected by the ziomon utility (see Collecting FCP performance data with ziomon).
Figure 1. ziorep_traffic syntax

1  ziorep_traffic?  -b <begin>?  -e <end>?  -i <time> ? +   -c <chpid>? +   -u <id>? +   -p <port> ? +   -l <lun>? +   -d <fdev>? +   -m <mdev>?  -t <num> ?  -x?  -s?  -D?  -C
2.1  a
2.1  u
2.1  p
2.1  m
2.1  A  <filename>

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.

-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 -c multiple times.
-u or --bus-id <ID>
specifies a device bus ID of an FCP device, for example: -u 0.0.7f1d
-p or --port <port>
specifies by target port, for example: -p 0x500507630040710b
-l or --lun <LUN>
specifies by LUN, for example: -l 0x4021402200000000
-d or --device <fdev>
specifies by SCSI device, for example: -d sda
-m or --mdev <mdev>
selects by multipath device, for example: -m 36005076303ffc1040002120
-t or --topline <num>
repeats topline after every ’num’ frames. Specify 0 for no repeat (default).
-x or --export-csv
exports data to files in CSV format.
-s or --summary
shows a summary of the data.
-D or --detailed
prints histograms instead of univariate statistics.
-C or --collapse <val>
collapses data for multiple instances of a device into a single one. See Aggregating data for the a, u, p, m, and A options. See the ziorep_traffic man page for more details.
<filename>
The name of the log file from which you want to generate the report.
-h or --help
displays a short usage text on console. For more details, see the ziorep_traffic man page.
-v or --version
displays the version on the console, and exit.
-V or --verbose
displays more information while processing.