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:
Attribute
|
Description
|
||
---|---|---|---|
History enabled
|
Indicates whether historical metrics collection is enabled. Value is one of the following:
|
||
History retention
|
Identifies the timestamp of the earliest available value for each frequency interval. The formats are:
|
View metrics service settings
View the current metrics service settings.
|
NOTE:
Use the show action command to change the output format.
|
Format
/metrics/service showExample
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:
|
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
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.
The following table lists the metrics attributes:
Attribute
|
Description
|
||
---|---|---|---|
Path
|
Unique ID for the metric.
|
||
Description
|
Description of the metric.
|
||
Type
|
Metric type. Valid values are:
|
||
Unit
|
Unit measure for the metric.
|
||
Availability
|
Availability of the metric. Value is one of the following:
|
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 } ] showObject qualifier
Qualifier
|
Description
|
||
---|---|---|---|
-path
|
Specify a comma-separated list of metric paths.
|
||
-availability
|
Specify a type of metric to display. Value is one of the following:
|
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
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 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:
Attribute
|
Description
|
---|---|
Timestamp
|
Time when the metric value was collected. The format is:
YYYY-MM-DD HH:MM:SS, where:
|
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.
|
||
-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:
|
||
-to
|
Specify the end of the query period. The format is:
YYYY-MM-DD HH:MM:SS or
YYYY-MM-DDTHH:MM:SS, where:
|
||
-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
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.
The following table lists the real-time metrics attributes.
Attribute
|
Description
|
---|---|
Timestamp
|
Time when the metric value was collected. The format is:
YYYY-MM-DD HH:MM:SS, where:
|
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.
|
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:
|
||
-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