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.