System Administration Commands dlstat(1M) NAME dlstat - report data links statistics 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 links. dladm show-phys lists link names input to dlstat show-phys, dladm show-link lists link names input to dlstat show-link, and dladm show-aggr lists link aggregations input to dlstat show-aggr. dlstat [-r | -t] [-i interval] [link] Iteratively examines all links and reports statistics. The output is sorted in descending order of link utilization. If no link is specified, the system displays statistics for all links. The traffic statistics are displayed per link and not per physical device. For example, for VNIC configured on a physical link, traffic flowing through the VNIC would not reflect in the statistics for the underlying link. However, link stats would be inclusive of traffic matching user defined flows configured on top of that link. -r Display receive side statistics only. Includes bytes and packets received, hardware and software drops etc. See examples for complete listing. -t Display transmit side statistics only. Includes bytes and packets sent, drops etc. See examples below. -i interval Used to specify an interval, in seconds, at which statistics would be refreshed. Default interval is one second. link If specified, display the stats only for the named link. Otherwise, display stats for all links. 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 statistics would be refreshed. Default interval is one second. -p Display using a stable machine-parseable format. -o field[,...] A case-insensitive, comma-separated list of output fields to display. The field name must be one of the fields listed below, or the special value all to display all supported fields. List of supported rx fields: link iusedby ibytes ipkts intrs polls hdrops: hardware drops sdrops: software drops (owing to banwdith enforcement). ch<10: number of packet chains of length < 10. ch10-50: number of packet chains of length between 10 and 50. ch>50: number of packet chains of length > 50. List of tx side fields: link obytes opackets oerrors opktdrop 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 If specified, display the stats only for the named link. 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. -r Display per hardware receive ring statistics. Includes bytes and packets received, hardware drops etc. See examples for complete listing. -t Display per hardware transmit ring side statistics. Includes bytes and packets sent, drops etc. See examples for complete listing. -i interval Used to specify an interval, in seconds, at which statistics would be refreshed. Default interval is one second. -a Dump all show-phys stat fields. -p Display using a stable machine-parseable format. -o field[,...] 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 If specified, display the stats only for the named link. 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. -r Display per hardware receive lane statistics. Includes bytes and packets received, software drops, intr and poll count, chain lengths etc. See examples for complete listing. -F Display software fanout statistics. -t Display per hardware transmit ring side statistics. Includes bytes and packets sent, block and unblock count etc. See examples for complete listing. -i interval Used to specify an interval, in seconds, at which statistics would be refreshed. Default interval is one second. -a Dump all show-link stat fields. -p Display using a stable machine-parseable format. -o field[,...] 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 If specified, display the stats only for the named link. Otherwise, display stats for all links. dlstat show-link -h [-a] -f filename [-d] [-F format] [-s time] [-e time] [link] Show the network usage history from a stored extended accounting file. Configuration and enabling of net accounting through acctadm(1m) is required. The default output will be the summary of network history usage of the existing links for their entire period of time in which extended accounting was enabled. -a Display all historical network usage for the specified period of time while extended accounting is enabled. This includes the usage history information for the links that have already been deleted. -f filename Read extended accounting records of network usage history from filename. -d Display the dates for which there is logging information. The date is in the format MM/DD/YYYY. -F format Specifies the output format of the network usage history information. As of this release, gnuplot is the only supported format. -s time -e time Start and stop times for data display. Time is in the format MM/DD/YYYY,hh:mm:ss. "hh" is using 24-hour clock notation. link If specified, display the historical network usage only for the named link. Otherwise, display historical network usage for all links. 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. -r Display per port receive side statistics. See examples for complete listing of fields displayed. -t Display per port transmit side statistics. See examples for complete listing of fields displayed. -i interval Used to specify an interval, in seconds, at which statistics would be refreshed. Default interval is one second. -p Display using a stable machine-parseable format. -o field[,...] 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 If specified, display the stats only for the named aggr. Otherwise, display stats for all aggrs. EXAMPLES 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 Network usage history statistics can be stored using the extended accounting facility, acctadm(1m). # acctadm -e basic -f /var/log/net.log net # acctadm net Network accounting: active Network accounting file: /var/log/net.log Tracked Network resources: basic Untracked Network resources: src_ip,dst_ip,src_port,dst_port,protocol, dsfield The saved historical data can be retrieved in summary form using: # dlstat show-link -h -f /var/log/net.log LINK DURATION IPACKETS RBYTES OPACKETS OBYTES BANDWIDTH e1000g0 80 1031 546908 0 0 2.44 Kbps ATTRIBUTES See attributes(5) for descriptions of the following attri- butes: /usr/sbin ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsu | |_____________________________|_____________________________| | Interface Stability | See below. | |_____________________________|_____________________________| Screen output is Uncommited. The invocation is Commited. SEE ALSO acctadm(1M), dladm(1M), ifconfig(1M), kstat(1M), netstat(1M), attributes(5)