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
Type
Value
Limitations
Mandatory
Default
name-or-category
String
Name or category fo filter by
Valid name or category
No
show-internal
Boolean
Also displays internal statistics
No
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
Name
Type
Value
Limitations
Mandatory
Default
process-ids
Comma-separated strings
Only show real-time stats of these processes
No
raw-units
Boolean
Print values in raw units (bytes, seconds, etc.)
No
Human-readable format, e.g 1KiB 234MiB 2GiB
UTC
Boolean
Print times in UTC
No
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.
Note: WEKA averages all statistics over one-second intervals. Consequently, 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
Name
Type
Value
Limitations
Mandatory
Default
start-time
String
Start time of the reported period
Format: 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
No
-1m
end-time
String
End time of the reported period
Format: 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
No
Current time
interval
String
Period of time to be reported
Valid interval in seconds (positive integer number)
Yes
resolution-secs
String
Length of each interval in the reported period
Must be multiples of 60 seconds
No
60
category
String
Specific categories for retrieval of appropriate statistics
Valid existing categories: CPU, Object Store, Operations, Operations (NFS), Operations (Driver), SSD
No
All
stat
String
Statistics names
Valid statistics names
No
All
process-ids
String
Process id
Valid process-id
No
All
param
String
For parameterized statistics, retrieve only the instantiations where the specified parameter is of the specified value. Multiple values can be supplied for the same key, e.g. '--param method:putBlocks --param method:initBlock'
Format: key:val
No
accumulated
Boolean
Display accumulated statistics, not rate statistics
No
False
per-process
Boolean
Does not aggregate statistics across processes
No
False
no-zeros
Boolean
Filters results where the value is 0
No
False
show-internal
Boolean
Also displays internal statistics
No
False
raw-units
Boolean
Print values in raw units (bytes, seconds, etc.)
No
Human-readable format, e.g 1KiB 234MiB 2GiB
UTC
Boolean
Print times in UTC
No
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
Name
Type
Value
Limitations
Mandatory
Default
days
Number
The Number of days to keep the statistics
Should have enough free disk space per server
Yes
dry-run
Boolean
Only test the required capacity per the retention period
No
Use weka stats retention status to view the current retention and weka stats retention restore-default to restore the default retention settings.
Last updated