NOTE: When typing metric paths, replace . with \., , with \, and \ with \\ in the object names.
-interval
Specify an interval for the metric values. Default interval is seconds.
-from
Specify the start of the query period. The format is:
YYYY-MM-DD HH:MM:SS or
YYYY-MM-DDTHH:MM:SS, where:
YYYY — Year
MM — Month
DD — Day
T — Time delimiter
HH — Hour
MM — Minute
SS — Second
NOTE:Ensure that the value is a time in the past. You can choose to specify just the date (in the
YYYY-MM-DD format) or the time (in the
HH:MM:SS format). If you do not specify the time, the system automatically uses 00:00:00. If you choose to not specify the date, the current system date is used.
-to
Specify the end of the query period. The format is:
YYYY-MM-DD HH:MM:SS or
YYYY-MM-DDTHH:MM:SS, where:
YYYY — Year
MM — Month
DD — Day
T — Time delimiter
HH — Hour
MM — Minute
SS — Second
NOTE:Ensure that the value is a time in the past. You can choose to specify just the date (in the
YYYY-MM-DD format) or the time (in the
HH:MM:SS format). If you do not specify the time, the system automatically uses 00:00:00. If you choose to not specify the date, the current system date is used.
-count
Specify the number of samples to display. A sample is a set of metric values related to a single timestamp. Valid values are numbers greater than or equal to one.
-flat
Displays the member values for grouped metrics.
-summary
Displays the maximum, minimum, and average value for each metric.
NOTE:The
-from and
-to qualifiers take precedence over the
-count qualifier. In the example below, only 7 samples exist between the from and to dates. Although the value for the
-count qualifier is set to 10, only 7 values appear. If the
-from and
-to qualifiers are not specified, the output will include 10 samples.
Examples of output with different combinations of the -from, -to, and -count qualifiers
The following table illustrates the output that appears with combinations of the
-from,
-to, and
-count qualifiers. It assumes that the current time is 2012-09-21 12:30:00.
Qualifier Combination
Output
-from <future date/time>
Example:
-from “2012-09-21 12:31:00”
Result: This results in an error because the time for the
-from qualifier is specified in the future.
-from <current date/time or date/time in the past>
Result: This results in an error because the time for the
-to qualifier is specified in the future.
-from <date/time in the past> -count <value>
Example:
-from “2012-09-20 01:02:00”
-count 100
Result: The result includes 100 samples from “2012-09-20 01:02:00”. If there are less than 100 samples available, the result lists all samples from the specified time to the current time.
Result: The result includes 100 samples within the specified time period. If there are less than 100 samples available, the result lists all samples within the time period.
-to <current date/time or date/time in the past>
-count <value>
Example:
-to “20-09-20 12:00:00”
-count 100
Result: The result includes the latest 100 samples before the specified time. If there are less than 100 samples available, the result lists all samples.
-count <value>
Example:
-count 100
Result: The result includes the latest 100 samples, or if there are less than 100 samples available, the result lists all samples.
-to <current date/time or date/time in the past>
Example:
-to “20-09-20 12:00:00”
Result: The result includes all samples from the timestamp of the earliest sample to the specified time.
-from, -to, and -count are not specified.
Result: The result includes the latest 100 samples, or if there are less than 100 samples available, the result lists all samples. This is equivalent to “-count 100”.
Example 1
The following command displays the specified individual metric SPA LUN sv_1 every 60 seconds during the query period:
The following command displays the specified metric, associated with three object types, SPs, pools, and LUNs, every 60 seconds during the query period:
The following command displays metrics, associated with two object types, SPs and LUNs, and an individual metric associated with SPA, every 60 seconds during the query period: