*** psarc.dlstat 2010-02-26 10:02:04.792500077 -0800 --- dlstat.1m.txt 2010-02-26 10:01:37.458065737 -0800 *************** *** 6,21 **** SYNOPSIS dlstat [-r | -t] [-i interval] [link] ! dlstat [-i interval] [-p] [ -o field[,...]] [-u b|B|K|M|G|T|P] ! [link] ! dlstat show-phys [-r | -t] [-i interval] [-p] [ -o field[,...]] ! [-u b|B|K|M|G|T|P] [link] ! dlstat show-link [-r [-F] | -t] [-i interval] [-p] ! [ -o field[,...]] [-u b|B|K|M|G|T|P] [link] dlstat show-link -h [-a] -f filename [-d] [-F format] [-s time] [-e time] [link] dlstat show-aggr [-r | -t] [-i interval] [-p][ -o field[,...]] ! [-u b|B|K|M|G|T|P] [link] DESCRIPTION The dlstat command reports run time statistics about data --- 6,21 ---- SYNOPSIS dlstat [-r | -t] [-i interval] [link] ! dlstat [-a | -A] [-i interval] [-p] [ -o field[,...]] ! [-u R|K|M|G|T|P] [link] ! dlstat show-phys [-r | -t] [-i interval] [-a] ! [-p] [ -o field[,...]] [-u R|K|M|G|T|P] [link] ! dlstat show-link [-r [-F] | -t] [-i interval] [-a] ! [-p] [ -o field[,...]] [-u R|K|M|G|T|P] [link] dlstat show-link -h [-a] -f filename [-d] [-F format] [-s time] [-e time] [link] dlstat show-aggr [-r | -t] [-i interval] [-p][ -o field[,...]] ! [-u R|K|M|G|T|P] [link] DESCRIPTION The dlstat command reports run time statistics about data *************** *** 61,71 **** ! dlstat [-i interval] [-p] [ -o field[,...]] [-u b|B|K|M|G|T|P] ! [link] Supports choosing specific statistics to display. -i interval Used to specify an interval, in seconds, at which --- 61,79 ---- ! dlstat [-a | -A] [-i interval] [-p] [ -o field[,...]] ! [-u R|K|M|G|T|P] [link] Supports choosing specific statistics to display. + -a + Dump all total stat fields. + + -A + Dump all stat fields for this data-link. Output stats of + this command are inclusive of all the stats reported by + all other dlstat commands. + -i interval Used to specify an interval, in seconds, at which *************** *** 105,115 **** blkcnt ublkcnt ! -u b|B|K|M|G|T|P Without this option, stats are outputted in format xy.zU where x, y, z are numbers while U is appropriate unit. -u lets us ! choose unit viz. b:bits, B:bytes, K:Kilobits, M:Megabits,... etc. link --- 113,123 ---- blkcnt ublkcnt ! -u R|K|M|G|T|P Without this option, stats are outputted in format xy.zU where x, y, z are numbers while U is appropriate unit. -u lets us ! choose unit viz. R:Raw numbers, K:Kilo, M:Mega,... etc. link *************** *** 117,124 **** Otherwise, display stats for all links. ! dlstat show-phys [-r | -t] [-i interval] [-p] [ -o field[,...]] ! [-u b|B|K|M|G|T|P] [link] Show statistics for physical device. --- 125,132 ---- Otherwise, display stats for all links. ! dlstat show-phys [-r | -t] [-i interval] [-a] ! [-p] [ -o field[,...]] [-u R|K|M|G|T|P] [link] Show statistics for physical device. *************** *** 140,145 **** --- 148,156 ---- statistics would be refreshed. Default interval is one second. + -a + Dump all show-phys stat fields. + -p Display using a stable machine-parseable format. *************** *** 149,159 **** A case-insensitive, comma-separated list of output fields to display. ! -u b|B|K|M|G|T|P Without this option, stats are outputted in format xy.zU where x, y, z are numbers while U is appropriate unit. -u lets us ! choose unit viz. b:bits, B:bytes, K:Kilobits, M:Megabits,... etc. link --- 160,170 ---- A case-insensitive, comma-separated list of output fields to display. ! -u R|K|M|G|T|P Without this option, stats are outputted in format xy.zU where x, y, z are numbers while U is appropriate unit. -u lets us ! choose unit viz. R:Raw numbers, K:Kilo, M:Mega,... etc. link *************** *** 161,168 **** Otherwise, display stats for all links. ! dlstat show-link [-r [-F] | -t] [-i interval] [-p] ! [ -o field[,...]] [-u b|B|K|M|G|T|P] [link] Show statistics for link. --- 172,179 ---- Otherwise, display stats for all links. ! dlstat show-link [-r [-F] | -t] [-i interval] [-a] ! [-p] [ -o field[,...]] [-u R|K|M|G|T|P] [link] Show statistics for link. *************** *** 189,194 **** --- 200,208 ---- statistics would be refreshed. Default interval is one second. + -a + Dump all show-link stat fields. + -p Display using a stable machine-parseable format. *************** *** 198,208 **** A case-insensitive, comma-separated list of output fields to display. ! -u b|B|K|M|G|T|P Without this option, stats are outputted in format xy.zU where x, y, z are numbers while U is appropriate unit. -u lets us ! choose unit viz. b:bits, B:bytes, K:Kilobits, M:Megabits,... etc. link --- 212,222 ---- A case-insensitive, comma-separated list of output fields to display. ! -u R|K|M|G|T|P Without this option, stats are outputted in format xy.zU where x, y, z are numbers while U is appropriate unit. -u lets us ! choose unit viz. R:Raw numbers, K:Kilo, M:Mega,... etc. link *************** *** 258,264 **** dlstat show-aggr [-r | -t] [-i interval] [-p][ -o field[,...]] ! [-u b|B|K|M|G|T|P] [link] Show per port statistics for an aggr. --- 272,278 ---- dlstat show-aggr [-r | -t] [-i interval] [-p][ -o field[,...]] ! [-u R|K|M|G|T|P] [link] Show per port statistics for an aggr. *************** *** 289,299 **** A case-insensitive, comma-separated list of output fields to display. ! -u b|B|K|M|G|T|P Without this option, stats are outputted in format xy.zU where x, y, z are numbers while U is appropriate unit. -u lets us ! choose unit viz. b:bits, B:bytes, K:Kilobits, M:Megabits,... etc. link --- 303,313 ---- A case-insensitive, comma-separated list of output fields to display. ! -u R|K|M|G|T|P Without this option, stats are outputted in format xy.zU where x, y, z are numbers while U is appropriate unit. -u lets us ! choose unit viz. R:Raw numbers, K:Kilo, M:Mega,... etc. link *************** *** 305,427 **** Example 1 Display statistics To display statistics for all the links, enter following ! command. Statistics are displayed as 3 digit numbers with ! appropriate unit. Default interval is one second. ! # dlstat ! LINK IPKTS IBYTES OPKTS OBYTES UTIL ! e1000g0 21.2K 2.1M 0.5K 44.2M 0.0% ! nxge0 24.5M 13.6G 3.5M 0.1G 0.0% ! vnic1 0.0M 0.0M 0.0M 0.0M 0.0% ! LINK IPKTS IBYTES OPKTS OBYTES UTIL ! e1000g0 21.6K 2.1M 0.5K 46.2M 0.0% ! nxge0 26.5M 26.1G 7.0M 0.3G 0.0% ! vnic1 0.0M 0.0M 0.0M 0.0M 0.0% ! . . . . . . ! . . . . . . ! . . . . . . ! ! Example 2 Display rx side statistics ! ! # dlstat -r ! LINK IPKTS IBYTES INTRS POLLS HDRPS SDRPS CH<10 CH10-50 CH>50 UTIL ! e1000g0 21.2K 2.1M 22.3K 78.0 0.0 0.0 57.0 0.0 0.0 0.0% ! nxge0 24.5M 13.6G 0.8K 10.7M 0.0 0.0 0.3M 2.96M 32.5K 0.0% ! vnic1 24.5M 13.6G 0.8K 10.7M 0.0 0.0 0.3M 2.96M 32.5K 0.0% Example 3 Display per rx hardware ring statistics ! # dlstat show-phys -r nxge0 ! LINK RNG USEDBY IPKTS IBYTES INTRS POLLS HDRPS CH<10 CH10-50 CH>50 UTIL ! nxge0 0 nxge0 0.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 1 nxge0 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 2 nxge0 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 3 nxge0 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 4 vnic1 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 5 vnic1 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 6 vsw1 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 7 vsw1 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! Example 4 Display per rx lane statistics ! # dlstat show-link -r nxge0 ! LINK LNE LTYP IPKTS IBYTES INTRS POLLS SDRPS CH<10 CH10-50 CH>50 UTIL ! nxge0 - local 24.5M 13.6G 0.8K 0.0 0.0 0.0 0.0 0.0 0.0% ! nxge0 - other 24.5M 13.6G 0.8K 0.0 0.0 0.0 0.0 0.0 0.0% ! nxge0 0 hw 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 1 hw 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 2 hw 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! nxge0 3 hw 24.5M 13.6G 0.8K 10.7M 0.0 0.3M 2.96M 32.5K 0.0% ! ! # dlstat show-link -r e1000g0 ! LINK LNE LTYP IPKTS IBYTES INTRS POLLS SDRPS CH<10 CH10-50 CH>50 UTIL ! e1000g0 - local 24.5M 13.6G 0.8K 0.0 0 0 0.0 0.0 0.0 0.0% ! e1000g0 - other 24.5M 13.6G 0.8K 0.0 0.0 0.0 0.0 0.0 0.0% ! e1000g0 - sw 24.5M 13.6G 0.8K 0.0 0.0 0.0 0.0 0.0 0.0% Example 5 Display rx side fanout statistics # dlstat show-link -r -F vnic1 ! LINK LNE LTYP FOUT IPKTS IBYTES ! vnic1 - local 0 24.5M 13.6G ! vnic1 - local 1 24.5M 13.6G ! vnic1 - other 0 24.5M 13.6G ! vnic1 - other 1 24.5M 13.6G ! vnic1 0 hw 0 24.5M 13.6G ! vnic1 0 hw 1 24.5M 13.6G ! vnic1 1 hw 0 24.5M 13.6G ! vnic1 1 hw 1 24.5M 13.6G Example 6 Display tx side statistics ! To display Tx side statistics after every 5 seconds: ! # dlstat -t 5 ! LINK OBYTES OPKTS DROPS BLKCNT UBLKCNT UTIL ! e1000g0 0.0 0.0 0.0 0.0 0.0 0.0% ! nxge0 0.0 0.0 0.0 0.0 0.0 0.0% ! vnic1 0.0 0.0 0.0 0.0 0.0 0.0% ! LINK OBYTES OPKTS DROPS BLKCNT UBLKCNT UTIL ! e1000g0 0.0 0.0 0.0 0.0 0.0 0.0% ! nxge0 0.0 0.0 0.0 0.0 0.0 0.0% ! vnic1 0.0 0.0 0.0 0.0 0.0 0.0% ! LINK OBYTES OPKTS DROPS BLKCNT UBLKCNT UTIL ! e1000g0 0.0 0.0 0.0 0.0 0.0 0.0% ! . . . . . . . ! . . . . . . . ! . . . . . . . Example 7 Display per tx hardware ring side statistics ! # dlstat show-phys -t nxge0 ! LINK RNG USEDBY OBYTES OPKTS BLKCNT UBLKCNT ! nxge0 0 shared 0.5M 13.6G 0.0 0.0 ! . . . . . . . ! . . . . . . . ! . . . . . . . Example 8 Display per tx lane statistics ! # dlstat show-link -t vnic1 ! LINK LNE LTYP OBYTES OPKTS BLKCNT UBLKCNT ! vnic1 0 hw 24.5M 13.6G 0.0 0.0 ! . . . . . . . ! ! ! ! Example 9 Choosing to display statistics of interest ! ! Following command will display a group of statistics fields. ! ! # dlstat show-link -r -o LINK,LNE,LTYP,INTRS,POLLS nxge0 ! LINK LNE LTYP INTRS POLLS ! nxge0 - local 0.8K 10.7M ! nxge0 - other 0.8K 10.7M ! nxge0 0 hw 0.8K 10.7M ! nxge0 1 hw 0.8K 10.7M ! nxge0 2 hw 0.8K 10.7M ! nxge0 3 hw 0.8K 10.7M Example 10 Show historical network usage history --- 319,459 ---- Example 1 Display statistics To display statistics for all the links, enter following ! command. Statistics are displayed as 3 digits followed by ! decimal and then 2 digits with the appropriate unit. ! # dlstat ! LINK IPKTS RBYTES OPKTS OBYTES ! e1000g0 101.88K 32.86M 40.16K 4.37M ! nxge1 4.50M 6.78G 1.38M 90.90M ! vnic1 8 336 0 0 ! ! Example 2 Display rx side statistics every 1 second ! ! # dlstat -r -i 1 ! LINK IPKTS RBYTES INTRS POLLS CH<10 CH10-50 CH>50 ! e1000g0 101.91K 32.86M 87.56K 14.35K 3.70K 205 5 ! nxge1 9.61M 14.47G 5.79M 3.82M 379.98K 85.66K 1.64K ! vnic1 8 336 0 0 0 0 0 ! e1000g0 0 0 0 0 0 0 0 ! nxge1 82.13K 123.69M 50.00K 32.13K 3.17K 724 24 ! vnic1 0 0 0 0 0 0 0 ! . . . . . . . . ! . . . . . . . . ! . . . . . . . . Example 3 Display per rx hardware ring statistics ! # dlstat show-phys -r nxge1 ! LINK TYPE INDEX IPKTS RBYTES ! nxge1 rx 0 21 1.79K ! nxge1 rx 1 0 0 ! nxge1 rx 2 1.39M 2.10G ! nxge1 rx 3 0 0 ! nxge1 rx 4 6.81M 10.26G ! nxge1 rx 5 4.63M 6.97G ! nxge1 rx 6 3.97M 5.98G ! nxge1 rx 7 0 0 ! Example 4 Display per rx lane statistics ! An interface with dedicated hardware lanes. ! ! # dlstat show-link -r nxge1 ! LINK TYPE ID INDEX IPKTS RBYTES INTRS POLLS CH<10 CH10-50 CH>50 ! nxge1 rx local -- 0 0 0 0 0 0 0 ! nxge1 rx hw 1 0 0 0 0 0 0 0 ! nxge1 rx hw 2 1.73M 2.61G 1.33M 400.22K 67.03K 7.49K 38 ! nxge1 rx hw 3 0 0 0 0 0 0 0 ! nxge1 rx hw 4 8.44M 12.71G 4.35M 4.09M 383.28K 91.24K 2.09K ! nxge1 rx hw 5 5.68M 8.56G 3.72M 1.97M 203.68K 43.94K 854 ! nxge1 rx hw 6 4.90M 7.38G 3.11M 1.80M 168.59K 42.34K 620 ! nxge1 rx hw 7 0 0 0 0 0 0 0 ! ! An interface without dedicated hardware lanes i.e. software lane only. ! ! # dlstat show-link -r ixgbe0 ! LINK TYPE ID INDEX IPKTS RBYTES INTRS POLLS CH<10 CH10-50 CH>50 ! ixgbe0 rx local -- 0 0 0 0 0 0 0 ! ixgbe0 rx sw -- 794.28K 1.19G 794.28K 0 0 0 0 Example 5 Display rx side fanout statistics + Consider a 10GbE card configured to run with only 2 of the available rx rings. + # dlstat show-link -r -F vnic1 ! LINK ID INDEX FOUT IPKTS ! ixgbe0 local -- 0 0 ! ixgbe0 hw 0 0 382.47K ! ixgbe0 hw 0 1 0 ! ixgbe0 hw 1 0 367.50K ! ixgbe0 hw 1 1 433.24K Example 6 Display tx side statistics ! To display Tx side statistics every 5 seconds: ! # dlstat -t -i 5 ! LINK OPKTS OBYTES BLKCNT UBLKCNT ! e1000g0 40.24K 4.37M 0 0 ! nxge1 9.76M 644.14M 0 0 ! vnic1 0 0 0 0 ! e1000g0 0 0 0 0 ! nxge1 26.82K 1.77M 0 0 ! vnic1 0 0 0 0 ! . . . . . ! . . . . . ! . . . . . Example 7 Display per tx hardware ring side statistics ! # dlstat show-phys -t nxge1 ! LINK TYPE INDEX OPKTS OBYTES ! nxge1 tx 0 44 3.96K ! nxge1 tx 1 0 0 ! nxge1 tx 2 1.48M 121.68M ! nxge1 tx 3 2.45M 201.11M ! nxge1 tx 4 1.47M 120.82M ! nxge1 tx 5 0 0 ! nxge1 tx 6 1.97M 161.57M ! nxge1 tx 7 4.59M 376.21M ! nxge1 tx 8 2.43M 199.24M ! nxge1 tx 9 0 0 ! nxge1 tx 10 3.23M 264.69M ! nxge1 tx 11 1.88M 153.96M Example 8 Display per tx lane statistics ! # dlstat show-link -t nxge1 ! LINK TYPE ID INDEX OPKTS OBYTES BLKCNT UBLKCNT ! nxge1 tx hw 0 32 1.44K 0 0 ! nxge1 tx hw 1 0 0 0 0 ! nxge1 tx hw 2 1.48M 97.95M 0 0 ! nxge1 tx hw 3 2.45M 161.87M 0 0 ! nxge1 tx hw 4 1.47M 97.25M 0 0 ! nxge1 tx hw 5 3 276 0 0 ! nxge1 tx hw 6 1.97M 130.05M 0 0 ! nxge1 tx hw 7 4.59M 302.80M 0 0 ! nxge1 tx hw 8 2.42M 302.80M 0 0 ! nxge1 tx hw 9 0 0 0 0 ! nxge1 tx hw 10 3.23M 213.05M 0 0 ! nxge1 tx hw 11 1.88M 123.93M 0 0 ! ! Example 9 Choose to display statistics of interest ! ! The following command will display a group of statistics fields. ! ! # dlstat show-link -r -o LINK,TYPE,ID,INDEX,INTRS,POLLS nxge1 ! LINK TYPE ID INDEX INTRS POLLS ! nxge1 rx local -- 0 0 ! nxge1 rx hw 1 0 0 ! nxge1 rx hw 2 2.47M 753.90K ! nxge1 rx hw 3 0 0 ! nxge1 rx hw 4 8.24M 7.72M ! nxge1 rx hw 5 6.96M 3.68M ! nxge1 rx hw 6 5.82M 3.36M ! nxge1 rx hw 7 0 0 Example 10 Show historical network usage history