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

Limit the output to a specific statistic name, category, or category label (in parenthesis).

show-internal

Include internal statistics in the output.

False

Examples

  • Filter by category label ( "api statistics" )

$ weka stats list-types "api statistics"
CATEGORY  CATEGORY LABEL  IDENTIFIER    DESCRIPTION         LABEL                       TYPE      UNIT      PARAMETERS  RELATED RATE PARAMETER  PERMISSION  FOR NODE TYPE  CAN ACCUMULATE  HISTOGRAM  HISTOGRAM UNIT
api       api statistics  TOTAL_2xx_RQ  Total 2xx requests  Total 2xx requests (total)  Absolute  Requests                                      USER        MANAGEMENT     True            False
api       api statistics  TOTAL_3xx_RQ  Total 3xx requests  Total 3xx requests (total)  Absolute  Requests                                      USER        MANAGEMENT     True            False
api       api statistics  TOTAL_429_RQ  Total 429 requests  Total 429 requests (total)  Absolute  Requests                                      USER        MANAGEMENT     True            False
api       api statistics  TOTAL_4xx_RQ  Total 4xx requests  Total 4xx requests (total)  Absolute  Requests                                      USER        MANAGEMENT     True            False
api       api statistics  TOTAL_5xx_RQ  Total 5xx requests  Total 5xx requests (total)  Absolute  Requests                                      USER        MANAGEMENT     True            False

  • Filter by name and category ( api )

  • Include internal stats and filter by name and category ( config )

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.

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

Name
Value
Default

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

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.

PreviousManage statistics using the GUINextStatistics list

Last updated