ziomon/ziorep_utilization.8

   1 .TH ZIOMON_MGR 8 "Jul 2008" "s390-tools"
   2
   3 .SH NAME
   4 ziorep_utilization \- Utilization report for FCP adapters.
   5
   6 .SH SYNOPSIS
   7 .B ziorep_utilization
   8 [-V] [-v] [-h] [-b <begin>] [-e <end>] [-i <time>] [-s] [-c <chpid>] [-x] [-t <num>] <filename>
   9
  10 .SH DESCRIPTION
  11 .B ziorep_utilization
  12 Prints a report from the specified data.
  13
  14 .SH OPTIONS
  15 .TP
  16 .BR "\-h" " or " "\-\-help"
  17 Print help information, then exit.
  18
  19 .TP
  20 .BR "\-v" " or " "\-\-version"
  21 Print version information, then exit.
  22
  23 .TP
  24 .BR "\-V" " or " "\-\-verbose"
  25 Be verbose.
  26
  27 .TP
  28 .BR "\-b" " or " "\-\-begin"
  29 Limit the timeframe to consider to data beginning with the specified date.
  30 .br
  31 Dates must be specified in the following format: YYYY-MM-DD HH:MM[:SS].
  32 .br
  33 E.g. 2008-03-21 09:08 is 9:08 on March 21, 2008.
  34
  35 .TP
  36 .BR "\-e" " or " "\-\-end"
  37 Limit the timeframe to consider to data ending with the specified date.
  38 .br
  39 Dates must be specified in the following format: YYYY-MM-DD HH:MM[:SS].
  40 .br
  41 E.g. 2008-03-21 09:08 is 9:08 on March 21, 2008.
  42
  43 .TP
  44 .BR "\-i" " or " "\-\-interval"
  45 Specify an aggregation interval. The interval is given in seconds, and must be a multiple
  46 of the interval as found in the source data.
  47
  48 .TP
  49 .BR "\-s" " or " "\-\-summary"
  50 Print a summary of the data, then exit.
  51
  52 .TP
  53 .BR "\-c" " or " "\-\-chpid"
  54 Only consider the specified physical adapter. Adapters must be specified in hex.
  55 If multiple adapters should be specified, specify each one separately.
  56
  57 .TP
  58 .BR "\-x" " or " "\-\-export-csv"
  59 Write data to file(s) in CSV format. Output filenames will be based on the data filename.
  60
  61 .TP
  62 .BR "\-t" " or " "\-\-topline"
  63 Repeat topline after specified number of frames.
  64 0 for no repeat (default).
  65
  66 .SH OUTPUT
  67 Here is a list of the columns and their descriptions.
  68 Timestamps of the frames printed depict the ending of the respective timeframe.
  69
  70 .TP
  71 .BR "adapter in %"
  72 FCP adapter utilization in percent.
  73 .br
  74 .IR "min" ", " "max" " and " avg "
  75 gives the minimum, maximum and average utilization respectively.
  76
  77 .TP
  78 .BR "bus in %"
  79 Bus utilization of the FCP adapter in percent.
  80 .br
  81 .IR "min" ", " "max" " and " avg "
  82 gives the minimum, maximum and average utilization respectively.
  83
  84 .TP
  85 .BR "cpu in %"
  86 Utilization of the cpu on the FCP adapter in percent.
  87 .br
  88 .IR "min" ", " "max" " and " avg "
  89 gives the minimum, maximum and average utilization respectively.
  90
  91 .TP
  92 .BR "qdio util.%"
  93 gives the qdio utilization in percent.
  94 .br
  95 .IR "max" " and " avg "
  96 gives the maximum and average utilization respectively. Note that the minimum value is not reported since it provides no additional information: You will see the number of queue full encounters rise drastically before the minimum becomes non-zero.
  97
  98 .TP
  99 .BR "queue full"
 100 The number of instances where a request to the adapter could not be submitted
 101 due to no empty slots left in the outbound queue.
 102
 103 .TP
 104 .BR "fail"
 105 The number of failures as reported by the FCP adapter.
 106 .br
 107 .IR "erc"
 108 is the number of error recovery conditions.
 109
 110 .TP
 111 .BR "thp in MS/s"
 112 gives the average throughput over time (transmitted data volume / elapsed time), not over number of requests (sum over all request throughputs / number of requests)! This means that a long-running request with a significantly different throughput profile from the rest will have a bigger impact as a brief one with the same throughput profile would. This gives a better impression of the overall profile and especially makes requests with very low throughputs have a bigger impact, making it easier to detect anomalies.
 113 .br
 114 .IR "rd" " and " "wrt"
 115 give the values for read and write requests respectively.
 116
 117 .TP
 118 .BR "I/O reqs"
 119 give the number of I/O requests processed in the respective interval.
 120 .br
 121 .IR "rd" " and " "wrt"
 122 give the values for read and write requests respectively.
 123
 124
 125 .SH EXAMPLES
 126 Print a utilization report using
 127 .IR sample.log
 128 , considering adapters 4e and 4f only.
 129 Only data between 8:57 April 5, 2008, and 17:09 June 21, 2008, should be considered.
 130 Data should be aggregated to 60 second intervals.
 131
 132 ziorep_utilization -c 4e -c 4f -i 60 -b "2008-04-05 08:57" -e "2008-06-21 17:09"
 133
 134
 135 .SH "SEE ALSO"
 136 .BR ziorep_config (8),
 137 .BR ziorep_traffic (8)