16.23. cdist-type__consul_check(7)

16.23.1. NAME

cdist-type__consul_check - Manages consul checks

16.23.2. DESCRIPTION

Generate and deploy check definitions for a consul agent. See http://www.consul.io/docs/agent/checks.html for parameter documentation.

Use either script together with interval, or use ttl.

16.23.3. REQUIRED PARAMETERS

None.

16.23.4. OPTIONAL PARAMETERS

docker-container-id

the id of the docker container to run

http

the url to check

id

The id of this check.

interval

the interval in which the check should run

name

The name of this check. Defaults to __object_id

notes

human readable description

script

the shell command to run

service-id

the id of the service this check is bound to

shell

the shell to run inside the docker container

state

if this check is 'present' or 'absent'. Defaults to 'present'.

status

specify the initial state of this health check

tcp

the host and port to check

timeout

after how long to timeout checks which take to long

token

ACL token to use for interacting with the catalog

ttl

how long a TTL check is considered healthy without being updated through the HTTP interface

16.23.5. EXAMPLES

__consul_check redis \
   --script /usr/local/bin/check_redis.py \
   --interval 10s

__consul_check some-object-id \
   --id web-app \
   --name "Web App Status" \
   --notes "Web app does a curl internally every 10 seconds" \
   --ttl 30s

16.23.6. SEE ALSO

cdist-type__consul_agent(7)

16.23.7. AUTHORS

Steven Armstrong <steven-cdist--@--armstrong.cc>

16.23.8. COPYING

Copyright (C) 2015-2016 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.