Skip to content

Latest commit

 

History

History
101 lines (82 loc) · 4.76 KB

performance.md

File metadata and controls

101 lines (82 loc) · 4.76 KB
layout title permalink redirect_from
post
PERFORMANCE
/docs/cli/performance
/cli/performance.md/
/docs/cli/performance.md/

ais performance or (same) ais show performance command supports the following 5 (five) subcommands:

$ ais performance <TAB-TAB>
counters     throughput   latency      capacity     disk

ais show performance latency

Example usage:

$ ais show performance latency --refresh 10

latency ------------------ 13:03:58.329680
TARGET           GET-COLD(n)     GET-COLD-RW(t)  GET-COLD(total/avg size)       GET(n)  GET(t)  GET-REDIR(t)    GET(total/avg size)
t[EkMt8081]      151             2.01s           145.00MiB  983.31KiB           154     2.13s   1.156551ms      154.00MiB  1.00MiB

latency ------------------ 13:04:08.335764
TARGET           GET-COLD(n)     GET-COLD-RW(t)  GET-COLD(total/avg size)       GET(n)  GET(t)  GET-REDIR(t)    GET(total/avg size)
t[EkMt8081]      189             2.04s           181.00MiB  980.66KiB           190     1.86s   892.015µs       190.00MiB  1.00MiB

Notice naming conventions:

  • (n) - counter (total number of operations of a given kind)
  • (t) - time (latency of the operation)

Other notable semantics includes:

metric comment
GET-COLD-RW(t) denotes (remote read, local write) latency, which is a part of the total latency not including the time it takes to transmit requested payload to user
GET(t) GET latency (for cold GETs includes the above)
GET-REDIR(t) time that passes between ais gateway redirecting GET operation to specific target, and this target starting to handle the request

ais show performance counters

$ ais show performance counters --help
NAME:
   ais show performance counters - show (GET, PUT, DELETE, RENAME, EVICT, APPEND) object counts, as well as:
        - numbers of list-objects requests;
        - (GET, PUT, etc.) cumulative and average sizes;
        - associated error counters, if any, and more.

USAGE:
   ais show performance counters [command options] [TARGET_ID]

OPTIONS:
   --refresh value   interval for continuous monitoring;
                     valid time units: ns, us (or µs), ms, s (default), m, h
   --count value     used together with '--refresh' to limit the number of generated reports, e.g.:
                      '--refresh 10 --count 5' - run 5 times with 10s interval (default: 0)
   --no-headers, -H  display tables without headers
   --regex value     regular expression select table columns (case-insensitive), e.g.:
                      --regex "put|err" - show PUT (count), PUT (total size), and all supported error counters;
                      --regex "[a-z]" - show all supported metrics, including those that have zero values across all nodes;
                      --regex "(GET-COLD$|VERSION-CHANGE$)" - show the number of cold GETs and object version changes (updates)
   --units value     show statistics and/or parse command-line specified sizes using one of the following _units of measurement_:
                     iec - IEC format, e.g.: KiB, MiB, GiB (default)
                     si  - SI (metric) format, e.g.: KB, MB, GB
                     raw - do not convert to (or from) human-readable format
   --average-size    show average GET, PUT, etc. request size

ais show performance disk

$ ais show performance disk --help
NAME:
   ais show performance disk - show disk utilization and read/write statistics

USAGE:
   ais show performance disk [command options] [TARGET_ID]

OPTIONS:
   --refresh value   interval for continuous monitoring;
                     valid time units: ns, us (or µs), ms, s (default), m, h
   --count value     used together with '--refresh' to limit the number of generated reports, e.g.:
                      '--refresh 10 --count 5' - run 5 times with 10s interval (default: 0)
   --no-headers, -H  display tables without headers
   --units value     show statistics and/or parse command-line specified sizes using one of the following _units of measurement_:
                     iec - IEC format, e.g.: KiB, MiB, GiB (default)
                     si  - SI (metric) format, e.g.: KB, MB, GB
                     raw - do not convert to (or from) human-readable format
   --regex value     regular expression select table columns (case-insensitive), e.g.:
                      --regex "put|err" - show PUT (count), PUT (total size), and all supported error counters;
                      --regex "[a-z]" - show all supported metrics, including those that have zero values across all nodes;
                      --regex "(GET-COLD$|VERSION-CHANGE$)" - show the number of cold GETs and object version changes (updates)
   --summary         tally up target disks to show per-target read/write summary stats and average utilizations