翻译至：https://www.consul.io/docs/agent/checks.html

代理的主要角色之一是系统级和应用级健康检测的管理。如果健康检查与服务相关联，则认为它是应用级。如果不与服务关联，则健康检测监视整个节点的健康状况。
健康检测在配置文件中定义，或者在运行时通过HTTP接口添加。通过HTTP接口创建的健康检测会在该结点进行持久化。

有五种不同的健康检测：

脚本+时间间隔 - 这些检查依赖于调用外部应用程序来执行健康状况检查，以适当的退出代码退出，并可能产生一些输出。脚本与调用间隔（例如每30秒）组合使用。这与Nagios插件系统类似。脚本检查的输出限制为4KB，大于4kb的输出将被截断。默认情况下，脚本检查将配置30秒的超时时间，也可以在检测定义时通过timeout字段来自定义脚本检查的超时时间。当Windows达到超时时间，Consul将等待脚本产生的任何子进程完成；其他系统一旦超时，Consul将尝试强制终止检测脚本和它产生的任何子进程。在Consul 0.9.0和更高版本中，代理必须配置enable_script_checksset为true以启用脚本检测

HTTP +间隔 - 这些检查每隔一个间隔（例如每隔30秒）向指定的URL发出HTTP GET请求。服务的状态取决于HTTP响应代码：任何2xx代码都被视为检测通过，429是太多请求的警告，其他任何状态码都代表检测失败。这种类型的检查应该优于脚本使用curl或其他外部进程来检测简单的http操作。默认情况下，HTTP检查是GET请求，除非method字段指定了不同的方法。可以通过header字段来设置其它header字段信息，以字符串列表映射的形式设置，例如， {“x-foo”：[“bar”，“baz”]}。默认情况下，HTTP检查请求超时等于检查时间间隔，最大值为10秒，但是也可以通过在检查定义中配置timeout 字段来自定义HTTP检查超时值。http检查的输出限制为4KB，大于4kb的输出将被截断。 HTTP检查也支持SSL。默认要求有效的SSL证书。可以通过在检查定义中将tls_skip_verify字段设置为true来关闭证书验证。

TCP +间隔 - 这种检方式是每隔一个间隔（例如每30秒）对指定的IP /主机名和端口进行TCP连接尝试。如果没有指定主机名，则默认为“localhost”。服务的状态取决于连接尝试是否成功（即 - 端口当前正在接受连接）。如果连接被接受，则服务的状态是成功的，否则是失败的。在主机名同时解析为IPv4和IPv6地址的情况下，将尝试连接这两个地址，并且首次成功的连接尝试将导致成功的检查。如果是简单的套接字操作检测内里优先选择这种检测方式，默认情况下，TCP检查的请求超时等于检查时间间隔，最大值为10秒。可以通过在检查定义中指定timeout字段来配置自定义TCP检查超时值。

TTL检测 - ttl检测会在ttl时间内保留上次的检测状态，检测状态必须通过HTTP接口定期更新，如果外部系统无法在给定的TTL内更新状态，则检查设置为失败状态。这个检测机制依靠应用程序直接报告其健康状况。例如，健康的应用程序可以定期向HTTP端点发送状态更新;如果应用程序失败，TTL将过期，健康检查进入危险状态。 TTL检查还将其最后一次已知的状态保存到磁盘。这允许Consul代理重启后可以恢复检查的最后一个已知状态，持久化的检测状态的有效期为从上次检查时间起到TTL结束时。

Docker+时间间隔 - 这些检查依赖于调用Docker容器中打包的外部应用程序。应用程序通过Docker Exec API在正在运行的容器中触发。Consul代理用户需要访问Docker HTTP API或unix套接字。 Consul使用$ DOCKER_HOST来确定Docker API端点。应用程序将对在容器内运行的服务执行健康检查，并使用适当的退出代码退出。检查应与调用间隔一起使用。需要执行检查的shell是可配置的，这使得可以在同一主机上运行具有多个不同shell的容器。 Docker的检查输出限制为4KB。任何大于此的输出将被截断。在Consul 0.9.0和更高版本中，代理必须配置enable_script_checks设置为true以启用Docker运行状况检查。

检测定义

脚本检测:

{
"check": {
"id": "mem-util",
"name": "Memory utilization",
"args": [
"/usr/local/bin/check_mem.py",
"-limit",
"256MB"
],
"interval": "10s",
"timeout": "1s"
}
}

http检测:

{
"check": {
"id": "api",
"name": "HTTP API on port 5000",
"http": "https://localhost:5000/health",
"tls_skip_verify": false,
"method": "POST",
"header": {
"x-foo": [
"bar",
"baz"
]
},
"interval": "10s",
"timeout": "1s"
}
}

TCP 检测:

{
"check": {
"id": "ssh",
"name": "SSH TCP on port 22",
"tcp": "localhost:22",
"interval": "10s",
"timeout": "1s"
}
}

ttl检测:

{
"check": {
"id": "web-app",
"name": "Web App Status",
"notes": "Web app does a curl internally every 10 seconds",
"ttl": "30s"
}
}

