statistics show

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 ]}
If this parameter is specified, the command displays performance data in tabular format.
[-object <text>] - Object
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.
CAUTION:
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
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
Selects the counters for which you want to display performance data. To specify multiple counters, use "|" between each counter.
[-preset <text>] - Preset
If this parameter is specified, the command displays statistics for the specified preset.
[-node {<nodename>|local}] - Node
Selects the nodes for which you want to display performance data.
[-vserver <vserver name>] - Vserver
Selects the Vserver for which you want to display performance data.
[-value <text>] - Text Value
Selects the performance data that matches the specified counter value.
[-labels <text>, ...] - List of Labels
Selects the performance data that matches the specified label.
[-values <text>, ...] - List of Values
Displays only the statistics that have the specified values.
[-filter <text>] - Filter Data
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
Displays performance data for the specified sample. You collect a sample by using the statistics start and statistics stop commands.
[-interval <integer>] - Interval
Specifies, in seconds, the interval between statistics updates. The default setting is 5 seconds.
[-iterations <integer>] - Iterations
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
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
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
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%
The following example displays raw statistics:
cluster1::*> statistics show -raw -object system
Object: system
Instance: cluster
Start-time: 9/13/2012 18:18:18
End-time: 9/13/2012 18:18:18
Cluster: cluster1

    Counter                                                     Value
    -------------------------------- --------------------------------
    avg_processor_busy                                      249876451
    cifs_ops                                                        0
    cpu_busy                                                303355441
    disk_data_read                                           51453952
    disk_data_written                                       486117376
    fcp_data_recv                                                   0
    fcp_data_sent                                                   0
    fcp_ops                                                         0
    hdd_data_read                                            51453952
    hdd_data_written                                        486117376
    hostname                                              node-name1
    http_ops                                                        0
    instance_name                                            cluster
    iscsi_ops                                                       0
    net_data_recv                                            35034112
    net_data_sent                                             3177472
    nfs_ops                                                         0
    node_name                                             node-name1
    node_uuid
[...]
The following example displays raw statistics for counters "avg_processor_busy" and "cpu_busy":
cluster1::*> statistics show -raw -object system -counter avg_processor_busy|cpu_busy
Object: system
Instance: cluster
Start-time: 9/13/2012 18:18:18
End-time: 9/13/2012 18:18:18
Cluster: cluster1

    Counter                                                     Value
    -------------------------------- --------------------------------
    avg_processor_busy                                      249876451
    cpu_busy                                                303355441
[...]