github.com/ryanslade/nomad@v0.2.4-0.20160128061903-fc95782f2089/website/source/docs/commands/node-status.html.md.erb (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Commands: node-status"
     4  sidebar_current: "docs-commands-node-status"
     5  description: >
     6    Display information about nodes.
     7  ---
     8  
     9  # Command: node-status
    10  
    11  The `node-status` command is used to display information about client nodes. A
    12  node must first be registered with the servers before it will be visible in this
    13  output.
    14  
    15  ## Usage
    16  
    17  ```
    18  nomad node-status [options] [node]
    19  ```
    20  
    21  If no node ID is passed, then the command will enter "list mode" and dump a
    22  high-level list of all known nodes. This list output contains less information
    23  but is a good way to get a bird's-eye view of things.
    24  
    25  If there is an exact match based on the provided node ID or prefix, then that
    26  particular node will be queried, and detailed information will be displayed.
    27  Otherwise, a list of matching nodes and information will be displayed.
    28  
    29  ## General Options
    30  
    31  <%= general_options_usage %>
    32  
    33  ## Node Status Options
    34  
    35  * `-short`: Display short output. Used only when querying a single node. Drops
    36    verbose information about node allocations.
    37  * `-verbose`: Show full information.
    38  
    39  ## Examples
    40  
    41  List view:
    42  
    43  ```
    44  $ nomad node-status
    45  ID        DC   Name   Drain  Status
    46  a72dfba2  dc1  node1  false  ready
    47  1f3f03ea  dc1  node2  false  ready
    48  ```
    49  
    50  Single-node view in short mode:
    51  
    52  ```
    53  $ nomad node-status -short 1f3f03ea
    54  ID         = 1f3f03ea
    55  Name       = node2
    56  Class      =
    57  Datacenter = dc1
    58  Drain      = false
    59  Status     = ready
    60  ```
    61  
    62  Full output for a single node:
    63  
    64  ```
    65  $ nomad node-status 1f3f03ea
    66  ID         = 1f3f03ea
    67  Name       = node2
    68  Class      =
    69  Datacenter = dc1
    70  Drain      = false
    71  Status     = ready
    72  
    73  ### Allocations
    74  ID        EvalID    JobID  TaskGroup  DesiredStatus  ClientStatus
    75  678c51dc  193229c4  job8   grp8       failed         failed
    76  ```