For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Parameter
Description
Default

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

The available disk space also limits the effective trace usage. The system always keeps at least the ensure-free reserve available. If it cannot keep even that reserve, it deletes all rotatable traces.

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

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

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

Option
Description

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

Parameter
Description

level

The debug level. Format: 0..10

Last updated