Watches是檢視指定資料資訊的一種方法，比如檢視nodes列表、鍵值對、健康檢查。當監控到更新時，可以呼叫外部處理程式——可以自定義。比如，發現健康狀態發生變化可以通知外部系統健康異常。

        Watches在呼叫http api介面使用阻塞佇列。Agent會自動呼叫合適的API介面倆監控資料的變化。

        Watches可以作為Agent配置的一部分。在Agent初始化時就執行，並且支援重新載入配置——執行時新新增或刪除配置。

        Alternatively, the watch command enables a watch to be started outsideof the agent. This can be used by an operator to inspect data in Consul or toeasily pipe data into processes without being tied to the agent lifecycle.

        在任意情況下，watches的type都必須指定。Watch支援的每一個type需要的不同的引數，一些是必須的一些事非必須的。這些都是通過JSON來設定的。

1.1.1  Handle

        Watch配置可以指定監控的資料。一旦資料發生變化，可以執行指定的處理程式——可以是任意可執行的程式。

        處理程式可以從標準輸入中讀取輸入，也可以讀取json資料。資料格式依賴於watch型別。Watch型別與Json格式是想物件的。因為watch是直接呼叫HTTP API，因此輸入資料要格式化。

Additionally, the CONSUL_INDEX environment variable will beset. This maps to theX-Consul-Index value in responses from the 

1.1.2  GlobalParameters

        除了每一種型別支援的引數外，還有一些全域性引數：

datacenter – 資料中心名字

token – ALC token

handler – 監控到資料變化後的呼叫程式。

1.1.3  Watches型別

        支援如下型別：

1. Key – 監視指定K/V鍵值對
2. Keyprefix – Watch a prefix in the KV store
3. Services – 監視服務列表
4. nodes – 監控節點列表
5. service – 監視服務例項
6. checks- 監視健康檢查的值
7. event – 監視使用者事件

1.1.3.1     型別key

        Key watch型別通常用來監視指定鍵值對的變化。要求提供key引數

例項

{
  "type": "key",
  "key": "foo/bar/baz",
  "handler": "/usr/bin/my-key-handler.sh"
}

        使用命令列：

$ consul watch -type key -key foo/bar/baz/usr/bin/my-key-handler.sh

輸出資訊：

{
  "Key": "foo/bar/baz",
  "CreateIndex": 1793,
  "ModifyIndex": 1793,
  "LockIndex": 0,
  "Flags": 0,
  "Value": "aGV5",
  "Session": ""
}

1.1.3.2     型別keyprefix

        Keyprefix型別是用來監視KV儲存中keys的字首。必須提供prefix引數。

        監視會返回匹配prefix的所有鍵值對。

示例：

{
  "type": "keyprefix",
  "prefix": "foo/",
  "handler": "/usr/bin/my-prefix-handler.sh"
}

命令列：

$ consul watch -typekeyprefix -prefix foo/ /usr/bin/my-prefix-handler.sh

輸出結果：

[
  {
    "Key": "foo/bar",
    "CreateIndex": 1796,
    "ModifyIndex": 1796,
    "LockIndex": 0,
    "Flags": 0,
    "Value": "TU9BUg==",
    "Session": ""
  },
  {
    "Key": "foo/baz",
    "CreateIndex": 1795,
    "ModifyIndex": 1795,
    "LockIndex": 0,
    "Flags": 0,
    "Value": "YXNkZg==",
    "Session": ""
  },
  {
    "Key": "foo/test",
    "CreateIndex": 1793,
    "ModifyIndex": 1793,
    "LockIndex": 0,
    "Flags": 0,
    "Value": "aGV5",
    "Session": ""
  }
]

1.1.3.3     型別services

        監視一系列有效的service，無引數

        內部介面/v1/catalog/services

命令列輸出資訊如下：

{
  "consul": [],
  "redis": [],
  "web": []
}

1.1.3.4     型別nodes

        監視一系列有效的節點，無引數。

        內部API：/v1/catalog/nodes

輸出資訊：

[
  {
    "Node": "nyc1-consul-1",
    "Address": "192.241.159.115"
  },
  {
    "Node": "nyc1-consul-2",
    "Address": "192.241.158.205"
  },
  {
    "Node": "nyc1-consul-3",
    "Address": "198.199.77.133"
  },
  {
    "Node": "nyc1-worker-1",
    "Address": "162.243.162.228"
  },
  {
    "Node": "nyc1-worker-2",
    "Address": "162.243.162.226"
  },
  {
    "Node": "nyc1-worker-3",
    "Address": "162.243.162.229"
  }
]

1.1.3.5     型別service

        監控指定的單個service。必須提供引數service。tag和passingonly引數可選。

        內部介面：/v1/health/service

配置示例：

{
  "type": "service",
  "service": "redis",
  "handler": "/usr/bin/my-service-handler.sh"
}

命令列：

$ consul watch -typeservice -service redis /usr/bin/my-service-handler.sh

輸出資訊：

[
  {
    "Node": {
      "Node": "foobar",
      "Address": "10.1.10.12"
    },
    "Service": {
      "ID": "redis",
      "Service": "redis",
      "Tags": null,
      "Port": 8000
    },
    "Checks": [
      {
        "Node": "foobar",
        "CheckID": "service:redis",
        "Name": "Service'redis' check",
        "Status": "passing",
        "Notes": "",
        "Output": "",
        "ServiceID": "redis",
        "ServiceName": "redis"
      },
      {
        "Node": "foobar",
        "CheckID": "serfHealth",
        "Name": "SerfHealth Status",
        "Status": "passing",
        "Notes": "",
        "Output": "",
        "ServiceID": "",
        "ServiceName": ""
      }
    ]
  }
]

1.1.3.6     型別checks

        監視指定service的checks或指定狀態的checks。

        內部介面/v1/health/state/或/v1/health/checks/

[
  {
    "Node": "foobar",
    "CheckID": "service:redis",
    "Name": "Service'redis' check",
    "Status": "passing",
    "Notes": "",
    "Output": "",
    "ServiceID": "redis",
    "ServiceName": "redis"
  }
]

1.1.3.7     型別event

        監視使用者事件。

        內部介面：v1/event/list

配置檔案示例：

{
  "type": "event",
  "name": "web-deploy",
  "handler": "/usr/bin/my-deploy-handler.sh"
}

命令列引數：

$ consul watch -typeevent -name web-deploy /usr/bin/my-deploy-handler.sh

輸出

[
  {
    "ID": "f07f3fcc-4b7d-3a7c-6d1e-cf414039fcee",
    "Name": "web-deploy",
    "Payload": "MTYwOTAzMA==",
    "NodeFilter": "",
    "ServiceFilter": "",
    "TagFilter": "",
    "Version": 1,
    "LTime": 18
  },
  ...
]