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(1M) show-phys provides link-name information to
dlstat show-phys. dladm(1M) show-link provides link-name
information to dlstat show-link. dladm(1M) show-aggr pro-
vides link-aggregation information to dlstat show-aggr.
dlstat has the six forms of commands shown in the SYNOPSIS,
above. The first two forms do not have subcommands, whilethe remain forms do. All six forms are described under "Sub-
commands," below. OPTIONSThe dlstat command has the following options and operands
that are common among a number of command forms shown under "Subcommands," below.-a
Dump all total statistics fields.-i interval
SunOS 5.11 Last change: 11 Mar 2010 1
System Administration Commands dlstat(1M)
Specify an interval in seconds at which statistics are refreshed. The default interval is one second.-o field[,...]
Display a case-insensitive, comma-separated list of out-
put 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: o link o iusedby o ibytes o ipkts o intrs o polls o hdrops: hardware drops o sdrops: software drops (owing to bandwidth enforcement) o ch<10: number of packet chains of length < 10o ch10-50: number of packet chains of length
between 10 and 50 o ch>50: number of packet chains of length > 50 List of TX side fields: o link o obytes o opackets o oerrors o opktdrop o blkcnt o ublkcntSunOS 5.11 Last change: 11 Mar 2010 2
System Administration Commands dlstat(1M)
-p
Display output in a stable, machine-parseable format.
-r
Display receive-side statistics only. Includes bytes and
packets received, hardware and software drops, and so forth. See "Examples" for complete listing.-t
Display transmit-side statistics only. Includes bytes
and packets sent, hardware and software drops, and so forth. See "Examples" for complete listing.-u R|K|M|G|T|P
If used, allows choosing the unit in which to display all statistics, for example, R:raw count, K:Kilobits, M:Megabits, T:Terabits, P:Petabits. If not used, then different units, as appropriate, are used to display the statistics, using the format xy.zU, where x, y, and z are numbers and U is the appropriate unit. link If specified, display the statistics only for the namedlink, physical device (for show-phys), or aggregation
(for show-aggr). Otherwise, display statistics for all
links, devices, or aggregations.SUB-COMMANDS
dlstat supports the following command forms.
dlstat [-r | -t] [-i interval] [link]
Iteratively examine all links and report statistics. Theoutput is sorted in descending order of link utiliza-
tion. 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 a VNIC configured on a physical link, traffic flowing through that VNIC is not reflected inthe statistics for the underlying physical link. How-
ever, the link statistics will include traffic thatmatches user-defined flows configured on top of that
SunOS 5.11 Last change: 11 Mar 2010 3
System Administration Commands dlstat(1M)
link. This command form has one option that is not described under "Options," above:-A
Dump all statistics fields for this data-link. Out-
put statistics of this command are inclusive of allthe statistics reported by all other dlstat com-
mands.dlstat [-a | -A] [-i interval] [-p] [ -o field[,...]] [-u
R|K|M|G|T|P] [link] Allows specifying which statistics to display. The options for this command form are described under "Options," above.dlstat show-phys [-r | -t] [-i interval] [-a] [-p] [ -o
field[,...]] [-u R|K|M|G|T|P] [link]
Display statistics for a physical device. The options for this subcommand are described under "Options," above.dlstat show-link [-r [-F] | -t] [-i interval] [-a] [-p] [ -o
field[,...]] [-u R|K|M|G|T|P] [link]
Display statistics for a link. This subcommand has one option not described under "Options," above:-F Display software fanout statistics.
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. Use of this syntax requires that net accounting has been previously configured and enabled by using acctadm(1M). The default output is the summary ofSunOS 5.11 Last change: 11 Mar 2010 4
System Administration Commands dlstat(1M)
network usage of the existing links for the entire period when extended accounting was enabled. The link argument is as described under "Options," above.-a
Display all historical network usage for the speci-
fied period when extended accounting is enabled. This includes usage information about links that have already been deleted.-f filename
Specify the file from which extended accounting records of network usage history are read.-d
Display the dates for which there is logging infor-
mation. The date is in the format mm/dd/yyyy.-F format
Specify the output format of the network usage his-
tory information. gnuplot is the only supported for-
mat.-s time
-e time
Specify start and stop times for data display. Timeis in the format MM/DD/YYYY,hh:mm:ss. hh uses 24-
hour clock notation.dlstat show-aggr [-r | -t] [-i interval] [-p] [ -o
field[,...]] [-u R|K|M|G|T|P] [link]
Display per-port statistics for an aggregation.
The options for this subcommand are described under "Options," above.SunOS 5.11 Last change: 11 Mar 2010 5
System Administration Commands dlstat(1M)
EXAMPLES
Example 1 Displaying Statistics To display statistics for all the links, enter followingcommand. 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 0Example 2 Displaying RX-side Statistics
The following command displays receive-side statistics every
one 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 Displaying Statistics per Hardware Ring The following commands displays statistics on a perreceive-side hardware ring basis.
# 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.26GSunOS 5.11 Last change: 11 Mar 2010 6
System Administration Commands dlstat(1M)
nxge1 rx 5 4.63M 6.97G nxge1 rx 6 3.97M 5.98G nxge1 rx 7 0 0 Example 4 Displaying Statistics per Lane The following commands displays statistics on a perreceive-side lane basis. First, 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 Then, an interface without dedicated hardware lanes, that is, a 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 Displaying Receive-Side Fanout Statistics
The following command displays receive-side fanout statis-
tics. Consider a 10 Gb Ethernet card configured to run with only two of the available RX rings.# dlstat show-link -r -F vnic1
LINK ID INDEX FOUT IPKTSixgbe0 local -- 0 0
ixgbe0 hw 0 0 382.47K ixgbe0 hw 0 1 0SunOS 5.11 Last change: 11 Mar 2010 7
System Administration Commands dlstat(1M)
ixgbe0 hw 1 0 367.50K ixgbe0 hw 1 1 433.24KExample 6 Displaying Transmit-Side Statistics
The following command displays transmit-side statistics at
five-second intervals.
# 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 Displaying Transmit-Side Ring Statistics
The following command displays transmit-side hardware ring
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.96MExample 8 Displaying Transmit-Side Lane Statistics
SunOS 5.11 Last change: 11 Mar 2010 8
System Administration Commands dlstat(1M)
The following command displays transmit-side lane statis-
tics.# 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 Selecting a Particular Set of Statistics The following command shows how you can select a set of statistics of particular interest.# dlstat show-link -r -o LINK,TYPE,ID,INDEX,INTRS,POLLS nxge1
LINK TYPE ID INDEX INTRS POLLSnxge1 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 Displaying Historical Network Usage Network usage history statistics can be stored by using the extended accounting facility, acctadm(1M), with a command such as the following:# acctadm -e basic -f /var/log/net.log net
acctadm net Network accounting: activeSunOS 5.11 Last change: 11 Mar 2010 9
System Administration Commands dlstat(1M)
Network accounting file: /var/log/net.log Tracked Network resources: basicUntracked Network resources: src_ip,dst_ip,src_port,dst_port,protocol,
dsfield The saved historical data can then be retrieved in summary form with a command such as the following:# dlstat show-link -h -f /var/log/net.log
LINK DURATION IPACKETS RBYTES OPACKETS OBYTES BANDWIDTH e1000g0 80 1031 546908 0 0 2.44 KbpsATTRIBUTES
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 Uncommitted. The invocation is Committed.SEE ALSO
acctadm(1M), dladm(1M), ifconfig(1M), kstat(1M), netstat(1M), attributes(5)SunOS 5.11 Last change: 11 Mar 2010 10