github.com/NVIDIA/aistore@v1.3.23-0.20240517131212-7df6609be51d/docs/cli/log.md (about)

     1  ---
     2  layout: post
     3  title: LOG
     4  permalink: /docs/cli/log
     5  redirect_from:
     6   - /cli/log.md/
     7   - /docs/cli/log.md/
     8  ---
     9  
    10  # Table of Contents
    11  - [Download log or all logs (including history)](#ais-log-get-command)
    12  - [View current log](#ais-log-show-command)
    13  - [Download cluster logs](#ais-cluster-download-logs-command)
    14  
    15  # `ais log get` command
    16  
    17  ```console
    18  $ ais log get --help
    19  NAME:
    20     ais log get - download log (or all logs including history) from selected node or all nodes in the cluster, e.g.:
    21                 - 'ais log get NODE_ID /tmp' - download the specified node's current log; save the result to the specified directory;
    22                 - 'ais log get NODE_ID /tmp/out --refresh 10' - download the current log as /tmp/out
    23                    keep updating (ie., appending) the latter every 10s;
    24                 - 'ais log get cluster /tmp' - download TAR.GZ archived logs from _all_ nodes in the cluster
    25                    ('cluster' implies '--all') and save the result to the specified destination;
    26                 - 'ais log get NODE_ID --all' - download the node's TAR.GZ log archive
    27                 - 'ais log get NODE_ID --all --severity e' - TAR.GZ archive of (only) logged errors and warnings
    28  
    29  USAGE:
    30     ais log get [command options] NODE_ID [OUT_FILE|OUT_DIR|-]
    31  
    32  OPTIONS:
    33     --refresh value   interval for continuous monitoring;
    34                       valid time units: ns, us (or µs), ms, s (default), m, h
    35     --count value     used together with '--refresh' to limit the number of generated reports, e.g.:
    36                        '--refresh 10 --count 5' - run 5 times with 10s interval (default: 0)
    37     --severity value  log severity is either 'info' (default) or 'error', whereby error logs contain both errors and warnings, e.g.:
    38                       - 'ais show log NODE_ID'
    39                       - 'ais log show NODE_ID --severity i' - same as above
    40                       - 'ais show log NODE_ID --severity error' - errors and warnings only
    41                       - 'ais show log NODE_ID --severity w' - same as above
    42     --yes, -y         assume 'yes' to all questions
    43     --all             download all logs
    44     --help, -h        show help
    45  ```
    46  
    47  # `ais log show` command
    48  
    49  ```console
    50  $ ais log show --help
    51  NAME:
    52     ais log show - for a given node: show its current log (use '--refresh' to update, '--help' for details)
    53  
    54  USAGE:
    55     ais log show [command options] NODE_ID
    56  
    57  OPTIONS:
    58     --refresh value    interval for continuous monitoring;
    59                        valid time units: ns, us (or µs), ms, s (default), m, h
    60     --count value      used together with '--refresh' to limit the number of generated reports, e.g.:
    61                         '--refresh 10 --count 5' - run 5 times with 10s interval (default: 0)
    62     --severity value   log severity is either 'info' (default) or 'error', whereby error logs contain both errors and warnings, e.g.:
    63                        - 'ais show log NODE_ID'
    64                        - 'ais log show NODE_ID --severity i' - same as above
    65                        - 'ais show log NODE_ID --severity error' - errors and warnings only
    66                        - 'ais show log NODE_ID --severity w' - same as above
    67     --log-flush value  can be used in combination with '--refresh' to override configured 'log.flush_time'
    68     --help, -h         show help
    69  ```
    70  
    71  # `ais cluster download-logs` command
    72  
    73  ```console
    74  $ ais cluster download-logs --help
    75  NAME:
    76     ais cluster download-logs - download log archives from all clustered nodes (one TAR.GZ per node), e.g.:
    77                 - 'download-logs /tmp/www' - save log archives to /tmp/www directory
    78                 - 'download-logs --severity w' - errors and warnings to system temporary directory
    79                   (see related: 'ais log show', 'ais log get')
    80  
    81  USAGE:
    82     ais cluster download-logs [command options] [OUT_DIR]
    83  
    84  OPTIONS:
    85     --severity value  log severity is either 'i' or 'info' (default, can be omitted), or 'error', whereby error logs contain
    86                       only errors and warnings, e.g.: '--severity info', '--severity error', '--severity e'
    87     --help, -h        show help
    88  ```