Performs installation and configuration of Monit service, along with fine grained definition of checks.
All check types provided by Monit are supported. Namely: directory, fifo,
file, filesystem, host, process, program, and system.
In adition to primitive types, a compound check type is provided: service.
It is a set of primitives to check a service's init script, binary and process.
service check type can work with sysv, systemd or upstart. In 0.3.x
series it defaults to sysv for compatibility reasons. From 1.0.x onwards it
defaults to the init system that each supported OS configures by default.
The init type to use can be also set per service. See below for details.
monit class is the responsible of installing and configuring the Monit
service. Almost all configuration options for monitrc are exposed as class
parameters.
In addition to Monit configuration options, this class accepts other parameters:
-
init_system, to set globally the default init system forservicechecks. -
checks, useful to pass in Monit checks declared in Hiera.
Lastly, this class also configures a system check with sane defaults. It can
be disabled or tweaked to fit your needs. This check includes loadavg, cpu,
memory, swap and filesytem tests.
See manifests/init.pp for a reference of all supported parameters.
Check types are implemented by defined types, named after monit::check::TYPE.
All check types have several configuration options in common (ex: group,
priority, alerts, dependencies, etc.), along with the check specific options.
See manifests/check/*.pp for a reference of parameters accepted by each check type.
On the other hand, monit::check defined type is a facade for all check types.
It works as a single entry point to declare any type of check in the same way.
Common configuration options are parameters of the defined type, and check
specific options are passed through a hash in the config parameter.
See manifests/check.pp
for a reference of all parameters accepted by monit::check.
There's a bunch of examples for configuring real services across Debian and RedHat families in sbitio/ducktape. Please refer to manifests/*/external/monit.pp files.
# Main monitrc configuration options. monit::check_interval : '60' monit::check_start_delay : '120' monit::mailserver : 'localhost' monit::eventqueue : true monit::alerts : - 'root@localhost' - 'sla1@example.com only on { timeout, nonexist }' monit::httpserver : true monit::httpserver_allow : - 'admin:secret' # Tweak system check. monit::system_fs : ['/', '/mnt/backups'] # Add some checks. monit::checks : somefs : type : 'filesystem' config : path : '/mount/somefs' tests : - type: 'fsflags' - type: 'permission' value: '0755' - type: 'space' operator: '>' value: '80%' sshd : type : 'process' config : pidfile : '/var/run/sshd.pid' program_start : '/etc/init.d/sshd start' program_stop : '/etc/init.d/sshd stop' tests : - type : 'connection' host : '127.0.0.1' port : '22' protocol : 'ssh' action : 'restart' php5-fpm : type : process config : pidfile : '/var/run/php5-fpm.pid' binary : '/usr/sbin/php5-fpm' program_start : '/etc/init.d/php5-fpm start' program_stop : '/etc/init.d/php5-fpm stop' tests : - type : 'connection' host : '127.0.0.1' port : '9000'' socket_type : 'TCP' protocol : 'GENERIC' protocol_test : - send : '"\0x01\0x09\0x00\0x00\0x00\0x00\0x08\0x00\0x00\0x00\0x00\0x00\0x00\0x00\0x00\0x00"' expect : '"\0x01\0x0A"' action : 'restart' ntp: type : process config : pidfile : '/var/run/ntpd.pid' program_start : '/etc/init.d/ntpd start' program_stop : '/etc/init.d/ntpd stop' tests : - type : connection host : 127.0.0.1 socket_type : udp port : 123 protocol : ntp action : restart varnish: type : 'process' config : pidfile : '/var/run/varnish.pid' program_start : '/etc/init.d/varnish start' program_stop : '/etc/init.d/varnish stop' tests : - type: 'connection' host: '127.0.0.1' port: '8080' protocol: 'http' protocol_test: request: '/health.varnish' - type : 'cpu(user)' operator : '>' value : '60%' tolerance : cycles : '2' - type : 'children' operator : '>' value : '150' httpd: type : 'service' config : pidfile : '/var/run/httpd/httpd.pid' binary : '/usr/sbin/httpd' initd : '/etc/init.d/httpd' tests : - type: 'connection' host: '127.0.0.1' port: '80' protocol: 'http'
MIT License, see LICENSE file
Use contact form on http://sbit.io
Please log tickets and issues on GitHub