.

Monitoring

The s1 system offers sophisticated monitoring features that effectively monitor the system’s performance. This enables you to troubleshoot issues and optimize the system’s resource usage. The system also supports personalized settings, allowing you to collect statistical information according to your needs.

Live ALUA monitoring

To display live monitoring information about ALUA, use the monitoring alua live command.

Usage:

 monitoring alua live [--interval=<interval>]

Options:

Options and arguments Description
--interval=<interval> To specify the time interval between samples (in seconds). Replace <interval> with a positive integer to indicate the time interval, in seconds, between the samples. The default time interval is 2 seconds.

Examples:

  1. To display live monitoring information that is updated every 10 seconds, run

    monitoring alua live --interval 10

  2. To display live monitoring information that is updated every 2 seconds, run

    monitoring alua live

Present usage capacity

To display present usage capacity of the pools, use the Monitoring capacity pools current command.

Usage:

monitoring capacity pools current [--total] [--details] [--interactiveChart | --saveChart]

Options:

Options and arguments Description
--total To display the total sum of system usage capacity from all pools.
--details To display detailed information about the distribution of the capacity.
--interactiveChart To display interactive chart of the usage consumption (supported only on Microsoft Windows OS).
--saveChart To save a capacity usage chart to a file, without displaying it. Supported only on Microsoft Windows OS.

Examples:

  1. To display the total sum of system usage capacity, run

    monitoring capacity pools current --total

  2. To display the capacity sum of each of the pools, run

    monitoring capacity pools current

  3. To display a detailed information about the usage capacity distribution of all pools, run

    monitoring capacity pools current --details

  4. To display a detailed information about the usage capacity distribution of all pools in interactive chart (Windows only), run

    monitoring capacity pools current --details --interactiveChart

History usage capacity

To display the history of usage capacity for each of the pools, use the Monitoring capacity pools history command.

Usage:

monitoring capacity pools history [--hdd --ssd --nvme --manualPools --fromDate=<date> --toDate=<date> --utcTime --interval=<interval>] [--interactiveChart |  --saveChart --force]

Options:

Options and arguments Description
--hdd To display the capacity of hard-disk drives (HDDs) within the pools.
--ssd To display the capacity of solid-state drives (SSDs) withing the pools.
--nvme To display the capacity of physical drives within pools that are connected through Non-Volatile Memory Express (NVMe) protocol.
--manualPools To display the capacity storage of manual pools. capacity.
--fromDate=<date> To filter the output by starting date and time. Replace <date> by ISO 8601 format (YYYY-MM-DDTHH:MM:SS) date.
--toDate=<date> To filter the output by ending date. Replace <date> with ISO 8601 format (YYYY-MM-DDTHH:MM:SS) date.
--utcTime To view the output in UTC time.
--interval=<interval> To specify the time interval between samples (in seconds). Replace <interval> with a positive integer to indicate the time interval, in seconds, between samples.
--interactiveChart To display an interactive chart (supported only on Microsoft Windows OS).
--saveChart To save the capacity usage chart to a file, without displaying it (supported only on Microsoft Windows OS).
--force When a future date is given, the system tries to predict values and displays these predicted values without prompting for approval.

Examples:

  1. To display the history of usage capacity for each of the pools, run

    monitoring pools history

Thin provisioning status capacity within the pools

To display the thin provisioning state withing each of the pools, use the monitoring capacity provisioning command.

Usage:

monitoring capacity provisioning

Options:

The monitoring capacity provisioning command has no options.

Examples:

To display the thin provisioning state withing each of the pools, run

monitoring capacity provisioning

Usage capacity of logical volumes.

To display the usage capacity of all the logical volumes, use the monitoring capacity volumes

Usage:

monitoring capacity volumes

Options:

The monitoring capacity volumes command has no options.

Examples:

To display the usage capacity of all the logical volumes, run

monitoring capacity volumes

Live evacuation statistics

To display live evacuation statistics, use the monitoring evacuations live command.

Usage:

monitoring evacuations live --interval=<interval> [--interactiveChart] [--iterations=<num>]

Options:

Options and arguments Description
--interval=<interval> To specify the time interval between samples (in seconds). Replace <interval> with a positive integer to indicate the time interval, in seconds, between the samples.
--interactiveChart To display an interactive chart (supported only on Microsoft Windows OS).
--iterations=<num> To limit the monitoring evacuations live commands to a specific number of iterations. Replace <num> with a positive integer to indicate the desired number of iterations. When you select this option, the command will run without interruption until it reaches the specified iteration number in <num>.

Examples:

  1. To display live evacuation statistics with three-second interval between samples, run: 
    monitoring evacuations live --interval 3
    You can press any key to stop the command.
  2. To display live interactive evacuation statistics chart with five-second interval between samples (supported on Microsoft Windows only), run: 
    monitoring evacuations live --interval 5 --interactiveChart
  3. To display evacuation statistics with a four-second interval between samples and repeat this process five times, run: 
    monitoring evacuations live --interval 4 --iteration 5

Present system health

To monitor the present system health, use the monitoring health current command.

Usage:

