ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • 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.

    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%
    Top of Page