Manage Metrics

Manage metrics service

Storage system metrics gather information about system performance and storage usage, and collect that information for user review. Analyzing the system metrics can help predict the future growth of the system.

Historical and real-time metrics values are available in predefined intervals. High frequency (short interval) metric values are not kept as long as low frequency (long interval) metrics.

The following table lists the metrics service attributes:

Table 1. Metrics service attributes

Attribute

Description

History enabled

Indicates whether historical metrics collection is enabled. Value is one of the following:

Default value is yes.

History retention

Identifies the timestamp of the earliest available value for each frequency interval. The formats are:

YYYY-MM-DD HH:MM:SS (60 sec)
YYYY-MM-DD HH:MM:SS (300 sec)
YYYY-MM-DD HH:MM:SS (3600 sec)
YYYY-MM-DD HH:MM:SS (14400 sec)

If the data for a certain interval is not available, the system displays not available instead of a timestamp.

NOTE: By default, the timestamps are UTC time. If you specify a timezone offset with -gmtoff, the timestamps adjust accordingly.

View metrics service settings

View the current metrics service settings.

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

Format

/metrics/service show

Example

The following command displays the metrics service settings for the system:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/service show

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection


1:  History enabled  = yes
    History retention= 2012-9-20 12:00:00 (60 sec), 2012-9-14 12:00:00 (300 sec), not available (3600 sec), not available (14400 sec)

Configure metrics service

Enable historical metrics collection.

Format

/metrics/service set -historyEnabled { yes | no }

NOTE: Only administrators are allowed to run this command.

Action qualifiers

Qualifier

Description

-historyEnabled

Indicates whether historical metrics collection is enabled or disabled. Value is one of the following:

NOTE: The system prompts for confirmation if you specify no.

Example

The following command enables metrics collection:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/service set -historyEnabled yes

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection


Operation completed successfully.

Manage metrics settings

The following table lists the metrics attributes:

Table 2. Metrics attributes

Attribute

Description

Path

Unique ID for the metric.

NOTE: Metrics are usually associated with objects. This association is reflected by a * character in the metric path, such as sp.*.net.device.*.bytes, which is associated with two objects, SP and network device. The metrics commands will accept a metric path with the * replaced by an object, and return only the result for the specified object. The system generates an error if the specified object is not valid.

Description

Description of the metric.

Type

Metric type. Valid values are:

rate — A counter difference relative to a unit of time.
counter — A monotonically increasing, unsigned quantity.
fact — Represents point-in-time information. Fact values should be expected to go up and down.
64 bits counter — A counter of 64 bits.
text — Literal.

Unit

Unit measure for the metric.

Availability

Availability of the metric. Value is one of the following:

historical — The metric is included in historical metrics collection.
real-time — The metric supports real-time subscription.
historical, real-time — The metric supports both historical and real-time collection.

This attribute does not apply to family, set, and compound metrics.

View metrics settings

View information about supported metrics.

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

Format

/metrics/metric [-path <value>] [-availability { historical | real-time } ] show

Object qualifier

Qualifier

Description

-path

Specify a comma-separated list of metric paths.

NOTE: When typing metric paths, replace . with \., , with \, and \ with \\ in the object names.

Omitting this switch specifies all available metrics.

-availability

Specify a type of metric to display. Value is one of the following:

historical
real-time

Omitting this switch displays all metrics.

Example 1

The following command displays all available metric service settings for the system:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/metric show

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:  Path         = sp.*.cifs.global.basic.readsRate

2:  Path         = sp.*.cifs.global.basic.totalCallsRate

3:  Path         = sp.*.cifs.global.basic.writeAvgSize

Example 2

The following command displays all available metric service settings for the system with additional details:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/metric show -detail

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    Path         = sp.*.blockCache.global.summary.cleanPages
      Description  = Number of Clean Pages on SP, based on a logical 
						               64 KB page size
      Type         = fact
      Unit         = Count
      Availability = real-time

2:    Path         = sp.*.blockCache.global.summary.dirtyBytes
      Description  = Amount of Dirty Data (MB) on SP
      Type         = fact
      Unit         = MB
      Availability = historical, real-time

3:    Path         = sp.*.blockCache.global.summary.dirtyPages
      Description  = Number of Dirty Pages on SP, based on a logical 
                     64 KB page size
      Type         = fact
      Unit         = Count
      Availability = real-time

Example 3

The following command displays all available real-time metric service settings for the system:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/metric -availability real-time show

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

439:  Path = sp.*.storage.pool.*.sizeTotal

440:  Path = sp.*.storage.pool.*.sizeUsed

441:  Path = sp.*.storage.pool.*.sizeUsedBlocks

442:  Path = sp.*.storage.pool.*.snapshotSizeSubscribed

443:  Path = sp.*.storage.pool.*.snapshotSizeUsed

