statistics start

Start data collection for a sample

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

Description

This command starts the collection of performance data. Use the statistics stop command to stop the collection. You view the sample of performance data by using the statistics show command. You can collect more than one sample at a time.

Parameters

[-object <text>] - Object
Selects the objects for which you want to collect performance data. This parameter is required. To view a list of valid object names, type statistics catalog object show at the command prompt. 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 collect performance data. If you do not specify this parameter, the command collects 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 collect 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 will collect statistics for all disks in the system.

[-counter <text>] - Counter
Selects the counters for which you want to collect performance data. If you do not specify this parameter, the command collects statistics for all of the counters in the specified objects. To specify multiple counters, use "|" between each counter.
[-preset <text>] - Preset
If this parameter is specified, the command displays statistics for the specified preset.
[-sample-id <text>] - Sample Identifier
Specifies an identifier for the sample. Identifiers must be unique and are restricted to the characters 0-9, a-z, A-Z, and "_". If you do not specify this parameter, the command generates a sample identifier for you and defines this sample as the default sample for the CLI session. When you run the statistics show command without specifying the -sample-id parameter, data from the default sample displays. If you run this command during the same CLI session and do not specify the -sample-id parameter, the command overwrites the previous sample. The command does not delete the default sample when you close your session.
[-vserver <vserver name>] - Vserver
Selects the vserver for which you want to collect performance data. If you do not specify this parameter, the command collects statistics for all of the Vservers in the cluster.
[-node {<nodename>|local}] - Node
Selects the node for which you want to collect performance data. If you do not specify this parameter, the command collects statistics for all of the nodes in the cluster.
[-filter <text>] - Filter
Selects performance data for the instance that matches the specified filter criteria. For example, to display the instances from node1, specify -filter "node_name=node1".
[-duration <integer>] - Sample Duration in Minutes
If this parameter is specified, the command will collect the closing sample after the time specified. Duration can be specified in minutes.
[-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.
[-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.

Examples

The following example starts statistics collection for sample "smpl_1":
cluster1::*> statistics start -object system -sample-id smpl_1
Statistics collection is being started for Sample-id: smpl_1
The following example starts collecting 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