2015-09-15 01:04:56 +00:00
|
|
|
---
|
|
|
|
|
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.
|
|
|
|
|
---
|
|
|
|
|
|
2015-09-15 03:24:04 +00:00
|
|
|
# Command: agent-members
|
2015-09-15 01:04:56 +00:00
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
2015-09-15 20:39:57 +00:00
|
|
|
<%= general_options_usage %>
|
2015-09-15 01:04:56 +00:00
|
|
|
|
|
|
|
|
## 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.
|
|
|
|
|
|
2015-09-15 03:24:04 +00:00
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
Default view:
|
2015-09-15 01:04:56 +00:00
|
|
|
|
|
|
|
|
```
|
2015-09-15 05:40:30 +00:00
|
|
|
$ nomad agent-members
|
2015-09-15 01:04:56 +00:00
|
|
|
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
|
|
|
|
|
```
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
|
Detailed view:
|
|
|
|
|
|
|
|
|
|
```
|
2015-09-15 05:40:30 +00:00
|
|
|
$ nomad agent-members -detailed
|
2015-09-15 03:24:04 +00:00
|
|
|
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
|
|
|
|
|
```
|
