Manage traces and protocols debug level using the CLI
Configure, freeze, and reset traces, and adjust protocols debug levels using the CLI.
Traces
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
server-max
Maximum capacity to retain per server.
50 GiB per I/O process, with a minimum of 100 GiB and a maximum of 1000 GiB per server.
client-max
Maximum capacity to retain per client.
50 GiB per I/O process, with a minimum of 100 GiB and a maximum of 1000 GiB per client.
server-ensure-free
Always maintain at least this much capacity to remain free on servers.
3 GiB
client-ensure-free
Always maintain at least this much capacity to remain free on clients.
3 GiB
To modify the trace retention setting of a single client, you can use the traces_capacity_mb mount option. 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
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
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
Command: weka debug traces freeze reset
Protocols debug level
Show S3 debug level
Command: weka s3 log-level get
Manage NFS debug level
Command: weka nfs debug-level show|set
Command options
show
Shows the debug level for the NFS servers.
set
Sets the debug level for the NFS servers. When you complete debugging, return the debug level to default (creates an event).
Set SMB debug level
Command: weka smb cluster debug
Parameters
level
The debug level.
Format: 0..10
Last updated