Skip to main content

statistics start

Contributors
Suggest changes
PDFs

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 (privilege: advanced)

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.

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 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 (privilege: advanced)

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 (privilege: advanced)

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

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

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 (privilege: advanced)

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 (privilege: advanced)

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 (privilege: advanced)

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 (privilege: advanced)

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 (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.

[-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.

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