Procedure for obtaining performance information of VSP One SDS Block

Virtual Storage Platform One SDS Block and SDS Cloud Troubleshooting Reference
Version
1.19.x
Audience
anonymous
Part Number
MK-24VSP1SDS029-03
ft:lastEdition
2026-04-07

You can collect dump log files including performance information.

This section describes how to collect dump log files by using the REST API/CLI.

The performance information collected in this step includes that for a maximum of the last two days.

Perform this procedure only when instructed to do so in the document or by customer support.

When you are also instructed to perform the procedure as described in Procedure for collecting dump log files of VSP One SDS Block, first perform the procedure. If you want to monitor the system performance, see Obtaining system performance and capacity information in the VSP One SDS Block System Administrator Guide. If a failure occurs during this procedure, see Action to be taken when dump log file download fails.

Dump log files are created with the following file name:

  • When splitting of dump log files is not specified:

    hsds_log_<YYYYMMDD>_<hhmmss>_<LABEL>_<HOSTNAME>_<ROLE>_<MODE>.tar.gz

    Example 1) hsds_log_20260120_204236_labelname1_storagenode1_MasterPrimary_Monitor.tar.gz

    Example 2) hsds_log_20260120_204236_labelname1_storagenode1_Worker_Monitor.tar.gz

  • When splitting of dump log files is specified:

    hsds_log_<YYYYMMDD>_<hhmmss>_<LABEL>_<HOSTNAME>_<ROLE>_<MODE>.tar.gz.<INDEX>

    Example 1) hsds_log_20260120_204236_labelname1_storagenode1_MasterPrimary_Monitor.tar.gz.001

    Example 2) hsds_log_20260120_204236_labelname1_storagenode1_Worker_Monitor.tar.gz.001

Whenever you run an REST API or CLI in each step, authenticate it using an issued authentication ticket.

Note:

  • If a server certificate is not imported in VSP One SDS Block, a warning message about a server certificate might appear.

    When a warning message appears, verify the IP address or host name of the request destination, and then take action according to how to ignore the warning by each execution environment bullet-listed in Action to be taken when a warning message about a server certificate appears in the VSP One SDS Block System Administrator Guide.

  • When storing dump log files, ensure they are saved in paths with sufficient length to avoid violating path length restrictions specific to the OS you are using.

  1. Obtain a list of storage nodes to verify the status and clusterRole.

    REST API: GET /v1/objects/storage-nodes

    CLI: storage_node_list

    Select a storage node whose status is "Ready" and clusterRole is "Master." Then, proceed to the next step.

    CAUTION:

    If a storage node with the status "Ready" does not exist, another maintenance operation is in progress or a failure has occurred in the storage cluster. If another maintenance operation is in progress, wait until the operation is completed, and then perform this procedure. If a failure occurs in the storage cluster, first troubleshoot the failure, and then perform this procedure.

  2. Request creation of a dump log file from the controller node to the storage node selected in step 1.

    Specify "Monitor" for the mode parameter.

    REST API: POST /v1/objects/dump-file/actions/create-file/invoke

    CLI: dump_file_create_file

    Note:

    When you specify <LABEL> of the file name in the label parameter, observe the following.

    Number of characters: Maximum of 64

    Characters that can be used: Numbers (0 to 9), uppercase alphabet (A to Z), lowercase alphabet (a to z), symbols (! # $ % & ' - . @ ^ _ ` { } ~)

  3. Verify the dump log file creation status.

    Creation of a dump log file takes a maximum of 120 minutes.

    REST API: GET /v1/objects/dump-statuses

    CLI: dump_status_list

    When the status becomes "Created" at the time of running the command, the dump log file size (unit: MiB) and the number of files into which the dump log files can be split are displayed in "size." Verify the file size and the number of files, and then proceed to the next step.

  4. Download the dump log file to the controller node.

    Secure free space equal to or more than the size confirmed in step 3 before downloading.

    REST API: GET /v1/objects/dump-files/<fileName>/download

    CLI: dump_file_download

    Note:

    • If you specified an index parameter, you can download split files whose file size is 400 Mib. When you want to download files separately, perform download for the number of files into which the dump log files can be split.

    • If a dump log file could not be downloaded using a VSP One SDS Block Administrator, collect it using a REST API or CLI.

  5. Verify that each dump log file was created with the name conforming to the naming convention.
  6. Delete the dump log files you downloaded in step 4 from the storage nodes.

    REST API: DELETE /v1/objects/dump-files/<fileName>

    CLI: dump_file_delete