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 ```