Manage the checks that should be run on a machine by I(Sensu). ,Most options do not have a default and will not be added to the check definition unless specified. ,All defaults except I(path), I(state), I(backup) and I(metric) are not managed by this module, ,they are simply specified for your convenience.


  • The name of the check
  • This is the key that is used to determine whether a check exists
state Whether the check should be present or not
  • present
  • absent
  • Path to the json file of the check to be added/removed.
  • Will be created if it does not exist (unless I(state=absent)).The parent folders need to exist when I(state=present), otherwise an error will be thrown
  • Create a backup file (if yes), including the timestamp information so
  • you can get the original file back if you somehow clobbered it incorrectly.
  • yes
  • no
command Path to the sensu check to run (not required when I(state=absent)) true
handlers List of handlers to notify when the check fails
  • List of subscribers/channels this check should run for
  • See sensu_subscribers to subscribe a machine to a channel
interval Check interval in seconds
timeout Timeout for the check
handle Whether the check should be handled or not
  • yes
  • no
subdue_begin When to disable handling of check failures
subdue_end When to enable handling of check failures
  • Other checks this check depends on, if dependencies fail,
  • handling of this check will be disabled
metric Whether the check is a metric
  • yes
  • no
  • Whether the check should be scheduled by the sensu client or server
  • This option obviates the need for specifying the I(subscribers) option
  • yes
  • no
  • Whether the check should be scheduled at all.
  • You can still issue it via the sensu api
  • yes
  • no
occurrences Number of event occurrences before the handler should take action
refresh Number of seconds handlers should wait before taking second action
  • Classifies the check as an aggregate check,
  • making it available via the aggregate API
  • yes
  • no
low_flap_threshold The low threshhold for flap detection
high_flap_threshold The low threshhold for flap detection


Anders Ingemann (@andsens)