API Doc
Search Docs...
⌘ K
OverviewDeploymentManagementOperationReferenceGlossary

Viewing UIO or access statistics

UIO (User I/O) refers to I/O requests sent from the user side. zbs_client converts these user I/O requests into internal ABS I/O requests and sends them to the lease owner of the corresponding extent. Users can view UIO statistics via the command line.

Procedure

Run the following command to view UIO statistics on a node:

zbs-perf-tools chunk uio summary [--chunk-addr <ip>]

ParameterDescription
--chunk-addr <ip>The zbs-chunkd RPC server address. Default: 127.0.0.1:10200, the chunk on the node where the command is run.

Output example

$zbs-perf-tools chunk uio summary
---------------------------------------------------
  host                 127.0.0.1:10200
  instance_id          1
  total_iops           4852.00
  total_bw             403.66 MB/s(384.96 MiB/s)
  total_latency        230.05 US
  read_iops            885.00
  read_bw              146.32 MB/s(139.54 MiB/s)
  read_latency         172.73 US
  write_iops           3967.00
  write_bw             257.35 MB/s(245.42 MiB/s)
  write_latency        242.83 US
  local_io_ratio       1.00 (4852.00 / 4852.00)
  local_io_latency     230.05 US
  local_io_bw          403.66 MB/s(384.96 MiB/s)
  local_read_ratio     1.00 (885.00 / 885.00)
  local_read_latency   172.73 US
  local_read_bw        146.32 MB/s(139.54 MiB/s)
  local_write_ratio    1.00 (3967.00 / 3967.00)
  local_write_latency  242.83 US
  local_write_bw       257.35 MB/s(245.42 MiB/s)
  failed_io_ratio      0.00
  retry_io_ratio       0.00
  retry_queue_size     0
  active_extents       7630
  active_volumes       21
  waiting_queue_size   0
---------------------------------------------------

Output note

ParameterDescription
total_iopsThe total IOPS of the zbs_client module in the last 1 second.
total_bwThe total bandwidth of the zbs_client module in the last 1 second.
total_latencyThe average total latency of the zbs_client module in the last 1 second.
read_iopsThe read IOPS of the zbs_client module in the last 1 second.
read_bwThe read bandwidth of the zbs_client module in the last 1 second.
read_latencyThe average read latency of the zbs_client module in the last 1 second.
write_iopsThe write IOPS of the zbs_client module in the last 1 second.
write_bwThe write bandwidth of the zbs_client module in the last 1 second.
write_latencyThe average write latency of the zbs_client module in the last 1 second.
local_io_ratioThe ratio of I/O requests sent to the local access in the last 1 second.
local_io_latencyThe average latency of I/O requests sent to the local access in the last 1 second.
local_io_bwThe bandwidth of I/O requests sent to the local access in the last 1 second.
local_read_ratioThe ratio of read I/O requests sent to the local access in the last 1 second.
local_read_latencyThe average latency of read I/O requests sent to the local access in the last 1 second.
local_read_bwThe bandwidth of read I/O requests sent to the local access in the last 1 second.
local_write_ratioThe ratio of write I/O requests sent to the local access in the last 1 second.
local_write_latencyThe average latency of write I/O requests sent to the local access in the last 1 second.
local_write_bwThe bandwidth of write I/O requests sent to the local access in the last 1 second.
failed_io_ratioThe failed I/O ratio in the last 1 second.
retry_io_ratioThe ratio of retried I/O requests in the last 1 second.
retry_queue_sizeThe current retry queue size.
active_extentsThe current number of active extents.
active_volumesThe current number of active volumes.
waiting_queue_sizeThe current waiting queue size.

Information:

In a multi–physical disk pool environment, performance metrics are displayed for each chunk individually. To view the overall performance data, run zbs-perf-tools node uio summary.

Viewing the overall performance of the access module

Procedure

Run the following command to view the overall performance information about the access module:

zbs-perf-tools chunk access summary [--chunk-addr <ip>]

ParameterDescription
--chunk-addr <ip>The zbs-chunkd RPC server address. Default: 127.0.0.1:10200, the chunk on the node where the command is run.

Output example

$ sudo zbs-perf-tools chunk access summary
----------------------------------------------------
  host                          127.0.0.1:10200     
  instance_id                   1
  read_iops                     0.00                
  read_latency                  0.00 NS             
  read_bw                       0.00 B/s(0.00 B/s)  
  write_iops                    0.00                
  write_latency                 0.00 NS             
  write_bw                      0.00 B/s(0.00 B/s)  
  total_iops                    0.00                
  total_latency                 0.00 NS             
  total_bw                      0.00 B/s(0.00 B/s)  
  io_hard_rate                  0.00                
  io_retry_rate                 0.00                
  io_timeout_rate               0.00                
  from_local_read_iops          0.00                
  from_local_read_latency       0.00 NS             
  from_local_read_bw            0.00 B/s(0.00 B/s)  
  from_local_write_iops         0.00                
  from_local_write_latency      0.00 NS             
  from_local_write_bw           0.00 B/s(0.00 B/s)  
  from_local_total_iops         0.00                
  from_local_total_latency      0.00 NS             
  from_local_total_bw           0.00 B/s(0.00 B/s)  
  from_local_throttle_latency   0.00 NS             
  from_remote_read_iops         0.00                
  from_remote_read_latency      0.00 NS             
  from_remote_read_bw           0.00 B/s(0.00 B/s)  
  from_remote_write_iops        0.00                
  from_remote_write_latency     0.00 NS             
  from_remote_write_bw          0.00 B/s(0.00 B/s)  
  from_remote_total_iops        0.00                
  from_remote_total_latency     0.00 NS             
  from_remote_total_bw          0.00 B/s(0.00 B/s)  
  from_remote_throttle_latency  0.00 NS             