monitoring health current [--volumes] [--hardwareResources] [--hardwareUtilization] [--capacityUtilization] [--details]

Options

Options and arguments Description
--volumes To filter the display by logical volumes health.
--hardwareResources To filter the display by hardware health.
--hardwareUtilization To filter the display by hardware utilization.
--capacityUtilization To filter the display by capacity utilization.
--details To display detailed information for each of the system components.

Examples

  1. To display the present system health of all system components, run:

    monitoring health current

  2. To display the present system health of the logical volumes, run:

    monitoring health current --volumes

  3. To display the present system health of the logical volumes with details, run:

    monitoring health current --volumes --details

  4. To display the present system health of all system components with details, run

    monitoring health current --details

Performance statistics history

To display the performance statistics history, use the monitoring performance history command. The maximum history to display is the last 365 days.

usage:

monitoring performance history --system|(--application=<name> [--volumes=<name…>]) 
    [--iops --throughput --latency --iosize]
    [--readOnly|--writeOnly|--aggrReadsWrites]
    [--fromDate=<date> --toDate=<date> --utcTime --interval=<interval> --interactiveChart | --saveChart]

Options

Options and arguments Description
--system To display system wide performance.
--application=<name> To limit the display for an application instance, replace <name> with an application instance name.
--volumes=<name…> To limit the display for a specific logical volumes.
--iops To display input/output operations per second.
--throughput To display throughput information.
--latency To display latency information.
--iosize To display information about the size of the inputs and outputs. .
--readOnly To limit the display to read only stats.
--writeOnly To limit the display to write only stats.
--aggrReadsWrites To aggregate both read and write stats.
--fromDate=<date> To filter the output by starting date and time. Replace <date> by ISO 8601 format (YYYY-MM-DDTHH:MM:SS) date.
--toDate=<date> To filter the output by ending date. Replace <date> with ISO 8601 format (YYYY-MM-DDTHH:MM:SS) date.
--utcTime To view the output in UTC time.
--interval=<interval> To specify the time interval between samples (in seconds). Replace <interval> with a positive integer to indicate the time interval, in seconds, between samples.
--interactiveChart To display an interactive chart (supported only on Microsoft Windows OS).
--saveChart To save the performance history chart to a file, without displaying it (supported only on Microsoft Windows OS).

Examples

  1. To display the performance statistics history (last 365 days) for system wide, run:

    monitoring performance history --system

  2. To display the statistics history for application instance sales from June 20 2023 to August 11 2023, run:

    monitoring performance history --application sales --fromDate 2023-06-20 --toDate 2023-08-11

    Notice that if --toDate is a future date, then the S1 system will try to predict the capacity growth based on the argument specified in the --fromDate option.

  3. To display the statistics history for application instance sales from June 20 2023 to August 11 2023, run:

    monitoring performance history --application sales --volume  --iosize --fromDate 2023-06-20 --toDate 2023-07-11

  4. To display the statistics history for application instance sales on volume SR from July 13 2023 at time 23:24:00 to July 13 2023 at time 23:50:00 with throughput, IOPS, latency, and read-only display, run:

    monitoring performance history --application sales --volumes SR --fromDate 2023-07-13T23:45:00 --toDate		2023-07-13T23:50:00 --throughput --iops --latency --readOnly 

## Displaying live performance 
To display live performance statistics, use the `monitoring
performance live` command.

### Usage:

