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
Value
Default

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

Name
Value
Default

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.

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
Value
Default

start-time

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.

-1m

end-time

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.

Current time

interval*

Period of time to be reported. Valid interval in seconds (positive integer number).

resolution-secs

Length of each interval in the reported period. Must be multiples of 60 seconds

60

category

Specific categories for retrieval of appropriate statistics. Valid existing categories: CPU, Object Store, Operations, Operations (NFS), Operations (Driver), SSD.

All

stat

Valid statistics names

All

process-ids

Valid process id

All

param

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

accumulated

Display accumulated statistics, not rate statistics

False

per-process

Does not aggregate statistics across processes

False

no-zeros

Filters results where the value is 0

False

show-internal

Also displays internal statistics

False

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.

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
Value

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.

Related topic

List of statistics

Last updated