----------------------------------------------------

Output note

ParameterDescription
read_iopsThe read IOPS of the access module in the last 1 second.
read_latencyThe average read latency of the access module in the last 1 second.
read_bw The read bandwidth of the access module in the last 1 second.
write_iopsThe write IOPS of the access module in the last 1 second.
write_latencyThe average write latency of the access module in the last 1 second.
write_bwThe write bandwidth of the access module in the last 1 second.
total_iopsThe total IOPS of the access module in the last 1 second.
total_latencyThe average total latency of the access module in the last 1 second.
total_bwThe total bandwidth of the access module in the last 1 second.
io_hard_rateThe number of hard I/Os marked by the access module in the last 1 second. Hard I/Os usually occur when there are slow disks in the LSM.
io_retry_rateThe number of read retries in the access module in the last 1 second. When a read replica fails, access attempts to read from the next replica.
io_timeout_rateThe number of I/O timeouts sent to the local access in the last 1 second.
from_local_read_iopsThe read IOPS from local requests processed by access in the last 1 second.
from_local_read_latencyThe average read latency from local requests processed by access in the last 1 second.
from_local_read_bwThe read bandwidth from local requests processed by access in the last 1 second.
from_local_write_iopsThe write IOPS from local requests processed by access in the last 1 second.
from_local_write_latencyThe average write latency from local requests processed by access in the last 1 second.
from_local_write_bwThe write bandwidth from local requests processed by access in the last 1 second.
from_local_total_iopsThe total IOPS from local requests processed by access in the last 1 second.
from_local_total_latencyThe average total latency from local requests processed by access in the last 1 second.
from_local_total_bwThe total bandwidth from local requests processed by access in the last 1 second.
from_local_throttle_latencyThe average latency of throttled I/Os from local requests processed by access in the last 1 second.
from_remote_read_iopsThe read IOPS from remote requests processed by access in the last 1 second.
from_remote_read_latencyThe average read latency from remote requests processed by access in the last 1 second.
from_remote_read_bwThe read bandwidth from remote requests processed by access in the last 1 second.
from_remote_write_iopsThe write IOPS from remote requests processed by access in the last 1 second.
from_remote_write_latencyThe average write latency from remote requests processed by access in the last 1 second.
from_remote_write_bwThe write bandwidth from remote requests processed by access in the last 1 second.
from_remote_total_iopsThe total IOPS from remote requests processed by access in the last 1 second.
from_remote_total_latencyThe average total latency from remote requests processed by access in the last 1 second.
from_remote_total_bwThe total bandwidth from remote requests processed by access in the last 1 second.
from_remote_throttle_latencyThe average latency of throttled I/O from remote requests processed by access in the last 1 second.

Information:

In a multi–physical disk pool environment, performance metrics are displayed for each chunk individually. To view the overall performance data, run zbs-perf-tools node access summary.

Viewing the replica I/O flow and basic statistics of the current access module

Procedure

Run the following command to view the replica I/O flow and basic statistics of the current access module:

zbs-perf-tools chunk access replica_io [--chunk-addr <ip>] [-d]

ParameterDescription
--chunk-addr <ip>The zbs-chunkd RPC server address. Default: 127.0.0.1:10200, the chunk on the node where the command is run.
-dAn array-type parameter. The destination chunk ID, also called cid. If specified, displays only the data for the destination Chunk.

Output example

$zbs-perf-tools chunk access replica_io -d 1 -d 2
  DIRECTION  READ IOPS  READ LATENCY  READ BW             WRITE IOPS  WRITE LATENCY  WRITE BW               TOTAL IOPS  TOTAL LATENCY  TOTAL BW               
--------------------------------------------------------------------------------------------------------------------------------------------------------------
   1 -> 3      0.00       0.00 NS     0.00 B/s(0.00 B/s)    129.00      324.91 US    1.13 MB/s(1.08 MiB/s)    129.00      324.91 US    1.13 MB/s(1.08 MiB/s)  
   1 -> 2      0.00       0.00 NS     0.00 B/s(0.00 B/s)    188.00      166.46 US    2.37 MB/s(2.26 MiB/s)    188.00      166.46 US    2.37 MB/s(2.26 MiB/s)  
   1 -> 1      0.00       0.00 NS     0.00 B/s(0.00 B/s)    209.00      141.29 US    2.49 MB/s(2.38 MiB/s)    209.00      141.29 US    2.49 MB/s(2.38 MiB/s)

Output note

ParameterDescription
DIRECTION The replica I/O flow direction.
READ IOPS The read IOPS in the last 1 second.
READ LATENCY The average read latency in the last 1 second.
READ BW The read bandwidth in the last 1 second.
WRITE IOPSThe write IOPS in the last 1 second.
WRITE LATENCYThe average write latency in the last 1 second.
WRITE BWThe write bandwidth in the last 1 second.
TOTAL IOPSThe total IOPS in the last 1 second.
TOTAL LATENCYThe average total latency in the last 1 second.
TOTAL BWThe total bandwidth in the last 1 second.