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
server-max	Maximum capacity to retain per server.	50 GB per IO node with a minimum of 100 GB
client-max	Maximum capacity to retain per client.	50 GB per IO node with a minimum of 100 GB
server-ensure-free	Always maintain at least this much capacity to remain free on servers.	3 GB
client-ensure-free	Always maintain at least this much capacity to remain free on clients.	3 GB

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
level*	Verbosity level. Format: low or high

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 <comment> [--start-time start-time] [--end-time end-time] [--retention retention]

Parameters

Parameter	Description
comment *	A descriptive note providing context for easier tracking and review of debug traces.
start-time	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
end-time	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
retention	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