Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

Dell Unity™ Family Unisphere® Command Line Interface User Guide

View historical metrics settings

View historical metrics settings. The default output appears in a tabular format.

NOTE:Use the show action command to change the output format.

Format

/metrics/value/hist -path <value> show -interval { 60 | 300 | 3600 | 14400 }[ -from <value> ] [ -to <value>] [ -count <value> ][ -flat ][ -summary ]

Object qualifier

QualifierDescription
-pathSpecify a comma-separated list of metric paths.
NOTE: When typing metric paths, replace . with \., , with \, and \ with \\ in the object names.
-intervalSpecify an interval for the metric values. Default interval is seconds.
-fromSpecify 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.
-toSpecify 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.
-countSpecify 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.
-flatDisplays the member values for grouped metrics.
-summaryDisplays 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 CombinationOutput
-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>

-to <future date/time>

Example: -from “2012-09-01 00:00:00” -to “2012-09-21 12:31:00”

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.

-from <date/time in the past>

-to <current date/time or date/time in the past>

-count <value>

Example: -from “2012-09-20 01:02:00” -to “20-09-20 12:00:00” -count 100

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:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.spa.storage.lun.sv_1.readsRate show -interval 60 -from "2014-06-24 02:12:00" -to "2014-06-24 02:1 4 :00"
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Timestamp           |SP        |LUN               |Read
                    |          |                  |Counts/s
--------------------+----------+------------------+--------
2014-06-24 02:12:00 |spa       |sv_1              |   4.001
2014-06-24 02:13:00 |spa       |sv_1              |   2.400
2014-06-24 02:14:00 |spa       |sv_1              |   9.602

Example 2

The following command displays the specified metric, associated with a single object type, SPs, every 60 seconds during the query period:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.*.cpu.summary.utilization show -interval 60 -from "2014-06-24 02:57:00" -to "2014-06-24 02:59:10"
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Timestamp           |SP        |summary
                    |          |CPU
                    |          |Util %
--------------------+----------+-------
2014-06-24 02:57:00 |spa       |  12.62
                    |spb       |  32.46
2014-06-24 02:58:00 |spa       |  13.06
                    |spb       |  19.75
2014-06-24 02:59:00 |spa       |  13.44
                    |spb       |  32.47

Example 3

The following command displays the specified metric, associated with two object types, SPs and LUNs, every 60 seconds during the query period:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.*.storage.lun.*.readsRate show -interval 60 -from "2014-06-24 02:59:00" -to "2014-06-24 03:01:00"
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Timestamp           |SP        |LUN               |Read
                    |          |                  |Counts/s
--------------------+----------+------------------+--------
2014-06-24 02:59:00 |spa       |sv_1              |   0.050
                    |spa       |sv_2              |       0
                    |spb       |sv_1              |       0
                    |spb       |sv_2              |   0.033
2014-06-24 03:00:00 |spa       |sv_1              |   0.467
                    |spa       |sv_2              |       0
                    |spb       |sv_1              |       0
                    |spb       |sv_2              |   0.117
2014-06-24 03:01:00 |spa       |sv_1              |   0.833
                    |spa       |sv_2              |       0
                    |spb       |sv_1              |       0
                    |spb       |sv_2              |   0.467

Example 4

The following command displays the specified metric, associated with three object types, SPs, pools, and LUNs, every 60 seconds during the query period:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.*.storage.pool.*.lun.*.dataSizeAllocated show -interval 60 -from "2014-06-24 03:04:00" -to "2014-06-24 03:06:00"
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Timestamp           |SP  |Pool Statistics |LUN   |Data Size Allocated Bytes
--------------------+----+----------------+------+--------------------------
2014-06-24 03:04:00 |spa |pool_1          |sv_1  |6442450944
                    |spa |pool_1          |sv_2  |8589934592
                    |spb |pool_1          |sv_1  |6442450944
                    |spb |pool_1          |sv_2  |8589934592
2014-06-24 03:05:00 |spa |pool_1          |sv_1  |6442450944
                    |spa |pool_1          |sv_2  |8589934592
                    |spb |pool_1          |sv_1  |6442450944
                    |spb |pool_1          |sv_2  |8589934592
2014-06-24 03:06:00 |spa |pool_1          |sv_1  |6442450944
                    |spa |pool_1          |sv_2  |8589934592
                    |spb |pool_1          |sv_1  |6442450944
                    |spb |pool_1          |sv_2  |8589934592

Example 5

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:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.*.storage.lun.*.readsRate, sp.*.storage.lun.*.writesRate, sp. spa.cpu.summary.utilization show -interval 60 -from "2014-06-24 03:04:00" -to "2014-06-24 03:06:00"
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Timestamp           |SP     |LUN     |Read     |Write    |SP    |summary
                    |       |        |Counts/s |Counts/s |      |CPU
                    |       |        |          |        |      |Util %
--------------------+-------+--------+------+--------+----------+-------
2014-06-24 03:10:00 |spa    |sv_1    |        0|        0|spa   |  12.63
                    |spa    |sv_2    |    1.050|    9.066|      | 
                    |spb    |sv_1    |    0.067|    9.350|      |
                    |spb    |sv_2    |    0.100|    14.95|      |
2014-06-24 03:11:00 |spa    |sv_1    |        0|        0|spa   |  12.56
                    |spa    |sv_2    |    0.700|    26.62|      |
                    |spb    |sv_1    |    0.167|    12.28|      |
                    |spb    |sv_2    |    2.883|    25.65|      |
2014-06-24 03:12:00 |spa    |sv_1    |    0.667|    19.53|spa   |  12.12
                    |spa    |sv_2    |    0.333|    26.87|      |
                    |spb    |sv_1    |    7.066|    3.700|      |
                    |spb    |sv_2    |    7.066|    3.383|      |

Example 6

The following command displays the member values for specified metrics every 60 seconds during the query period:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.*.cpu.summary.utilization show -interval 60 -from "2014-06-24 03:14:00" -to "2014-06-24 03:16:00" -flat
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Timestamp           |spa    |spb
                    |summary|summary
                    |CPU    |CPU
                    |Util % |Util %
--------------------+-------+-------
2014-06-24 03:14:00 |  15.06|  26.78
2014-06-24 03:15:00 |  15.82|  29.39
2014-06-24 03:16:00 |  15.94|  23.59

Example 7

The following command displays the maximum, minimum, and average value for each metric every 60 seconds during the query period:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.*.cpu.summary.utilization show -interval 60 -from "2014-06-24 03:19:00" -to "2014-06-24 03:21:00" -summary
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Timestamp           |SP        |summary
                    |          |CPU
                    |          |Util %
--------------------+----------+-------
2014-06-24 03:19:00 |spa       |  17.72
                    |spb       |  43.52
2014-06-24 03:20:00 |spa       |  15.35
                    |spb       |  37.82
2014-06-24 03:21:00 |spa       |  15.08
                    |spb       |  36.32

Summary             |SP        |summary
                    |          |CPU
                    |          |Util %
--------------------+----------+-------
Minimum             |spa       |  15.08
                    |spb       |  36.32
Average             |spa       |  16.05
                    |spb       |  39.22
Maximum             |spa       |  17.72
                    |spb       |  43.52


Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\