Using the zonestat Utility in a Non-Global Zone

Using the `zonestat` Utility in a Non-Global Zone

The zonestat utility reports on the CPU, memory, network, and resource control utilization of the currently running zones. Usage examples follow.

For complete information, see zonestat(1).

The zonestat network component shows the usage of virtual network (VNIC) resources on PHYS, AGGR, Etherstub, and SIMNET data-links by zones. Information on other data-links, such as bridges and tunnels, can be obtained by using the networking utilities described in the dladm(1M) and dlstat(1M) man pages.

All zonestat options and resource types can also be invoked within a non-global zone to display statistics for that zone.

root@zoneA:~# zonestat -z global -r physical-memory 2

Note - When zonestat is used in a non-global zone, the combined resource usage of all other zones, including the global zone, is reported as used by the global zone. Non-global zone users of zonestat are not aware of the other zones sharing the system.

How to Use the `zonestat` Utility to Display a Summary of CPU and Memory Utilization

Become root or assume an equivalent role.

Display a summary of CPU and memory utilization every 5 seconds.

# zonestat -z global -r physical-memory 5
Collecting data for first interval...
Interval: 1, Duration: 0:00:05
PHYSICAL-MEMORY              SYSTEM MEMORY
mem_default                          2046M
                                ZONE  USED %USED   CAP  %CAP
                             [total] 1020M 49.8%     -     -
                            [system]  782M 38.2%     -     -
                              global  185M 9.06%     -     -

Interval: 2, Duration: 0:00:10
PHYSICAL-MEMORY              SYSTEM MEMORY
mem_default                          2046M
                                ZONE  USED %USED   CAP  %CAP
                             [total] 1020M 49.8%     -     -
                            [system]  782M 38.2%     -     -
                              global  185M 9.06%     -     -
...

How to Use the `zonestat` Utility to Report on the Default `pset`

Become root or assume an equivalent role.

Report on the default pset once a second for 1 minute:

# zonestat -r default-pset 1 1m
Collecting data for first interval...
Interval: 1, Duration: 0:00:01
PROCESSOR_SET                   TYPE  ONLINE/CPUS     MIN/MAX
pset_default            default-pset          2/2         1/-
                                ZONE  USED   PCT   CAP  %CAP   SHRS  %SHR %SHRU
                             [total]  0.02 1.10%     -     -      -     -     -
                            [system]  0.00 0.19%     -     -      -     -     -
                              global  0.01 0.77%     -     -      -     -     -
                               zone1  0.00 0.07%     -     -      -     -     -
                               zone2  0.00 0.06%     -     -      -     -     -

...
Interval: 60, Duration: 0:01:00
PROCESSOR_SET                   TYPE  ONLINE/CPUS     MIN/MAX
pset_default            default-pset          2/2         1/-
                                ZONE  USED   PCT   CAP  %CAP   SHRS  %SHR %SHRU
                             [total]  0.06 3.26%     -     -      -     -     -
                            [system]  0.00 0.18%     -     -      -     -     -
                              global  0.05 2.94%     -     -      -     -     -
                               zone1  0.00 0.06%     -     -      -     -     -
                               zone2  0.00 0.06%     -     -      -     -     -

Using `zonestat` to Report Total and High Utilization

Become root or assume an equivalent role.

Monitor silently at a 10–second interval for 3 minutes, then produce a report on the total and high utilizations.

# zonestat -q -R total,high 10s 3m 3m
Report: Total Usage
    Start: Fri Aug 26 07:32:22 PDT 2011
      End: Fri Aug 26 07:35:22 PDT 2011
    Intervals: 18, Duration: 0:03:00
SUMMARY                   Cpus/Online: 2/2   PhysMem: 2046M  VirtMem: 3069M
                    ---CPU----  --PhysMem-- --VirtMem-- --PhysNet--
               ZONE  USED %PART  USED %USED  USED %USED PBYTE %PUSE
            [total]  0.01 0.62% 1020M 49.8% 1305M 42.5%    14 0.00%
           [system]  0.00 0.23%  782M 38.2% 1061M 34.5%     -     -
             global  0.00 0.38%  185M 9.06%  208M 6.77%     0 0.00%
              test2  0.00 0.00% 52.4M 2.56% 36.6M 1.19%     0 0.00%

Report: High Usage
    Start: Fri Aug 26 07:32:22 PDT 2011
      End: Fri Aug 26 07:35:22 PDT 2011
    Intervals: 18, Duration: 0:03:00
SUMMARY                   Cpus/Online: 2/2   PhysMem: 2046M  VirtMem: 3069M
                    ---CPU----  --PhysMem-- --VirtMem-- --PhysNet--
               ZONE  USED %PART  USED %USED  USED %USED PBYTE %PUSE
            [total]  0.01 0.82% 1020M 49.8% 1305M 42.5%  2063 0.00%
           [system]  0.00 0.26%  782M 38.2% 1061M 34.5%     -     -
             global  0.01 0.55%  185M 9.06%  207M 6.77%     0 0.00%
              test2  0.00 0.00% 52.4M 2.56% 36.6M 1.19%     0 0.00%

How to Obtain Network Bandwidth Utilization for Exclusive-IP Zones

The zonestat command used with the -r option and network resource type shows the per-zone utilization of each network device.

Use this procedure to view how much data-link bandwidth in the form of VNICs is used by each zone. For example, zoneB displayed under e1000g0 indicates that this zone consumes resources of e1000g0 in the form of VNICs. The specific VNICs can be displayed by also adding the -x option.

Become a root administrator.

Use the network resource type to the zonestat command with the -r option to display the utilization one time.

    # zonestat -r network 1 1
Collecting data for first interval...
Interval: 1, Duration: 0:00:01

    NETWORK-DEVICE                  SPEED        STATE        TYPE
    aggr1                        2000mbps           up        AGGR
                    ZONE TOBYTE  MAXBW %MAXBW PRBYTE %PRBYTE POBYTE %POBYTE
                  global  1196K      -      -   710K   0.28%   438K   0.18%

    e1000g0                      1000mbps           up        PHYS
                    ZONE TOBYTE  MAXBW %MAXBW PRBYTE %PRBYTE POBYTE %POBYTE
                 [total]  7672K      -      -  6112K   4.89%  1756K   1.40%
                  global  5344K  100m*  42.6%  2414K   1.93%  1616K   1.40%
                   zoneB   992K   100m  15.8%  1336K   0.76%   140K   0.13%
                   zoneA  1336K    50m  10.6%   950K   1.07%      0   0.00%

    e1000g1                      1000mbps           up        PHYS
                    ZONE TOBYTE  MAXBW %MAXBW PRBYTE %PRBYTE POBYTE %POBYTE
                  global   126M      -      -    63M   6.30%    63M   6.30%

    etherstub1                        n/a          n/a   ETHERSTUB
                    ZONE TOBYTE  MAXBW %MAXBW PRBYTE %PRBYTE POBYTE %POBYTE
                 [total]  3920K      -      -      0       -      0       -
                  global  1960K  100M*  1.96%      0       -      0       -
                   zoneA  1960K    50M  3.92%      0       -      0       -

Example Command in Non-Global Zone

Command used in a non-global zone:

root@zoneA:~# zonestat -r network -x 1 1

Skip Navigation Links
Exit Print View
	Oracle Solaris 11.1 Administration: Oracle Solaris Zones, Oracle Solaris 10 Zones, and Resource Management Oracle Solaris 11.1 Information Library

How to Use the zonestat Utility to Display a Summary of CPU and Memory Utilization

How to Use the zonestat Utility to Report on the Default pset

Using zonestat to Report Total and High Utilization