github.com/kardianos/nomad@v0.1.3-0.20151022182107-b13df73ee850/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. If a node ID is specified,
    24  then that particular node will be queried, and detailed information will be
    25  displayed.
    26  
    27  ## General Options
    28  
    29  <%= general_options_usage %>
    30  
    31  ## Node Status Options
    32  
    33  * `-short`: Display short output. Used only when querying a single node. Drops
    34    verbose information about node allocations.
    35  
    36  ## Examples
    37  
    38  List view:
    39  
    40  ```
    41  $ nomad node-status
    42  ID                                    DC   Name   Drain  Status
    43  a72dfba2-c01f-49de-5ac6-e3391de2c50c  dc1  node1  false  ready
    44  1f3f03ea-a420-b64b-c73b-51290ed7f481  dc1  node2  false  ready
    45  ```
    46  
    47  Single-node view in short mode:
    48  
    49  ```
    50  $ nomad node-status -short 1f3f03ea-a420-b64b-c73b-51290ed7f481
    51  ID         = 1f3f03ea-a420-b64b-c73b-51290ed7f481
    52  Name       = node2
    53  Class      = 
    54  Datacenter = dc1
    55  Drain      = false
    56  Status     = ready
    57  ```
    58  
    59  Full output for a single node:
    60  
    61  ```
    62  $ nomad node-status 1f3f03ea-a420-b64b-c73b-51290ed7f481
    63  ID         = 1f3f03ea-a420-b64b-c73b-51290ed7f481
    64  Name       = node2
    65  Class      = 
    66  Datacenter = dc1
    67  Drain      = false
    68  Status     = ready
    69  
    70  ### Allocations
    71  ID                                    EvalID                                JobID  TaskGroup  DesiredStatus  ClientStatus
    72  678c51dc-6c55-0ac8-d92d-675a1e8ea6b0  193229c4-aa02-bbe6-f996-fd7d6974a309  job8   grp8       failed         failed
    73  ```