## 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, 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) and check services at
+## 2-minute intervals.
#
# set daemon 120
#
#
## 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 stand alone log file instead, specify the path to a 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 list of mail servers for alert delivery. Multiple servers may be
+## specified using comma separator. By default monit uses port 25 - this
+## is possible to override 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 a 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
## 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:
#
# 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 here 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, the current configuration, actual services parameters
+## and manage services from a web interface.
#
# set httpd port 2812 and
# use address localhost # only accept connection from localhost
## 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 will be sent to
+## additional recipients by specifying a local alert handler. The service may
+## be grouped using the GROUP option.
#
# 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 was 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"
# 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 device 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
# start program = "/bin/mount /data"
# 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 size > 100 MB then exec "/my/cleanup/script"
#
#
-## 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 network services availability using a ping test and
+## check response content from a web server. Up to three pings are sent and
+## connection to a port and a 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
## 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/*