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

ParameterDescriptionDefault

server-max

Maximum capacity to retain per server.

50GB per IO-node with a minimum of 100GB

client-max

Maximum capacity to retain per client.

50GB per IO-node with a minimum of 100GB

server-ensure-free

Always maintain at least this much capacity to remain free on servers.

50GB per IO-node with a minimum of 100GB

client-ensure-free

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

ParameterDescription

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

Parameters

ParameterDescription

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