github.com/NVIDIA/aistore@v1.3.23-0.20240517131212-7df6609be51d/docs/cli/show.md (about) 1 --- 2 layout: post 3 title: SHOW 4 permalink: /docs/cli/show 5 redirect_from: 6 - /cli/show.md/ 7 - /docs/cli/show.md/ 8 --- 9 10 # `ais show` command 11 12 AIS CLI `show` command can universally be used to view summaries and details on a cluster and its nodes, buckets and objects, running and finished jobs - in short, _all_ managed entities (see below). The command is a "hub" for all information-viewing commands that are currently supported. 13 14 For easy usage, all `show` commands have been aliased to their respective top-level counterparts: 15 16 ```console 17 $ ais show <command> 18 ``` 19 is equivalent to: 20 ```console 21 $ ais <command> show 22 ``` 23 24 > For instance, `ais performance show` is an alias for `ais show performance` - both can be used interchangeably. 25 26 > As a general rule, instead of remembering any of the above (as well as any of the below), type (e.g.) `ais perf<TAB-TAB>` and press `Enter`. 27 28 > You can also hit <TAB-TAB>` maybe a few more times while typing a few more letters in between. Any combination will work. 29 30 > When part-typing, part-TABing a sequence of words that (will eventually) constitute a valid AIS CLI command, type `--help` at any time. This will display short description, command-line options, usage examples, and other context-sensitive information. 31 32 > For usage examples, another way to quickly find them would be a good-and-old keyword search. E.g., `cd aistore; grep -n "ais.*cp" docs/cli/*.md`, and similar. Additional useful tricks (including `ais search`) are also mentioned elsewhere in the documentation. 33 34 As far as `ais show`, the command currently extends as follows: 35 36 ```console 37 $ ais show <TAB-TAB> 38 auth bucket performance rebalance remote-cluster log 39 object cluster storage config job 40 ``` 41 42 In other words, there are currently 11 subcommands that are briefly described in the rest of this text. 43 44 ## Table of Contents 45 - [`ais show performance`](#ais-show-performance) 46 - [`ais show job`](#ais-show-job) 47 - [`ais show cluster`](#ais-show-cluster) 48 - [`ais show auth`](#ais-show-auth) 49 - [`ais show bucket`](#ais-show-bucket) 50 - [`ais show object`](#ais-show-object) 51 - [`ais show storage`](#ais-show-storage) 52 - [`ais show config`](#ais-show-config) 53 - [`ais show remote-cluster`](#ais-show-remote-cluster) 54 - [`ais show rebalance`](#ais-show-rebalance) 55 - [`ais show log`](#ais-show-log) 56 57 ## `ais show performance` 58 59 The command has 5 subcommands: 60 61 ```console 62 $ ais show performance 63 counters throughput latency capacity disk 64 ``` 65 66 The command provides a quick single-shot overview of cluster performance. If you type `ais show performance` and instead of `<TAB-TAB>` hit `Enter`, the command will show performance counters, aggregated cluster throughput statistics, and the other 3 tables (latency, capacity, disk IO) - in sequence, one after another. 67 68 The command's help screen follows below - notice the command-line options (aka flags): 69 70 ```console 71 $ ais show performance --help 72 NAME: 73 ais show performance - show performance counters, throughput, latency, and more (press <TAB-TAB> to select specific view) 74 75 USAGE: 76 ais show performance command [command options] [TARGET_ID] 77 78 COMMANDS: 79 counters show (GET, PUT, DELETE, RENAME, EVICT, APPEND) object counts, as well as: 80 - numbers of list-objects requests; 81 - (GET, PUT, etc.) cumulative and average sizes; 82 - associated error counters, if any, and more. 83 throughput show GET and PUT throughput, associated (cumulative, average) sizes and counters 84 latency show GET, PUT, and APPEND latencies and average sizes 85 capacity show target mountpaths, disks, and used/available capacity 86 disk show disk utilization and read/write statistics 87 88 OPTIONS: 89 --refresh value interval for continuous monitoring; 90 valid time units: ns, us (or µs), ms, s (default), m, h 91 --count value used together with '--refresh' to limit the number of generated reports (default: 0) 92 --all when printing tables, show all columns including those that have only zero values 93 --no-headers, -H display tables without headers 94 --regex value regular expression to select table columns (case-insensitive), e.g.: --regex "put|err" 95 --units value show statistics and/or parse command-line specified sizes using one of the following _units of measurement_: 96 iec - IEC format, e.g.: KiB, MiB, GiB (default) 97 si - SI (metric) format, e.g.: KB, MB, GB 98 raw - do not convert to (or from) human-readable format 99 --average-size show average GET, PUT, etc. request size 100 --help, -h show help 101 ``` 102 103 As one would maybe expect, `--refresh`, `--units` and all the other listed flags universally work across all `performance` subcommands. 104 105 For instance, you could continuously run several screens to simultaneously display a variety of performance-related aspects: 106 107 ```console 108 # screen #1 109 110 $ ais show performance counters --refresh 5 111 ``` 112 113 ```console 114 # screen #2 115 116 $ ais show performance throughput --refresh 5 117 ``` 118 119 and so on - all the 5 tables with 5-seconds periodicity, or any other time interval(s) of your choosing. 120 121 As far as continuous monitoring goes, this (approach) has a chance to provide a good overall insight. A poor-man's addition, if you will, to the popular (and also supported) tools such as Grafana and Prometheus. But available with zero setup out of the box (which is a plus). 122 123 ### What's running 124 125 Use `ais show performance` and its variations in combination with `ais show job` (and variations). The latter shows what's running in the cluster, and thus combining the two may make sense. 126 127 ### See also 128 129 * [Observability](/docs/metrics.md) 130 * [Prometheus](/docs/prometheus.md) 131 132 ## `ais show job` 133 134 The command has no statically defined subcommands. When you type `ais show job <TAB-TAB>`, the resulting set of shell completions will only include job names (aka "kinds") that are **currently running**. Example: 135 136 ```console 137 $ ais show job <TAB-TAB> 138 move-bck rebalance 139 ``` 140 141 Just maybe to reiterate the same slightly differently: `ais show job <TAB-TAB>` won't produce anything useful iff the cluster currently doesn't run any jobs 142 143 On the other hand, job-identifying selections `[NAME] [JOB_ID] [NODE_ID] [BUCKET]`: 144 145 1. are all optional, and 146 2. can be typed in an arbitrary order 147 148 Example: 149 150 ```console 151 $ ais show job xhcTyUfJF t[Kritxhbt] 152 ``` 153 154 is the same as: 155 156 ```console 157 $ ais show job t[Kritxhbt] xhcTyUfJF 158 ``` 159 160 In both cases, we are asking a specific target node (denoted as `NODE_ID` in the command's help) for a specific job ID (denoted as `JOB_ID`). 161 162 Selection-wise, this would be the case of ultimate specificity. Accordingly, on the opposite side of the spectrum would be something like: 163 164 ```console 165 $ ais show job --all 166 ``` 167 168 The `--all` flag always defines the broadest scope possible, and so the query `ais show job --all` includes absolutely all jobs, running and finished (succeeded and aborted). 169 170 Here's at a glance: 171 172 ```console 173 $ ais show job --help 174 NAME: 175 ais show job - show running and finished jobs ('--all' for all, or press <TAB-TAB> to select, '--help' for options) 176 177 USAGE: 178 ais show job [command options] [NAME] [JOB_ID] [NODE_ID] [BUCKET] 179 180 OPTIONS: 181 --refresh value interval for continuous monitoring; 182 valid time units: ns, us (or µs), ms, s (default), m, h 183 --count value used together with '--refresh' to limit the number of generated reports (default: 0) 184 --json, -j json input/output 185 --all all jobs, including finished and aborted 186 --regex value regular expression to select jobs by name, kind, or description, e.g.: --regex "ec|mirror|elect" 187 --no-headers, -H display tables without headers 188 --verbose, -v verbose 189 --units value show statistics and/or parse command-line specified sizes using one of the following _units of measurement_: 190 iec - IEC format, e.g.: KiB, MiB, GiB (default) 191 si - SI (metric) format, e.g.: KB, MB, GB 192 raw - do not convert to (or from) human-readable format 193 --progress show progress bar(s) and progress of execution in real time 194 --log value path to file where the metrics will be saved 195 --help, -h show help 196 ``` 197 198 ### Example: show all currently running jobs, and narrow the selection to a given target node: 199 200 ```console 201 202 $ ais show job t[ugoFtqUrrm] 203 NODE ID KIND BUCKET OBJECTS BYTES START END STATE 204 ugoFtqUrrm vOYSo5pHG ec-get mybucket-ec-rebalance - - 12-03 10:32:25 - Running 205 ugoFtqUrrm b4Ks45pHv ec-get mybucket-obj-n-slice 9 42.36MiB 12-03 10:31:33 - Running 206 ugoFtqUrrm vUYSo5pHvS ec-put mybucket-ec-rebalance 3 1.43MiB 12-03 10:32:25 - Running 207 ugoFtqUrrm Kobs45pHvS ec-put mybucket-obj-n-slice 9 4.75MiB 12-03 10:31:33 - Running 208 ugoFtqUrrm U8UcSo5pHv ec-resp mybucket-ec-rebalance 18 89.45MiB 12-03 10:32:25 - Running 209 ugoFtqUrrm M8M6sodqmv ec-resp mybucket-obj-n-slice 13 64.49MiB 12-03 10:31:34 - Idle 210 ugoFtqUrrm Ioa31VqaB list mybucket-ec-rebalance 5 - 12-03 10:32:32 12-03 10:32:42 Aborted 211 ugoFtqUrrm X3H381Vqau list mybucket-ec-rebalance 3 - 12-03 10:32:29 12-03 10:32:42 Aborted 212 ugoFtqUrrm g5 rebalance - 6 25.59MiB 12-03 10:32:32 12-03 10:32:39 Finished 213 ``` 214 215 ### Example: show a job by name, and include finished/aborted: 216 217 ```console 218 $ ais show job resilver --all 219 resilver[G0p7yXYiUg] 220 NODE ID KIND OBJECTS BYTES START END STATE 221 HAAt8090 G0p7yXYiUg resilver 11 18.38KiB 13:04:51 13:04:51 Finished 222 JVnt8086 G0p7yXYiUg resilver 10 14.86KiB 13:04:51 13:04:51 Finished 223 LDgt8088 G0p7yXYiUg resilver 14 20.81KiB 13:04:51 13:04:51 Finished 224 OBIt8089 G0p7yXYiUg resilver 4 7.04KiB 13:04:51 13:04:51 Finished 225 VUCt8091 G0p7yXYiUg resilver 9 14.50KiB 13:04:51 13:04:51 Finished 226 qVJt8087 G0p7yXYiUg resilver 9 14.21KiB 13:04:51 13:04:51 Finished 227 ``` 228 229 > Here and elsewhere in the documentation, CLI colors used to highlight certain (notable) items on screen - are not shown. 230 231 > On a related note: coloring can be disabled via `ais config cli set no_color`. 232 233 ### Example: continuous monitoring 234 235 ```console 236 $ ais show job --refresh 5 237 238 rebalance[g2] 239 NODE ID KIND OBJECTS BYTES START END STATE 240 HAAt8090 g2 rebalance 2072 3.05MiB 13:35:00 - Running 241 JVnt8086 g2 rebalance 2 2.08KiB 13:35:00 - Running 242 LDgt8088 g2 rebalance 4 6.46KiB 13:35:00 - Running 243 OBIt8089 g2 rebalance 4 7.39KiB 13:35:00 - Running 244 VUCt8091 g2 rebalance - - 13:35:00 - Running 245 qVJt8087 g2 rebalance - - 13:35:00 - Running 246 ------------------------------------------------------------------------ 247 rebalance[g2] 248 NODE ID KIND OBJECTS BYTES START END STATE 249 HAAt8090 g2 rebalance 2072 3.05MiB 13:35:00 - Running 250 JVnt8086 g2 rebalance 2 2.08KiB 13:35:00 - Running 251 LDgt8088 g2 rebalance 4 6.46KiB 13:35:00 - Running 252 OBIt8089 g2 rebalance 4 7.39KiB 13:35:00 - Running 253 VUCt8091 g2 rebalance - - 13:35:00 - Running 254 qVJt8087 g2 rebalance - - 13:35:00 - Running 255 ------------------------------------------------------------------------ 256 No running jobs. Use '--all' to show all, '--all' <TAB-TAB> to select, '--help' for details. 257 ------------------------------------------------------------------------ 258 ec-get[wHUgmjFaJ] 259 NODE ID BUCKET OBJECTS BYTES ERRORS QUEUE AVG TIME START END ABORTED 260 OBIt8089 wHUgmjFaJ ais://TESTAISBUCKET-ec-rebalance - - - - - 13:35:24 - false 261 ec-get[P3SqrpURnv] 262 NODE ID BUCKET OBJECTS BYTES ERRORS QUEUE AVG TIME START END ABORTED 263 VUCt8091 P3SqrpURnv ais://TESTAISBUCKET-ec-rebalance - - - - - 13:35:24 - false 264 ec-get[u3pGCzmh4] 265 NODE ID BUCKET OBJECTS BYTES ERRORS QUEUE AVG TIME START END ABORTED 266 JVnt8086 u3pGCzmh4 ais://TESTAISBUCKET-ec-rebalance - - - - - 13:35:24 - false 267 268 ... 269 270 list[n2O4CJxUg] 271 NODE ID KIND BUCKET OBJECTS BYTES START END STATE 272 HAAt8090 n2O4CJxUg list ais://TESTAISBUCKET-ec-rebalance 10 32.51MiB 13:36:55 - Idle 273 JVnt8086 n2O4CJxUg list ais://TESTAISBUCKET-ec-rebalance 16 52.96MiB 13:36:55 - Idle 274 LDgt8088 n2O4CJxUg list ais://TESTAISBUCKET-ec-rebalance 2 3.59MiB 13:36:55 - Idle 275 OBIt8089 n2O4CJxUg list ais://TESTAISBUCKET-ec-rebalance 6 11.72MiB 13:36:55 - Idle 276 VUCt8091 n2O4CJxUg list ais://TESTAISBUCKET-ec-rebalance 10 37.53MiB 13:36:55 - Idle 277 list[J-bfCJxVp] 278 NODE ID KIND BUCKET OBJECTS BYTES START END STATE 279 qVJt8087 J-bfCJxVp list ais://TESTAISBUCKET-ec-rebalance 22 60.91MiB 13:37:18 - Idle 280 rebalance[g8] 281 NODE ID KIND OBJECTS BYTES START END STATE 282 HAAt8090 g8 rebalance 4 27.46MiB 13:37:18 - Running 283 JVnt8086 g8 rebalance 2 4.42MiB 13:37:18 - Running 284 LDgt8088 g8 rebalance 2 9.96MiB 13:37:18 - Running 285 OBIt8089 g8 rebalance 4 23.49MiB 13:37:18 - Running 286 VUCt8091 g8 rebalance 32 - 13:37:18 - Running 287 qVJt8087 g8 rebalance 6 39.38MiB 13:37:18 - Running 288 ^[^C$ ais show job --refresh 5 289 rebalance[g15] 290 NODE ID KIND OBJECTS BYTES START END STATE 291 HAAt8090 g15 rebalance 648 971.49KiB 13:40:54 - Running 292 JVnt8086 g15 rebalance 688 1.01MiB 13:40:54 - Running 293 LDgt8088 g15 rebalance 554 833.21KiB 13:40:54 - Running 294 OBIt8089 g15 rebalance 734 1.07MiB 13:40:54 - Running 295 VUCt8091 g15 rebalance - - 13:40:54 - Running 296 qVJt8087 g15 rebalance 694 1.02MiB 13:40:54 - Running 297 ------------------------------------------------------------------------ 298 299 ... 300 ``` 301 302 ### See also 303 304 - [definitions: `xaction` vs `job`](/docs/batch.md) 305 - [CLI: `ais job` command](/docs/cli/job.md) 306 - [CLI: `dsort` (distributed shuffle)](/docs/cli/dsort.md) 307 - [CLI: `download` from any remote source](/docs/cli/download.md) 308 - [built-in `rebalance`](/docs/rebalance.md) 309 - [multi-object operations](/docs/cli/object.md#operations-on-lists-and-ranges) 310 - [reading, writing, and listing archives](/docs/cli/object.md) 311 - [copying buckets](/docs/cli/bucket.md#copy-bucket) 312 313 ## `ais show cluster` 314 315 The first command to think of when deploying a new cluster. Useful as well when looking for the shortest quickest summary of what's running and what's going on. The subcommands and brief description follows: 316 317 ```console 318 # ais show cluster <TAB-TAB> 319 proxy target smap bmd config stats 320 ``` 321 322 ```console 323 $ ais show cluster --help 324 NAME: 325 ais show cluster - show cluster nodes and utilization 326 327 USAGE: 328 ais show cluster command [command options] [NODE_ID] | [target [NODE_ID]] | [proxy [NODE_ID]] | [smap [NODE_ID]] | [bmd [NODE_ID]] | [config [NODE_ID]] | [stats [NODE_ID]] 329 330 COMMANDS: 331 smap show Smap (cluster map) 332 bmd show BMD (bucket metadata) 333 config show cluster and node configuration 334 stats (alias for "ais show performance") show performance counters, throughput, latency, and more (press <TAB-TAB> to select specific view) 335 336 OPTIONS: 337 --refresh value interval for continuous monitoring; 338 valid time units: ns, us (or µs), ms, s (default), m, h 339 --count value used together with '--refresh' to limit the number of generated reports (default: 0) 340 --json, -j json input/output 341 --no-headers, -H display tables without headers 342 --help, -h show help 343 ``` 344 345 ### Example usage with no parameters and a _different_ endpoint 346 347 ```console 348 $ export AIS_ENDPOINT=http://10.0.1.148:51080 349 $ ais show cluster 350 351 PROXY MEM USED(%) MEM AVAIL UPTIME K8s POD STATUS 352 p[EciZrNdH][P] 0.01% 363.51GiB 94d ais-proxy-2 online 353 p[HPpnlgpj] 0.01% 363.66GiB 94d ais-proxy-0 online 354 p[LZOkYuAf] 0.01% 362.62GiB 94d ais-proxy-8 online 355 p[NXDmWuAV] 0.01% 363.68GiB 94d ais-proxy-6 online 356 p[OzRhyuOB] 0.01% 363.73GiB 94d ais-proxy-4 online 357 p[WwpvNugq] 0.01% 363.17GiB 94d ais-proxy-9 online 358 p[cAQpRMET] 0.01% 363.56GiB 94d ais-proxy-1 online 359 p[eYQteCHG] 0.01% 363.81GiB 94d ais-proxy-7 online 360 p[ehkGLcSD] 0.01% 363.57GiB 94d ais-proxy-3 online 361 p[reZqfbjy] 0.01% 363.67GiB 94d ais-proxy-5 online 362 363 TARGET MEM USED(%) MEM AVAIL CAP USED(%) CAP AVAIL CPU USED(%) UPTIME K8s POD STATUS 364 t[KopwySra] 0.15% 363.54GiB 77.67% 31.825TiB 15.38% 94d ais-target-1 online 365 t[MgHbIvNG] 0.16% 363.65GiB 77.00% 30.941TiB 14.06% 94d ais-target-4 online 366 t[WoLgoQEW] 0.16% 363.72GiB 78.00% 31.763TiB 17.67% 94d ais-target-7 online 367 t[fXFQnenn] 0.11% 363.83GiB 78.00% 31.751TiB 18.12% 94d ais-target-6 online 368 t[fwKlswQP] 0.16% 363.62GiB 78.33% 31.758TiB 19.81% 94d ais-target-5 online 369 t[tFUiHCCO] 0.16% 363.76GiB 79.00% 31.617TiB 19.47% 94d ais-target-8 online 370 t[tfNkAtFk] 0.16% 363.55GiB 77.33% 31.875TiB 19.70% 94d ais-target-2 online 371 t[uxvpIDPc] 0.15% 362.57GiB 77.67% 31.846TiB 16.56% 94d ais-target-0 online 372 t[vAWmZZPv] 0.11% 363.68GiB 78.67% 31.608TiB 23.09% 94d ais-target-3 online 373 t[wSJzGVnU] 0.10% 363.33GiB 76.67% 30.972TiB 17.13% 94d ais-target-9 online 374 375 Summary: 376 Proxies: 10 (0 unelectable) 377 Targets: 10 378 Cluster Map: version 1512, UUID AGetvIKTz, primary p[EciZrNdH] 379 Deployment: K8s 380 Status: 20 online 381 Rebalance: n/a 382 Authentication: disabled 383 Version: 3.12.85636aa 384 Build: 2022-11-16T17:55:50+0000 385 ``` 386 387 > `AIS_ENDPOINT` is part of the `AIS_**` [environment](https://github.com/NVIDIA/aistore/blob/main/api/env/ais.go). 388 389 > `AIS_ENDPOINT` can point to any AIS gateway (proxy) in a given cluster. Does not necessarily have to be the _primary_ gateway. 390 391 > For CLI, in particular, `AIS_ENDPOINT` overrides cluster's endpoint that's currently configured. To view or change the configured endpoint (or any other CLI configuration item), run `ais config cli`. 392 393 ### See also 394 395 * [`ais cluster` command](cluster.md#cluster-or-daemon-status) 396 397 398 ## `ais show auth` 399 The following subcommands are currently supported: 400 401 ```console 402 cluster show registered clusters 403 role show existing user roles 404 user show users or user details 405 config show AuthN server configuration 406 ``` 407 408 [Refer to `ais auth` documentation for details and examples.](auth.md#command-list) 409 410 411 ## `ais show bucket` 412 Show bucket properties. 413 414 [Refer to `ais bucket` documentation for details and examples.](bucket.md#show-bucket-properties) 415 416 ## `ais show object` 417 Show object details. 418 419 [Refer to `ais object` documentation for details and examples.](object.md#show-object-properties) 420 421 ## `ais show storage` 422 Show storage usage and utilization in the cluster. Show disks and mountpaths - for a single selected node or for all storage nodes. 423 424 When run with no subcommands, `ais show storage` defaults to `ais show storage disk`. 425 426 In addition, the command support the following subcommands: 427 428 ```console 429 # ais show storage <TAB-TAB> 430 disk mountpath capacity summary 431 ``` 432 433 And with brief subcommand descriptions: 434 435 ```console 436 $ ais show storage --help 437 NAME: 438 ais show storage - show storage usage and utilization, disks and mountpaths 439 440 USAGE: 441 ais show storage command [command options] [TARGET_ID] 442 443 COMMANDS: 444 disk show disk utilization and read/write statistics 445 mountpath show target mountpaths 446 capacity show target mountpaths, disks, and used/available capacity 447 summary show bucket sizes and %% of used capacity on a per-bucket basis 448 449 OPTIONS: 450 --refresh value interval for continuous monitoring; 451 valid time units: ns, us (or µs), ms, s (default), m, h 452 --count value used together with '--refresh' to limit the number of generated reports (default: 0) 453 --json, -j json input/output 454 --help, -h show help 455 ``` 456 457 [Refer to `ais storage` documentation for details and examples.](storage.md) 458 459 ## `ais show config` 460 Show daemon configuration. 461 462 [Refer to `ais cluster` documentation for details and examples.](config.md##show-configuration) 463 464 ## `ais show remote-cluster` 465 Show information about attached AIS clusters. 466 467 [Refer to `ais cluster` documentation for details and examples.](cluster.md#show-remote-clusters) 468 469 ## `ais show rebalance` 470 471 Display details about the most recent rebalance xaction. 472 473 | Flag | Type | Description | Default | 474 | --- | --- | --- | --- | 475 | `--refresh` | `duration` | Watch global rebalance at a given refresh interval. The usual unit suffixes are supported and include `m` (for minutes), `s` (seconds), `ms` (milliseconds). Press Ctrl-C to stop monitoring. | ` ` | 476 | `--all` | `bool` | If set, show all rebalance xactions | `false` | 477 478 ### Example 479 480 ```console 481 $ ais show rebalance 482 REB ID NODE OBJECTS RECV SIZE RECV OBJECTS SENT SIZE SENT START TIME END TIME ABORTED 483 g1 CASGt8088 0 0B 0 0B 03-25 17:33:54 - false 484 g1 DMwvt8089 0 0B 0 0B 03-25 17:33:54 - false 485 g1 ejpCt8086 0 0B 0 0B 03-25 17:33:54 - false 486 g1 kiuvt8091 0 0B 0 0B 03-25 17:33:54 - false 487 g1 oGvbt8090 0 0B 0 0B 03-25 17:33:54 - false 488 g1 xZntt8087 0 0B 0 0B 03-25 17:33:54 - false 489 490 $ ais show rebalance 491 REB ID NODE OBJECTS RECV SIZE RECV OBJECTS SENT SIZE SENT START TIME END TIME ABORTED 492 g1 CASGt8088 0 0B 0 0B 03-25 17:33:54 03-25 17:34:09 false 493 g1 DMwvt8089 0 0B 0 0B 03-25 17:33:54 03-25 17:34:08 false 494 g1 ejpCt8086 0 0B 0 0B 03-25 17:33:54 03-25 17:34:08 false 495 g1 kiuvt8091 0 0B 0 0B 03-25 17:33:54 03-25 17:34:08 false 496 g1 oGvbt8090 0 0B 0 0B 03-25 17:33:54 03-25 17:34:08 false 497 g1 xZntt8087 0 0B 0 0B 03-25 17:33:54 03-25 17:34:09 false 498 499 Rebalance completed. 500 ``` 501 502 ## `ais show log` 503 504 There are 3 enumerated log severities and, respectively, 3 types of logs generated by each node: 505 * error 506 * warning 507 * info 508 509 ### Example 1. Show "info" log: 510 511 ```console 512 # Use <TAB-TAB> auto-completion to select a node (run `ais show cluster` to show details) 513 $ ais show log 514 p[f6ytNhIhb] p[OqlWpgwrY] ... 515 t[jkrt8Nkqi] t[Juwzq371P] ... 516 517 # Type `p[O`<TAB-TAB> to complete the node ID and then use `less` (for instance) to search, scroll or page down (or up), etc. 518 $ ais show log p[OqlWpgwrY] | less 519 520 Log file created at: 2021/04/11 10:58:38 521 Running on machine: u18044 522 Binary: Built with gc go1.15.3 for linux/amd64 523 Log line format: L hh:mm:ss.uuuuuu file:line] msg 524 I 10:58:38.122973 config.go:1611 log.dir: "/ais/log"; l4.proto: tcp; port: 51080; verbosity: 3 525 ... 526 : 527 ``` 528 529 ### Example 2: show errors and/or warnings 530 531 By default, `ais show log` shows "info" log (that also contains all warnings and errors). 532 533 To show _only_ errors, run: 534 ```console 535 ais show log OqlWpgwrY --severity=error 536 537 # or, same 538 ais show log OqlWpgwrY --severity=e | more 539 ``` 540 541 For warnings _and_ errors, run: 542 ```console 543 ais show log OqlWpgwrY --severity=warning 544 545 # or, same 546 ais show log OqlWpgwrY --severity=w | less 547 ``` 548