Index  |  Top  -  Up Data ONTAP 8.3

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:

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

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

See Also

statistics catalog object show   statistics show   statistics stop  
Index  |  Top  -  Up Data ONTAP 8.3

Copyright © 1994-2015 NetApp, Inc. Legal Information