Skip to main content

statistics show

Contributors
Suggest changes

Display performance data for a time interval

Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

Description

This command displays performance data for a period of time .

To display data for a period of time, collect a sample using the statistics start and statistics stop commands. The data that displays is calculated data based on the samples the cluster collects. To view the sample, specify the -sample-id parameter.

Parameters

[-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-tab ] (privilege: advanced) }

If this parameter is specified, the command displays performance data in tabular format.

[-object <text>] - Object (privilege: advanced)

Selects the objects for which you want to display performance data. To view a list of valid object names, type statistics show-object`?` or statistics catalog object show . To specify multiple objects, use "|" between each object.

Note You should limit the scope of this command to only a few objects at a time to avoid a potentially significant impact on the performance of the system.
[-instance <text>] - Instance (privilege: advanced)

Selects the instances for which you want to display performance data. If you do not specify this parameter, the command displays statistics for all of the instances associated with the specified objects. To specify multiple instances, use "|" between each instance.

For example, if you want to display disk object statistics, you can use this parameter to specify the name of a specific disk whose statistics you want to view. If you do not specify this parameter, the command displays statistics for all disks in the system.

[-counter <text>] - Counter (privilege: advanced)

Selects the counters for which you want to display performance data. To specify multiple counters, use "|" between each counter.

[-preset <text>] - Preset (privilege: advanced)

If this parameter is specified, the command displays statistics for the specified preset.

[-node {<nodename>|local}] - Node (privilege: advanced)

Selects the nodes for which you want to display performance data.

[-vserver <vserver name>] - Vserver (privilege: advanced)

Selects the Vserver for which you want to display performance data.

[-value <text>] - Text Value (privilege: advanced)

Selects the performance data that matches the specified counter value.

[-labels <text>,…​] - List of Labels (privilege: advanced)

Selects the performance data that matches the specified label.

[-values <text>,…​] - List of Values (privilege: advanced)

Displays only the statistics that have the specified values.

[-filter <text>] - Filter Data (privilege: advanced)

Selects performance data for the instance that matches the specified filter criteria. For example, to display the instances that match a value of greater than 50 for the total_ops counter, specify -filter "total_ops>50" .

[-sample-id <text>] - Sample Identifier (privilege: advanced)

Displays performance data for the specified sample. You collect a sample by using the statistics start and statistics stop commands.

[-interval <integer>] - Interval (privilege: advanced)

Specifies, in seconds, the interval between statistics updates. The default setting is 5 seconds.

[-iterations <integer>] - Iterations (privilege: advanced)

Specifies the number of iterations the command runs before terminating. The default setting is 1. If the number is 0 (zero), the command continues to run until you interrupt it by pressing Ctrl-C.

[-sort-key <text>] - Counter Used For Sorting (privilege: advanced)

If this parameter is specified, the command displays statistics sorted by the specified counter. Only one counter can be specified.

[-sort-order {ascending|descending}] - Sort Order (privilege: advanced)

This parameter may be used in conjunction with the -sort-key parameter. This parameter changes the order in which statistics are sorted. Possible values are ascending and descending . The default setting is descending .

[-max <integer>] - Tracker Size (privilege: advanced)

Specifies the number of most active instances of an active object to display. The default setting is to display all of the instances.

Examples

The following example starts collecting statistics and displays statistics for the sample named smpl_1 for counters: avg_processor_busy and cpu_busy

cluster1::*> statistics start -object system -counter avg_processor_busy|cpu_busy -sample-id smpl_1
Statistics collection is being started for Sample-id: smpl_1

cluster1::*> statistics show -sample-id smpl_1
Object: system
Instance: cluster
Start-time: 8/2/2012 18:27:53
End-time: 8/2/2012 18:27:56
Cluster: cluster1
    Counter                                                     Value
    -------------------------------- --------------------------------
    avg_processor_busy                                             6%
    cpu_busy                                                       6%

The following example starts and stops data collection and displays statistics for the sample named smpl_1 for counters: avg_processor_busy and cpu_busy

cluster1::*> statistics start -object system -counter avg_processor_busy|cpu_busy -sample-id smpl_1
Statistics collection is being started for Sample-id: smpl_1

cluster1::*> statistics stop -sample-id smpl_1
Statistics collection is being stopped for Sample-id: smpl_1

cluster1::*> statistics show -sample-id smpl_1
Object: system
Instance: cluster
Start-time: 8/2/2012 18:27:53
End-time: 8/2/2012 18:27:56
Cluster: cluster1
   Counter                                                     Value
   -------------------------------- --------------------------------
   avg_processor_busy                                             6%
   cpu_busy                                                       6%