``` S1-CLI
monitoring performance live [--application=<name> --volumes=<name…> --aggr] --interval=<interval> [--iops --throughput --latency --iosize --read --write] [--interactiveChart]

Options

Options and arguments Description
--application=<name> To filter the results for a specific application instance.
--volumes=<name…> To filter the results for specific sequence of logical volumes.
--aggr To aggregate results for the entire system of for specific application instance.

| --interval=<interval> | To specify the time interval between samples (in seconds). Replace <interval> with a positive integer to indicate the time interval, in seconds, between the samples. The default time interval is 2 seconds. | | --iops | To display input/output operations per second. | | --throughput | To display throughput information. | | --latency | To display latency information. | | --iosize | To display information about the size of the inputs and outputs. . | | --read | To display read stats. | | --write | To limit the display write stats. | | --interactiveChart | To display an interactive chart (supported only on Microsoft Windows OS). |

Examples

  1. To display overall live performance statistics with three seconds time interval between samples, run

    monitoring performance live --interval 3

    Press any key to stop the live performance display.

  2. To display live performance statistics of application instance sales and its logical volume y1 and set three seconds time interval between samples, run

    monitoring performance live --interval 5 --application sales --volumes y1

    Press any key to stop the live performance display.

  3. To display live performance statistics of application instance sales and its logical volume y1 with the following parameters:

    • Set three seconds time interval between samples,
    • Display only read statistics information (for IOPS, Latency, Io Size, and Throughput). run
    monitoring performance live --interval 5 --application sales --volumes y1 --read

    Press any key to stop the live performance display.

Monitor present reserve space per logical volume

To monitor the present reserve space, per logical volume, use the monitoring reserve current command.

Usage:

monitoring reserve current

Options

The monitoring reserve current command has no options.

Examples

To monitor the present reserve space, per logical volume, run:

monitoring reserve current

Displaying top logical volumes

To list logical volumes in ascending order by IOPS, Latency, or Capacity, use the monitoring top volumes command

Usage:

monitoring top volumes (--capacity|--dataretention|--iops|--latency) [--fromDate=<date>] [--toDate=<date>] [--limit=<numbers>] [--interactiveChart | --saveChart]

Options

Options and arguments Description
--capacity To list the logical volumes by highest capacity usage.
--dataretention To list the logical volumes by highest data retention capacity consumption.
--iops To list the logical volumes by input/output operations per second.
--latency To list the logical volumes by high latency.
--fromDate=<date> To filter the output by starting date and time. Replace <date> by ISO 8601 format (YYYY-MM-DDTHH:MM:SS) date.
--toDate=<date> To filter the output by ending date. Replace <date> with ISO 8601 format (YYYY-MM-DDTHH:MM:SS) date.
--limit=<numbers> To specify the number of logical volumes that will be displayed. Replace <numbers> with a positive number to indicate.
--interactiveChart To display an interactive chart (supported only on Microsoft Windows OS).
--saveChart To save the chart to a file, without displaying it (supported only on Microsoft Windows OS).

Examples

  1. To display a list of logical volumes in ascending order by capacity, run

    monitoring top volumes --capacity

  2. To display a list of no more than three logical volumes in ascending order by capacity, run

    monitoring top volumes --capacity --limit=3

  3. To list the logical volumes by input/output operation activities (per second), starting from July 01 2023, run

    monitoring top volumes --iops  --fromDate 2023-07-01

Utilization statistics history

To display resource utilization statistics history, use the monitoring utilization history command

Usage:

monitoring utilization history [--node=<name> --aggr  --hdd --ssd --nvme --cpu --memory --fromDate=<date> --toDate=<date> --utcTime --interval=<interval> --interactiveChart | --saveChart --force]

Options

Options and arguments Description
--node=<name> To filter the results by specifying a server node, replace <name> with the name of the node that you want to display results for.
--aggr To aggregate results for all server nodes.
--hdd To include resource utilization information on hard-disk drives (HDDs) utilization.
--ssd To include resource utilization information on solid-state drives (SDDs).
--nvme To include resource utilization information on drives connected through NVMe.
--cpu To include resource utilization information on system CPU.
--memory To include resource utilization information on system memory .
--fromDate=<date> To filter the output by starting date and time. Replace <date> with ISO 8601 format (YYYY-MM-DDTHH:MM:SS) date.
--toDate=<date> To filter the output by ending date. Replace <date> with ISO 8601 format (YYYY-MM-DDTHH:MM:SS) date.
--utcTime To view the output in UTC time.
--interval=<interval> To specify the time interval between samples (in seconds). Replace <interval> with a positive integer to indicate the time interval, in seconds, between samples.
--interactiveChart To display an interactive chart (supported only on Microsoft Windows OS).
--saveChart To save the performance history chart to a file, without displaying it (supported only on Microsoft Windows OS).
--force When a future date is given, the system tries to predict values and displays these predicted values without prompting for approval.

Examples

  1. To display resource utilization statistics history for the past 365 days, run

    monitoring utilization history

  2. To display resource utilization statistics history from April 2 2023 to July 1 2023, run

    monitoring utilization history --fromDate 2023-04-02 --toDate 2023-07-01

  3. To display resource utilization statistics history for node s1-6020 from April 2 2023 to July 1 2023, run

    monitoring utilization history --node s1-6020 --fromDate 2023-04-02 --toDate 2023-07-01

  4. To display resource utilization statistics history for node 6020 from April 2 2023 to July 1 2025 without prompting for approval, run

    monitoring utilization history --node s1-6020 --fromDate 2023-04-02 --toDate 2025-07-01 --force

  5. To display resource utilization statistics history for SSD, CPU, and node 6020 starting from April 2 2023 up to July 1 2025 without prompting for approval , run

    monitoring utilization history --node s1-6020 --cpu --ssd --fromDate 2023-04-02 --toDate 2025-07-01 --force

Live utilization statistics

To display the present utilization statistics, use the monitoring utilization live command

Usage:

monitoring utilization live --interval=<interval>  [--node=<name>] [--interactiveChart]

Options

Options and arguments Description
--interval=<interval> To specify the time interval between samples (in seconds). Replace <interval> with a positive integer to indicate the time interval, in seconds, between samples.
--node=<name> To filter the results by specifying a server node, replace <name> with the name of the node that you want to display results for.
--interactiveChart To display an interactive chart (supported only on Microsoft Windows OS).

Live controls:

  • To sort the live display by name, press N.
  • To sort the live display by utilization, press U.
  • To stop the live display, press on any other key.

Examples

  1. To display the live utilization statistics that is updated every two seconds, run

    monitoring utilization live --interval 2

  2. To display live utilization statistics for server node s1-6021 that are updated every five seconds, run

monitoring utilization live --interval 2 --node s1-6021
Last updated on 15 Nov 2022
Published on 30 Oct 2022