## Comments begin with a '#' and extend through the end of the line. Keywords
## are case insensitive. All path's MUST BE FULLY QUALIFIED, starting with '/'.
##
-## Bellow is the example of some frequently used statements. For information
-## about the control file, a complete list of statements and options please
-## have a look in the monit manual.
+## Below you will find examples of some frequently used statements. For
+## information about the control file and a complete list of statements and
+## options, please have a look in the Monit manual.
##
##
###############################################################################
## Global section
###############################################################################
##
-## Start monit in background (run as daemon) and check the services at 2-minute
-## intervals.
+## Start Monit in the background (run as a daemon):
#
-# set daemon 120
+# set daemon 120 # check services at 2-minute intervals
+# with start delay 240 # optional: delay the first check by 4-minutes (by
+# # default Monit check immediately after Monit start)
#
#
## Set syslog logging with the 'daemon' facility. If the FACILITY option is
-## omited, monit will use 'user' facility by default. You can specify the
-## path to the file for monit native logging.
+## omitted, Monit will use 'user' facility by default. If you want to log to
+## a standalone log file instead, specify the full path to the log file
#
-# set logfile syslog facility log_daemon
+# set logfile syslog facility log_daemon
#
#
-## Set list of mailservers for alert delivery. Multiple servers may be
-## specified using comma separator. By default monit uses port 25 - it is
-## possible to override it with the PORT option.
+### Set the location of the Monit id file which stores the unique id for the
+### Monit instance. The id is generated and stored on first Monit start. By
+### default the file is placed in $HOME/.monit.id.
+#
+# set idfile /var/.monit.id
+#
+### Set the location of the Monit state file which saves monitoring states
+### on each cycle. By default the file is placed in $HOME/.monit.state. If
+### the state file is stored on a persistent filesystem, Monit will recover
+### the monitoring state across reboots. If it is on temporary filesystem, the
+### state will be lost on reboot which may be convenient in some situations.
+#
+# set statefile /var/.monit.state
+#
+## Set the list of mail servers for alert delivery. Multiple servers may be
+## specified using a comma separator. By default Monit uses port 25 - it is
+## possible to override this with the PORT option.
#
# set mailserver mail.bar.baz, # primary mailserver
# backup.bar.baz port 10025, # backup mailserver on port 10025
# localhost # fallback relay
#
#
-## By default monit will drop the event alert, in the case that there is no
-## mailserver available. In the case that you want to keep the events for
-## later delivery retry, you can use the EVENTQUEUE statement. The base
-## directory where undelivered events will be stored is specified by the
-## BASEDIR option. You can limit the maximal queue size using the SLOTS
-## option (if omited then the queue is limited just by the backend filesystem).
+## By default Monit will drop alert events if no mail servers are available.
+## If you want to keep the alerts for later delivery retry, you can use the
+## EVENTQUEUE statement. The base directory where undelivered alerts will be
+## stored is specified by the BASEDIR option. You can limit the maximal queue
+## size using the SLOTS option (if omitted, the queue is limited by space
+## available in the back end filesystem).
#
# set eventqueue
# basedir /var/monit # set the base directory where events will be stored
-# slots 100 # optionaly limit the queue size
+# slots 100 # optionally limit the queue size
+#
+#
+## Send status and events to M/Monit (for more informations about M/Monit
+## see http://mmonit.com/).
+#
+# set mmonit http://monit:monit@192.168.1.10:8080/collector
#
#
## Monit by default uses the following alert mail format:
## Description: $DESCRIPTION #
## #
## Your faithful employee, #
-## monit #
+## Monit #
## --8<--
##
-## You can override the alert message format or its parts such as subject
+## You can override this message format or parts of it, such as subject
## or sender using the MAIL-FORMAT statement. Macros such as $DATE, etc.
-## are expanded on runtime. For example to override the sender:
+## are expanded at runtime. For example, to override the sender, use:
#
# set mail-format { from: monit@foo.bar }
#
#
-## You can set the alert recipients here, which will receive the alert for
-## each service. The event alerts may be restricted using the list.
+## You can set alert recipients whom will receive alerts if/when a
+## service defined in this file has errors. Alerts may be restricted on
+## events by using a filter as in the second example below.
#
# set alert sysadm@foo.bar # receive all alerts
# set alert manager@foo.bar only on { timeout } # receive just service-
# # timeout alert
#
#
-## Monit has an embedded webserver, which can be used to view the
-## configuration, actual services parameters or manage the services using the
-## web interface.
+## Monit has an embedded web server which can be used to view status of
+## services monitored and manage services from a web interface. See the
+## Monit Wiki if you want to enable SSL for the web server.
#
# set httpd port 2812 and
# use address localhost # only accept connection from localhost
# allow localhost # allow localhost to connect to the server and
# allow admin:monit # require user 'admin' with password 'monit'
+# allow @monit # allow users of group 'monit' to connect (rw)
+# allow @users readonly # allow users of group 'users' to connect readonly
#
#
###############################################################################
## Services
###############################################################################
##
-## Check the general system resources such as load average, cpu and memory
-## usage. Each rule specifies the tested resource, the limit and the action
-## which will be performed in the case that the test failed.
+## Check general system resources such as load average, cpu and memory
+## usage. Each test specifies a resource, conditions and the action to be
+## performed should a test fail.
#
# check system myhost.mydomain.tld
# if loadavg (1min) > 4 then alert
#
#
## Check a file for existence, checksum, permissions, uid and gid. In addition
-## to the recipients in the global section, customized alert will be send to
-## the additional recipient. The service may be grouped using the GROUP option.
+## to alert recipients in the global section, customized alert can be sent to
+## additional recipients by specifying a local alert handler. The service may
+## be grouped using the GROUP option. More than one group can be specified by
+## repeating the 'group name' statement.
#
# check file apache_bin with path /usr/local/apache/bin/httpd
# if failed checksum and
# group server
#
#
-## Check that a process is running, responding on the HTTP and HTTPS request,
-## check its resource usage such as cpu and memory, number of childrens.
-## In the case that the process is not running, monit will restart it by
-## default. In the case that the service was restarted very often and the
-## problem remains, it is possible to disable the monitoring using the
-## TIMEOUT statement. The service depends on another service (apache_bin) which
-## is defined in the monit control file as well.
+## Check that a process is running, in this case Apache, and that it respond
+## to HTTP and HTTPS requests. Check its resource usage such as cpu and memory,
+## and number of children. If the process is not running, Monit will restart
+## it by default. In case the service is restarted very often and the
+## problem remains, it is possible to disable monitoring using the TIMEOUT
+## statement. This service depends on another service (apache_bin) which
+## is defined above.
#
# check process apache with pidfile /usr/local/apache/logs/httpd.pid
-# start program = "/etc/init.d/httpd start"
+# start program = "/etc/init.d/httpd start" with timeout 60 seconds
# stop program = "/etc/init.d/httpd stop"
# if cpu > 60% for 2 cycles then alert
# if cpu > 80% for 5 cycles then restart
# if children > 250 then restart
# if loadavg(5min) greater than 10 for 8 cycles then stop
# if failed host www.tildeslash.com port 80 protocol http
-# and request "/monit/doc/next.php"
+# and request "/somefile.html"
# then restart
# if failed port 443 type tcpssl protocol http
# with timeout 15 seconds
# group server
#
#
-## Check the device permissions, uid, gid, space and inode usage. Other
-## services such as databases may depend on this resource and automatical
-## graceful stop may be cascaded to them before the filesystem will become
-## full and the data will be lost.
+## Check filesystem permissions, uid, gid, space and inode usage. Other services,
+## such as databases, may depend on this resource and an automatically graceful
+## stop may be cascaded to them before the filesystem will become full and data
+## lost.
#
-# check device datafs with path /dev/sdb1
+# check filesystem datafs with path /dev/sdb1
# start program = "/bin/mount /data"
# stop program = "/bin/umount /data"
# if failed permission 660 then unmonitor
# group server
#
#
-## Check a file's timestamp: when it becomes older then 15 minutes, the
-## file is not updated and something is wrong. In the case that the size
-## of the file exceeded given limit, perform the script.
+## Check a file's timestamp. In this example, we test if a file is older
+## than 15 minutes and assume something is wrong if its not updated. Also,
+## if the file size exceed a given limit, execute a script
#
# check file database with path /data/mydatabase.db
# if failed permission 700 then alert
# if failed uid data then alert
# if failed gid data then alert
# if timestamp > 15 minutes then alert
-# if size > 100 MB then exec "/my/cleanup/script"
+# if size > 100 MB then exec "/my/cleanup/script" as uid dba and gid dba
#
#
-## Check the directory permission, uid and gid. An event is triggered
-## if the directory does not belong to the user with the uid 0 and
-## the gid 0. In the addition the permissions have to match the octal
-## description of 755 (see chmod(1)).
+## Check directory permission, uid and gid. An event is triggered if the
+## directory does not belong to the user with uid 0 and gid 0. In addition,
+## the permissions have to match the octal description of 755 (see chmod(1)).
#
# check directory bin with path /bin
# if failed permission 755 then unmonitor
# if failed gid 0 then unmonitor
#
#
-## Check the remote host network services availability and the response
-## content. One of three pings, a successfull connection to a port and
-## application level network check is performed.
+## Check a remote host availability by issuing a ping test and check the
+## content of a response from a web server. Up to three pings are sent and
+## connection to a port and an application level network check is performed.
#
# check host myserver with address 192.168.1.1
# if failed icmp type echo count 3 with timeout 3 seconds then alert
# if failed port 3306 protocol mysql with timeout 15 seconds then alert
-# if failed url
-# http://user:password@www.foo.bar:8080/?querystring
+# if failed url http://user:password@192.168.1.1:8080/?querystring
# and content == 'action="j_security_check"'
# then alert
#
## Includes
###############################################################################
##
-## It is possible to include the configuration or its parts from other files or
+## It is possible to include additional configuration parts from other files or
## directories.
#
-# include /etc/monit.d/*
-#
-#
+
+include /etc/monit/conf.d/*
+