Docker检测:

{
"check": {
"id": "mem-util",
"name": "Memory utilization",
"docker_container_id": "f972c95ebf0e",
"shell": "/bin/bash",
"args": [
"/usr/local/bin/check_mem.py"
],
"interval": "10s"
}
}

每种类型的定义都必须包含一个名称，并且可以选择性地提供一个id和notes字段。每个代理的id都必须是唯一的，否则相同的id号只有最后被定义的检查将被注册。如果没有设置ID并且检查被嵌入在服务定义中，则consul会自动生成唯一的检查ID。否则，id将被设置为name。如果name可能冲突，应提供唯一的ID

注意：Consul 0.9.3和之前的版本需要可选的检查ID来检查嵌入在服务定义中的检查，以通过CheckID字段进行配置。 Consul 1.0同时接受id和CheckID，但后者已被弃用，并将在Consul 1.1中被删除。

notes字段对于Consul而言是不透明的，但是可以用来提供对检查当前状态的可读描述。通过脚本检查，该字段被设置为脚本生成的任何输出。同样，外部程序可以通过HTTP接口更新TTL检查的notes值。

健康检测可以通过包含token字段来提供ACL token,这个token用于与检测目录的任何交互，包括反熵同步和取消注册

Script, TCP, Docker 和HTTP 检测必需包含有 interval 字段. 这个字段会被Go的time包解析,并具有以下格式规范:

时间字符串描述可能是有符号的十进制数字序列，每个都有可选的小数和单位后缀，如“300ms”，“-1.5h”或“2h45m”。有效的时间单位是“ns”，“us”（或“μs”），“ms”，“s”，“m”，“h”。

在Consul 0.7和更高版本中，与服务关联的检查也可能包含一个可选的deregister_critical_service_after字段，该字段与interval和ttl的Go时间格式相同。如果检查处于危险状态超过此配置值，则其相关服务（及其所有相关检查）将自动取消注册。最小超时时间为1分钟，收集危险状态服务的进程每30秒运行一次，因此可能需要比配置的超时稍长的时间来触发注销。通常应该将这个值配置成比给定服务预期的可恢复中断时间长得多的值。

配置检测时，无论是通过-config-file选项提供给代理，或者将其放置在代理的-config-dir中，该文件必须以“.json”的扩展名结尾才能被consul加载。检测定义也可以通过向代理发送SIGHUP来更新。或者，可以使用HTTP API动态注册检测

检测脚本

脚本检测通常可以自由地做任何事情来确定检查的状态。唯一的限制是退出代码必须遵守以下约定：

Exit code 0 -检测通过
Exit code 1 -检测告警
Any other code -检测失败
这是consul依赖的唯一的约定。脚本的任何输出都将被捕获并存储在notes字段中，以便操作人员可以查看

在Consul 0.9.0和更高版本中，代理必须配置enable_script_checks设置为true以启用脚本检查。

在Consul 1.0之前，检测只使用script字段来定义要运行的命令，并且总是在shell中运行。在Consul 1.0中，添加了args数组,因此没有shell的情况下也可以运行检查，script字段已弃用，您应该将shell包含在args中以在shell下运行脚本，例如。 “args”：[“sh”，“-c”，“...”]。
»初始化健康检查状态

默认情况下，一量健康检测在Consul代理注册成功，状态会立即设置为“critical”。这是为了防止服务在被确认为健康之前被注册为“通过”并进入服务池。在某些情况下，可能需要指定健康检查的初始状态。这可以通过在指定检测定义的status字段来实现，如下所示

{
"check": {
"id": "mem",
"args": [
"/bin/check_mem",
"-limit",
"256MB"
],
"interval": "10s",
"status": "passing"
}
}
上面这个服务定义中，检测状态会被注册为 "passing".

服务绑定检测

健康检测可以绑定到指定的服务，这样可以保证检测状态只影响到当前服务而不是整个节点，服务绑定健康检测可以通过添加service_id字段来实现：

Health checks may optionally be bound to a specific service. This ensures that the status of the health check will only affect the health status of the given service instead of the entire node. Service-bound health checks may be provided by adding a service_id field to a check configuration:

{
"check": {
"id": "web-app",
"name": "Web App Status",
"service_id": "web-app",
"ttl": "30s"
}
}
在上述配置中，如果web-app服务健康检测为失败状态，则只会影web-app服务的可用性。节点提供的其他服务将保持不变。

定义多个检测

可以通过关键字checks来定义多个健康检测：

{
"checks": [
{
"id": "chk1",
"name": "mem",
"args": [
"/bin/check_mem",
"-limit",
"256MB"
],
"interval": "5s"
},
{
"id": "chk2",
"name": "/health",
"http": "http://localhost:5000/health",
"interval": "15s"
},
{
"id": "chk3",
"name": "cpu",
"script": "/bin/check_cpu",
"interval": "10s"
},
...
]
}

本文转自 emma_cql 51CTO博客，原文链接:

http://blog.51cto.com/chenql/2044811