evsstat - Reports statistics of elastic virtual switches (EVS)
evsstat [-f {<fname>=<val>[,...]}[,...] [[-c] -o <field>[,...]]
[-u R|K|M|G|T|P] [-T d|u] [<evsname>[/<vportname>]]
[interval] [count]
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.
The evsstat command has the following options and operands.
If specified, display the statistics only for the named EVS, otherwise, display statistics for all EVS.
If specified, display the statstic only for the VNIC connected to the given vport. To specify vportname, evsname is required.
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:
Filters the vport by tenant name
Filters the vport by EVS name
Filters the vport by host name
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
Display output in a stable, machine-parseable format. –o option is required for this option. See Parseable Output Format, below.
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.
Specify u for a printed representation of the internal representation of time. For more information, see time(2). Specify d for standard date format. For more information, see date(1).
If specified, it denotes the interval at which output rows are refreshed. The first row of the output is the summary that shows the total numbers since a VNIC was connected to virtual port. The second row and beyond show the normalized (per second) statistics. If not specified, you obtain one summary since the creation of the specified link.
Specify the number of times to refresh the statistics. To specify count, interval is required.
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.29KExample 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.90MExample 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.90MExample 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.90MExample 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]
See attributes(5) for descriptions of the following attributes:
|
Screen output is Uncommitted. The invocation is Committed.