luxolus/open-consul
2
0
Fork 0
Code Issues 1 Pull requests Packages Releases Wiki Activity
open-consul/website/source/docs/commands/watch.html.markdown
Michael Chapman 20826efaa2 website: Fix list of types available to watch 
The list of types erroneously had services listed twice in place
of 'service' and 'services'
2015-02-13 11:20:26 +11:00

2.1 KiB
Raw Blame History

layout page_title sidebar_current description
docs Commands: Watch docs-commands-watch The `watch` command provides a mechanism to watch for changes in a particular data view (list of nodes, service members, key value, etc) and to invoke a process with the latest values of the view. If no process is specified, the current values are dumped to stdout which can be a useful way to inspect data in Consul.

Consul Watch

Command: consul watch

The watch command provides a mechanism to watch for changes in a particular data view (list of nodes, service members, key value, etc) and to invoke a process with the latest values of the view. If no process is specified, the current values are dumped to stdout which can be a useful way to inspect data in Consul.

There is more documentation on watches here.

Usage

Usage: consul watch [options] [child...]

The only required option is -type which specifies the particular data view. Depending on the type, various options may be required or optionally provided. There is more documentation on watch specifications here.

The list of available flags are:

  • -http-addr - Address to the HTTP server of the agent you want to contact to send this command. If this isn't specified, the command will contact "127.0.0.1:8500" which is the default HTTP address of a Consul agent.

  • -datacenter - Datacenter to query. Defaults to that of agent.

  • -token - ACL token to use. Defaults to that of agent.

  • -key - Key to watch. Only for key type.

  • -name- Event name to watch. Only for event type.

  • -passingonly=[true|false] - Should only passing entries be returned. Default false. only for service type.

  • -prefix - Key prefix to watch. Only for keyprefix type.

  • -service - Service to watch. Required for service type, optional for checks type.

  • -state - Check state to filter on. Optional for checks type.

  • -tag - Service tag to filter on. Optional for service type.

  • -type - Watch type. Required, one of "key", "keyprefix", "services", "nodes", "service", "checks", or "event".