open-nomad/website/source/docs/commands/agent-members.html.md.erb

50 lines
1.3 KiB
Plaintext

---
layout: "docs"
page_title: "Commands: agent-members"
sidebar_current: "docs-commands-agent-members"
description: >
Display a list of the known cluster members and their status.
---
# Command: agent-members
The `agent-members` command displays a list of the known servers in the cluster
and their current status. Member information is provided by the gossip protocol,
which is only run on server nodes.
## Usage
```
nomad agent-members [options]
```
## General Options
<%= general_options_usage %>
## Members Options
* `-detailed`: Dump the basic member information as well as the raw set of tags
for each member. This mode reveals additional information not displayed in the
standard output format.
## Examples
Default view:
```
$ nomad agent-members
Name Addr Port Status Proto Build DC Region
node1.global 10.0.0.8 4648 alive 2 0.1.0dev dc1 global
node2.global 10.0.0.9 4648 alive 2 0.1.0dev dc1 global
```
Detailed view:
```
$ nomad agent-members -detailed
Name Addr Port Tags
node1 10.0.0.8 4648 bootstrap=1,build=0.1.0dev,vsn=1,vsn_max=1,dc=dc1,port=4647,region=global,role=nomad,vsn_min=1
node2 10.0.0.9 4648 bootstrap=0,build=0.1.0dev,vsn=1,vsn_max=1,dc=dc1,port=4647,region=global,role=nomad,vsn_min=1
```