Cli

Table of Contents

View as Markdown

ais log get command

1$ ais log get --help
2NAME:
3 ais log get - Download logs from a selected node or the entire cluster;
4 supports downloading current logs or TAR.GZ archives.
5 e.g.:
6 - 'ais log get NODE_ID /tmp' - download the current log from NODE_ID and save it in the specified directory;
7 - 'ais log get NODE_ID /tmp/out' --refresh 10 - download the current log from NODE_ID as /tmp/out
8 and continuously update it every 10 seconds;
9 - 'ais log get cluster /tmp' - download TAR.GZ archives from all cluster nodes
10 and save them in the specified directory ('get cluster' implies '--all');
11 - 'ais log get NODE_ID --all' - download the complete log archive (TAR.GZ) from NODE_ID;
12 - 'ais log get NODE_ID --all --severity error' - download only errors and warnings from NODE_ID;
13 - 'ais log get NODE_ID --all --severity e' - same as above.
14
15
16USAGE:
17 ais log get NODE_ID [OUT_FILE|OUT_DIR|-] [command options]
18
19OPTIONS:
20 --refresh value interval for continuous monitoring;
21 valid time units: ns, us (or µs), ms, s (default), m, h
22 --count value used together with '--refresh' to limit the number of generated reports, e.g.:
23 '--refresh 10 --count 5' - run 5 times with 10s interval (default: 0)
24 --severity value log severity is either 'info' (default) or 'error', whereby error logs contain both errors and warnings, e.g.:
25 - 'ais show log NODE_ID'
26 - 'ais log show NODE_ID --severity i' - same as above
27 - 'ais show log NODE_ID --severity error' - errors and warnings only
28 - 'ais show log NODE_ID --severity w' - same as above
29 --yes, -y assume 'yes' to all questions
30 --all download all logs
31 --help, -h show help

ais log show command

1$ ais log show --help
2NAME:
3 ais log show - for a given node: show its current log (use '--refresh' to update, '--help' for details)
4
5USAGE:
6 ais log show NODE_ID [command options]
7
8OPTIONS:
9 --refresh value interval for continuous monitoring;
10 valid time units: ns, us (or µs), ms, s (default), m, h
11 --count value used together with '--refresh' to limit the number of generated reports, e.g.:
12 '--refresh 10 --count 5' - run 5 times with 10s interval (default: 0)
13 --severity value log severity is either 'info' (default) or 'error', whereby error logs contain both errors and warnings, e.g.:
14 - 'ais show log NODE_ID'
15 - 'ais log show NODE_ID --severity i' - same as above
16 - 'ais show log NODE_ID --severity error' - errors and warnings only
17 - 'ais show log NODE_ID --severity w' - same as above
18 --log-flush value can be used in combination with '--refresh' to override configured 'log.flush_time'
19 --help, -h show help

ais cluster download-logs command

1$ ais cluster download-logs --help
2NAME:
3 ais cluster download-logs - download log archives from all clustered nodes (one TAR.GZ per node), e.g.:
4 - 'download-logs /tmp/www' - save log archives to /tmp/www directory
5 - 'download-logs --severity w' - errors and warnings to system temporary directory
6 (see related: 'ais log show', 'ais log get')
7
8USAGE:
9 ais cluster download-logs [OUT_DIR] [command options]
10
11OPTIONS:
12 --severity value log severity is either 'i' or 'info' (default, can be omitted), or 'error', whereby error logs contain
13 only errors and warnings, e.g.: '--severity info', '--severity error', '--severity e'
14 --help, -h show help