444:  Path = sp.*.storage.summary.readBlocksRate

445:  Path = sp.*.storage.summary.readBytesRate

446:  Path = sp.*.storage.summary.readsRate

447:  Path = sp.*.storage.summary.totalBytesRate

Example 4

The following command displays the metrics service settings for the metrics with the specified paths:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/metric -path sp.*.storage.lun.*.avgReadSize,sp.*.storage.filesystem.*.writesRate,sp.*.cifs.smb2.basic.readsRate show -detail

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:  Path         = sp.*.storage.lun.*.avgReadSize
    Description  = Average read size on this LUN
    Type         = fact
    Unit         = KB
    Availability = historical, real-time

2:  Path         = sp.*.storage.filesystem.*.writesRate
    Description  = Rate of sp.*.storage.filesystem.*.writes
    Type         = rate
    Unit         = Requests/s
    Availability = historical, real-time

3:  Path         = sp.*.cifs.smb2.basic.readsRate
    Description  = Rate of sp.*.cifs.smb2.basic.reads
    Type         = rate
    Unit         = Ops/s
    Availability = real-time

Manage historical metrics values

Historical metric values are available in predefined intervals. High frequency (short interval) metric values are not kept as long as low frequency (long interval) metrics.

The following table lists the historical metrics attributes:

Table 3. Historical metrics attributes
Attribute	Description
Timestamp	Time when the metric value was collected. The format is: YYYY-MM-DD HH:MM:SS, where: YYYY — Year MM — Month DD — Day HH — Hour MM — Minute SS — Second
Dynamic attributes	Identifies the object name or metric value.

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

Qualifier

Description

-path

Specify a comma-separated list of metric paths.

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

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

Manage real-time metrics values

The following table lists the real-time metrics attributes.

Table 4. Real-time metrics attributes
Attribute	Description
Timestamp	Time when the metric value was collected. The format is: YYYY-MM-DD HH:MM:SS, where: YYYY — Year MM — Month DD — Day HH — Hour MM — Minute SS — Second
Dynamic attributes	Identifies the object name or metric value.

View real-time metrics settings

View real-time metrics settings. The default output appears in a tabular format.

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

Format

/metrics/value/rt -path <value> show -interval <value> [ -to <value>] [ -count <value> ][ -flat ][ -summary ]

Object qualifier

Qualifier

Description

-path

Specify a comma-separated list of metric paths.

NOTE: When typing metric paths, replace . with \., , with \, and \ with \\ in the object names.

Action qualifier

Qualifier

Description

-interval

Specify an interval for the metric values. Default interval is seconds.

-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

-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: Objects can come and go at any time, mostly due to object creation and deletion. In flat format, every time a new object is included, the title in tabular or CSV format or the attributes in NVP format is adjusted accordingly and reprinted as necessary on screen. If an object is no longer valid but it already has a column in tabular or CSV format, the column is kept only if its value becomes blank. Otherwise the object is not displayed anymore.

Example 1

The following command displays the specified real-time metric every 10 seconds:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! uemcli /metrics/value/rt -path sp.*.storage.lun.*.readsRate show -interval 10

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Timestamp           |SP        |LUN               |Read
                    |          |                  |Counts/s
--------------------+----------+------------------+--------
2014-06-24 03:26:10 |spb       |sv_1              |   0.225
2014-06-24 03:26:20 |spb       |sv_1              |   0.200
                    |spb       |sv_2              |   0.100
2014-06-24 03:26:30 |spb       |sv_2              |   0.200

Example 2

The following command displays the member values for the specified grouped real-time metric every 10 seconds in comma-separated values (CSV) format:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! uemcli /metrics/value/rt -path sp.*.storage.lun.*.readsRate show -interval 10 -flat -output csv

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Timestamp,spb sv_1 Read Counts/s 
2014-06-24 03:26:10,0.225
Timestamp,spb sv_1 Read Counts/s,spb sv_2 Read Counts/s
2014-06-24 03:26:20,0.200,0.100
2014-06-24 03:26:30,,0.200

Example 3

The following command displays the specified real-time metric every 10 seconds name-value pair (NVP) format:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! uemcli /metrics/value/rt -path sp.*.storage.lun.*.readsRate show -interval 10 -output nvp

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1: Timestamp = 2014-06-24 03:26:10
   SP        = spb
   Client    = sv_1
   CIFS Read = 0.225

2: Timestamp = 2014-06-24 03:26:20
   SP        = spb
   Client    = sv_1
   CIFS Read = 0.200

3: Timestamp = 2014-06-24 03:26:20
   SP        = spb
   Client    = sv_2
   CIFS Read = 0.100

4: Timestamp = 2014-06-24 03:26:30
   SP        = spb
   Client    = sv_2
   CIFS Read = 0.200