Send events covering service status
salt.beacons.service.
beacon
(config)¶Scan for the configured services and fire events
Example Config
beacons:
service:
salt-master:
mysql:
The config above sets up beacons to check for the salt-master and mysql services.
The config also supports two other parameters for each service:
onchangeonly: when onchangeonly is True the beacon will fire events only when the service status changes. Otherwise, it will fire an event at each beacon interval. The default is False.
uncleanshutdown: If uncleanshutdown is present it should point to the location of a pid file for the service. Most services will not clean up this pid file if they are shutdown uncleanly (e.g. via kill -9) or if they are terminated through a crash such as a segmentation fault. If the file is present, then the beacon will add uncleanshutdown: True to the event. If not present, the field will be False. The field is only added when the service is NOT running. Omitting the configuration variable altogether will turn this feature off.
Here is an example that will fire an event whenever the state of nginx changes and report an uncleanshutdown. This example is for Arch, which places nginx's pid file in /run.
beacons:
service:
nginx:
onchangeonly: True
uncleanshutdown: /run/nginx.pid
salt.beacons.service.
validate
(config)¶Validate the beacon configuration