evsstat (1M)

Name

evsstat - Reports statistics of elastic virtual switches (EVS)

Synopsis

evsstat [-f {<fname>=<val>[,...]}[,...] [[-c] -o <field>[,...]]
             [-u R|K|M|G|T|P] [<evsname>[/<vportname>]] [interval] [count]

Description

The evsstat command reports run time statistics of each vport of the EVS. It basically reports the statistics of VNICs associated with the vports. For more information on EVS and Virtual ports, please refer to evsadm manpage.

The evsstat command is a Remote Administration Daemon (RAD) client, and it communicates with a remote EVS controller to execute all the evsstat subcommands. Before using evsstat, one has to specify a resolvable hostname or the IP address of the EVS controller.

evsadm set-prop -p controller=<hostname>

One other thing we need to do is to setup SSH authentication with pre-shared keys between the host (where evsstat will be executed) and the EVS controller.

For all valid fields, evsstat displays numerical value. It displays '--' for value which is not applicable. It displays '?' for value which is unknown.

evsstat has the forms of command shown in the SYNOPSIS, above.

Options

The evsstat command has the following options and operands.

evsname

If specified, display the statistics only for the named EVS, otherwise, display statistics for all EVS.

vportname

If specified, display the statstic only for the VNIC connected to the given vport. To specify vportname, evsname is required.

–f {<fname>=<val>[,...]}[,...], –-filter {<fname>=<val>[,...]}[,...]

A comma-separated name-value pairs used to filter the output (Row selection). If multiple filters are specified, then the displayed output is a result of AND operation among the filters. If the filter value is multi-valued, then the displayed output is a result of OR operation among the filter values. The supported filters are:

tenant

Filters the vport by tenant name

evs

Filters the vport by EVS name

host

Filters the vport by host name

–o field[,...], –-output=field[,...]

Display a case-insensitive, comma-separated list of out- put fields to display (Column seleciton). The field name must be one of the fields listed below, or the special value all to display all supported fields. List of supported fields:

• vport

• evs

• tenant

• vnic

• host

• ipkts

• rbytes

• opkts

• obytes

• idrops

• odrops

–c, –-parseable

Display output in a stable, machine-parseable format. –o option is required for this option. See Parseable Output Format, below.

-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.

interval

Specify an interval in seconds at which statistics are refreshed.

count

Specify the number of times to refresh the statistics. To specify count, interval is required.

Examples

Example 1 Displaying Statistics

The following command displays statistics for all the EVS. Statistics are displayed as 3-digits followed by decimal and then 2 digits with the appropriate unit.

# evsstat

VPORT        EVS   TENANT      IPKTS    RBYTES   OPKTS  OBYTES
sys-vport0   evs0  sys-tenant  101.88K  32.86M   40.16K 4.37M
sys-vport2   evs0  sys-tenant    4.50M   6.78G    1.38M 90.90M
sys-vport0   evs1  sys-tenant  132.89K  12.25M      236 15.82K
sys-vport1   evs1  sys-tenant  144.47K  13.32M      247 16.29K

Example 2 Displaying Statistics of one EVS

The following command displays the statistics of all the vports of an EVS evs0.

# evsstat evs0

VPORT         EVS   TENANT      IPKTS    RBYTES   OPKTS   OBYTES
sys-vport0    evs0  sys-tenant  101.88K  32.86M   40.16K   4.37M
sys-vport2    evs0  sys-tenant    4.50M   6.78G    1.38M  90.90M

Example 3 Displaying Statistics of one vport

The following command displays the statistics of one vport

# evsstat evs0/sys-vport2

VPORT        EVS   TENANT       IPKTS   RBYTES   OPKTS OBYTES
sys-vport2   evs0  sys-tenant   4.50M   6.78G    1.38M 90.90M

Example 4 Refresh Statistics

The following command refresh the statistics of a vport with interval 1 second for 3 times.

# evsstat evs0/sys-vport2 1 3

VPORT         EVS   TENANT       IPKTS   RBYTES   OPKTS OBYTES
sys-vport2    evs0  sys-tenant   4.50M   6.78G    1.38M 90.90M
sys-vport2    evs0  sys-tenant   4.50M   6.78G    1.38M 90.90M
sys-vport2    evs0  sys-tenant   4.50M   6.78G    1.38M 90.90M

Example 5 Selecting a Particular Set of Statistics

The following command shows how you can select a set of statistics or information of particular interest.

# evsstat -o vport,evs,vnic,host,ipkts,opkts
     
VPORT              EVS         VNIC       HOST  IPKTS   OPKTS
sys-vport0         evs0        vnic0      host1 101.88K  40.16K
sys-vport2         evs0        vnic0	  host2   4.50M   1.38M
sys-vport0         evs1        vnic1      host1 132.89K    236
sys-vport1         evs1        vnic1      host2 144.47K    247

Example 6 Displaying Help

The following command display the usage of evsstat

# evsstat help
evsstat [-f {<fname>=<val>[,...]}[,...] [[-c] -o <field>[,...]]
   [-u R|K|M|G|T|P] [<evsname>[/<vportname>]] [interval] [count]

Attributes

See attributes (5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Availibilty service/network/evs Interface Stability See below

Screen output is Uncommitted. The invocation is Committed.

See also

evsadm(1M), kstat(1M), dladm(1M), attributes (5)