# Manage statistics using the CLI Using the CLI, you can: * [List statistics types](#list-statistics-types) * [View statistics in real-time](#view-statistics-in-real-time) * [View statistics over time](#view-statistics-over-time) * [Set statistics retention](#set-statistics-retention) ## List statistics types **Command:** `weka stats list-types` Use the following command line to obtain statistics definition information:\ `weka stats list-types [] [--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 [] [--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. {% hint style="info" %} **Note:** WEKA averages all statistics over one-second intervals. Consequently, the total value or other aggregates relate to a specific minute. {% endhint %} Use the following command line to manage filters and read statistics: `weka stats [--start-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.