Manage traces using the CLI
Manage trace settings using the CLI commands:
Initiate trace collection
Stop trace collection
View traces configuration status
Modify traces retention settings
Adjust traces verbosity level to high or low
Manage the traces freeze period
Initiate trace collection
Command: weka debug traces start
Stop trace collection
Command: weka debug traces stop
View traces configuration status
Command: weka debug traces status
Modify traces retention settings
Command: weka debug traces retention set [--server-max server-max] [--client-max client-max] [--server-ensure-free server-ensure-free] [--client-ensure-free client-ensure-free]
Parameters
Parameter | Description | Default |
---|---|---|
| Maximum capacity to retain per server. | 50GB per IO-node with a minimum of 100GB |
| Maximum capacity to retain per client. | 50GB per IO-node with a minimum of 100GB |
| Always maintain at least this much capacity to remain free on servers. | 50GB per IO-node with a minimum of 100GB |
| Always maintain at least this much capacity to remain free on clients. | 50GB per IO-node with a minimum of 100GB |
To modify the trace retention setting of a single client, you can use the traces_capacity_mb
mount command. See Additional mount options using the stateless clients feature.
Restore default traces retention values
Command: weka debug traces retention restore-default
Adjust traces verbosity level
Command: weka debug traces level set <level>
Parameters
Parameter | Description |
---|---|
| Verbosity level. Format: |
Manage the traces freeze period
View the frozen trace period
Command: weka debug traces freeze show
Set the freeze period
Command: weka debug traces freeze set [--start-time start-time] [--end-time end-time] [--retention retention]
Parameters
Parameter | Description |
---|---|
| The start time of the frozen 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, 2019-Nov-17 11:11:00.309, 9:15Z, 10:00+2:00 |
| The end time of the frozen 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, 2019-Nov-17 11:11:00.309, 9:15Z, 10:00+2:00 |
| The time to retain the traces. Format: 3s, 2h, 4m, 1d, 1d5h, 1w, infinite/unlimited |
Reset the traces freeze period and delete the existing frozen traces
Command: weka debug traces freeze reset