---
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 there is an exact match based on the provided node ID or prefix, then that
particular node will be queried, and detailed information will be displayed.
Otherwise, a list of matching nodes and 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
```