74 lines
1.9 KiB
Plaintext
74 lines
1.9 KiB
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Commands: node-status"
|
|
sidebar_current: "docs-commands-node-status"
|
|
description: >
|
|
Display information about nodes.
|
|
---
|
|
|
|
# Command: node-status
|
|
|
|
The `node-status` command is used to display information about client nodes. A
|
|
node must first be registered with the servers before it will be visible in this
|
|
output.
|
|
|
|
## Usage
|
|
|
|
```
|
|
nomad node-status [options] [node]
|
|
```
|
|
|
|
If no node ID is passed, then the command will enter "list mode" and dump a
|
|
high-level list of all known nodes. This list output contains less information
|
|
but is a good way to get a bird's-eye view of things. If a node ID is specified,
|
|
then that particular node will be queried, and detailed information will be
|
|
displayed.
|
|
|
|
## General Options
|
|
|
|
<%= general_options_usage %>
|
|
|
|
## Node Status Options
|
|
|
|
* `-short`: Display short output. Used only when querying a single node. Drops
|
|
verbose information about node allocations.
|
|
|
|
## Examples
|
|
|
|
List view:
|
|
|
|
```
|
|
$ nomad node-status
|
|
ID DC Name Drain Status
|
|
a72dfba2-c01f-49de-5ac6-e3391de2c50c dc1 node1 false ready
|
|
1f3f03ea-a420-b64b-c73b-51290ed7f481 dc1 node2 false ready
|
|
```
|
|
|
|
Single-node view in short mode:
|
|
|
|
```
|
|
$ nomad node-status -short 1f3f03ea-a420-b64b-c73b-51290ed7f481
|
|
ID = 1f3f03ea-a420-b64b-c73b-51290ed7f481
|
|
Name = node2
|
|
Class =
|
|
Datacenter = dc1
|
|
Drain = false
|
|
Status = ready
|
|
```
|
|
|
|
Full output for a single node:
|
|
|
|
```
|
|
$ nomad node-status 1f3f03ea-a420-b64b-c73b-51290ed7f481
|
|
ID = 1f3f03ea-a420-b64b-c73b-51290ed7f481
|
|
Name = node2
|
|
Class =
|
|
Datacenter = dc1
|
|
Drain = false
|
|
Status = ready
|
|
|
|
### Allocations
|
|
ID EvalID JobID TaskGroup DesiredStatus ClientStatus
|
|
678c51dc-6c55-0ac8-d92d-675a1e8ea6b0 193229c4-aa02-bbe6-f996-fd7d6974a309 job8 grp8 failed failed
|
|
```
|