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