The poolstat utility is used to monitor resource utilization when pools are enabled on your system. This utility iteratively examines all of the active pools on a system and reports statistics based on the selected output mode. The poolstat statistics enable you to determine which resource partitions are heavily utilized. You can analyze these statistics to make decisions about resource reallocation when the system is under pressure for resources.
The poolstat utility includes options that can be used to examine specific pools and report resource set-specific statistics.
If zones are implemented on your system and you use poolstat in a non-global zone, information about the resources associated with the zone's pool is displayed.
For more information about the poolstat utility, see the poolstat(8) man page. For poolstat task and usage information, see Reporting Statistics for Pool-Related Resources.
In default output format, the poolstat utility outputs a heading line and then displays a line for each pool. A pool line begins with the pool ID and the name of the pool, followed by a column of statistical data for the processor set attached to the pool. Resource sets attached to more than one pool are listed multiple times, once for each pool.
The column headings for the poolstat utility are as follows:
Pool ID.
Absolute representation of the load that is put on the resource set.
For more information about this property, see the libpool(3LIB) man page.
Maximum resource set size.
Minimum resource set size.
Pool name.
Resource set ID.
Resource set name.
Current resource set size.
Resource set type.
Measure of how much of the resource set is currently used.
This usage is calculated as the percentage of utilization of the resource set multiplied by the size of the resource set. If a resource set has been reconfigured during the last sampling interval, this value might be not reported. An unreported value appears as a hyphen (-).
You can specify the following in poolstat output:
The order of the columns
The headings that appear
You can customize the operations performed by the poolstat utility. You can set the sampling interval for the report and specify the number of times that statistics are repeated:
Specify the number of times that the statistics are repeated. By default, the poolstat utility reports statistics only once.
Tune the intervals for the periodic operations performed by the poolstat utility. All intervals are specified in seconds.
If interval and count are not specified, statistics are reported once. If interval is specified and count is not specified, then statistics are reported indefinitely.