Manage statistics using the CLI
This page describes how to manage the statistics using the CLI.
Using the CLI, you can:
List statistics types
Command: weka stats list-types
Use the following command line to obtain statistics definition information:
weka stats list-types [<name-or-category>] [--show-internal]
Parameters
name-or-category
Valid name or category to filter by.
show-internal
Also displays internal statistics.
False
View statistics in real-time
Command: weka stats realtime
Use the following command line to obtain the current performance-related statistics of the processes in a one-second interval:
weka stats realtime [<process-ids>] [--raw-units] [--UTC]
Parameters
process-ids
Only show real-time stats of the specified processes in a comma-separated list.
raw-units
Print values in raw units such as bytes and seconds.
Readable format. Examples: 1KiB 234MiB 2GiB.
UTC
Print times in UTC.
Server's local time.
View statistics over time
Command: weka stats
The collected statistics can help analyze system performance and determine the source of issues that may occur during WEKA system runs. Statistics are divided according to categories. When selecting a category, a list of the possible statistics is displayed, from which you can select the specific statistics.
With the exception of real-time statistics, WEKA averages all statistics over one-minute intervals. Therefore, the total value or other aggregates relate to a specific minute.
Use the following command line to manage filters and read statistics:
weka stats [--start-time <start-time>] [--end-time <end-time>] [--interval interval] [--resolution-secs resolution-secs] [--category category][--stat stat] [--process-ids process-ids] [--param param] [--accumulated] [--per-process] [--no-zeros] [--show-internal] [--raw-units] [--UTC]
Parameters
start-time
Start time of the reported period.
Format examples: 5m, -5m, -1d, -1w, 1:00, 01:00, 18:30, 18:30:07, 2018-12-31 10:00, 2018/12/31 10:00, 2018-12-31T10:00, 9:15Z, 10:00+2:00.
-1m
end-time
End time of the reported period.
Format examples: 5m, -5m, -1d, -1w, 1:00, 01:00, 18:30, 18:30:07, 2018-12-31 10:00, 2018/12/31 10:00, 2018-12-31T10:00, 9:15Z, 10:00+2:00.
Current time
interval*
Period of time to be reported. Valid interval in seconds (positive integer).
resolution-secs
Length of each interval in the reported period. The value must be a multiple of 60 seconds
60
category
A specific category for retrieving statistics. Valid categories: CPU, Object Store, Operations, Operations (NFS), Operations (Driver), SSD.
All
stat
The names of the statistics to retrieve.
All
process-ids
A valid process ID.
All
param
For parameterized statistics, it retrieves only the instantiations where the specified parameter has the specified value.
Format: key:val
Example for multiple values:
'--param method:putBlocks --param method:initBlock'
accumulated
Display accumulated statistics instead of rate statistics.
False
per-process
Do not aggregate statistics across processes.
False
no-zeros
Filters out results where the value is 0.
False
show-internal
Display internal statistics.
False
raw-units
Print values in raw units, such as bytes and seconds.
Readable format. (for example: 1KiB 234MiB 2GiB)
UTC
Print times in UTC.
Server's local time.
Set statistics retention
Command: weka stats retention set
Use the following command line to set the statistics retention period.
weka stats retention set <--days days> [--dry-run]
Parameters
days*
Number of days to keep the statistics. Ensure sufficient free disk space per server and the specified number of days.
dry-run
Only tests the required capacity per the retention period.
Use weka stats retention status to view the current retention and weka stats retention restore-default to restore the default retention settings.
Last updated