»Consul Catalog

Command: consul catalog

The catalog command is used to interact with Consul's catalog via the command line. It exposes top-level commands for reading and filtering data from the registry.

The catalog is also accessible via the HTTP API.

»Basic Examples

List all datacenters:

$ consul catalog datacenters

List all nodes:

$ consul catalog nodes
Node       ID        Address    DC
worker-01  1b662d97  dc1

List all nodes which provide a particular service:

$ consul catalog nodes -service=redis
Node       ID        Address     DC
worker-01  1b662d97   dc1
worker-02  d407a592  dc1

List all services:

$ consul catalog services

List all services on a node:

$ consul catalog services -node=worker-01

For more examples, ask for subcommand help or view the subcommand documentation by clicking on one of the links in the sidebar.


Usage: consul catalog <subcommand>

For the exact documentation for your Consul version, run consul catalog -h to view the complete list of subcommands.

Usage: consul catalog <subcommand> [options] [args]

  # ...

    datacenters    Lists all known datacenters for this agent
    nodes          Lists all nodes in the given datacenter
    services       Lists all registered services in a datacenter

For more information, examples, and usage about a subcommand, click on the name of the subcommand in the sidebar or one of the links below: