Revision as of 04:44, June 27, 2014

Monit

Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Monit is a utility for managing and monitoring processes, programs, files, directories and filesystems on a UNIX system.

Installation

Emerge

To install app-admin/monit:

root #emerge monit

Configuration

Config file of monit resides in /etc/monitrc. And there is a item to specify a config directory. Uncomment if needed.

/etc/monitrc - config dir

## It is possible to include additional configuration parts from other files or
## directories.
#
#  include /etc/monit.d/*
#

Users

Users added to the monit or users group will be able to manipulate monit through the web interface.

root #gpasswd -a $USER monit

root #gpasswd -a $USER users

Warning

passwords can be streamed to monits web interface, disable it all together after it is setup

Important

for security purposes change this entry

/etc/monitrc

allow admin:monit

Boot Services

inittab

Note

this is the preferred method to run monit

/etc/inittab - auto restart monit in case of failure

ca:12345:ctrlaltdel:/sbin/shutdown -r now

 # Run monit in standard runlevels
 mo:2345:respawn:/usr/bin/monit -Ic /etc/monitrc

# Used by /etc/init.d/xdm to control DM startup.

to start monit immediately after changing inittab

root #telinit q

OpenRC

Note

prefer inittab method over rc services

To start the service at boot.

root #rc-update add monit default

To start the service immediately.

root #/etc/init.d/monit start

Monitoring Monit

This hourly cron script will check to make sure monit has not crashed. As this uses pgrep, make sure to not name it monit.

/etc/cron.hourly/moncheck

#!/bin/bash
if ! pgrep monit >/dev/null;then
rc-service monit restart
fi

Pidfile Check

Monit relies upon pid files. For daemons that do not create a pidfile: a work around is needed.

Examples

Auto Restart Mysql

/etc/monitrc - auto restart mysql

check process mysql with pidfile /var/run/mysqld/mysqld.pid
    start program = "/bin/bash -c 'rc-service mysql start'"
    stop program  = "/bin/bash -c 'rc-service mysql stop'"

Web Interface

Navigate to http://localhost:2812/ & login using your edited configuration line or admin / monit if you have not changed it yet.

@@ Line 1: / Line 1: @@
-{{Person
+{{Ebuild
-|Geoloc=35.611237, -82.540115
+|Summary=a utility for monitoring and managing daemons or similar programs running on a Unix system.
-|Location name=Asheville, NC, United States of America
+|CatPkg=app-admin/monit
-|Blogs=
+|Maintainer=
-|Full name=Duncan Glover Britton
-|Email=duncan.britton@outlook.com
-|Roles={{Role
-|Role type=Contributor
-|Role desc=Wiki
 }}
-|Maintains=
+[http://mmonit.com/monit/ Monit] is a utility for managing and monitoring processes, programs, files, directories and filesystems on a UNIX system.
+== Installation ==
+=== Emerge ===
+To install {{Package|app-admin/monit}}:
+<console>###i##emerge monit</console>
+== Configuration ==
+Config file of monit resides in <tt>/etc/monitrc</tt>. And there is a item to specify a config directory. Uncomment if needed.
+{{File|name=/etc/monitrc|desc=config dir|body=
+## It is possible to include additional configuration parts from other files or
+## directories.
+#
+#  include /etc/monit.d/*
+#
 }}
+=== Users ===
+Users added to the monit or users group will be able to manipulate monit through the web interface.
+<console>###i##gpasswd -a $USER monit</console>
+<console>###i##gpasswd -a $USER users</console>
+{{fancywarning|passwords can be streamed to monits web interface, disable it all together after it is setup}}
+{{fancyimportant|for security purposes change this entry}}
+{{file|name=/etc/monitrc|desc=|body=
+allow admin:monit}}
+== Boot Services ==
+=== inittab ===
+{{fancynote|this is the preferred method to run monit}}
+{{file|name=/etc/inittab|desc=auto restart monit in case of failure|body=
+ca:12345:ctrlaltdel:/sbin/shutdown -r now
+ # Run monit in standard runlevels
+ mo:2345:respawn:/usr/bin/monit -Ic /etc/monitrc
+# Used by /etc/init.d/xdm to control DM startup.
+}}
+to start monit immediately after changing inittab
+<console>###i##telinit q</console>
+=== OpenRC ===
+{{fancynote|prefer inittab method over rc services}}
+To start the service at boot.
+<console>###i##rc-update add monit default</console>
+To start the service immediately.
+<console>###i##/etc/init.d/monit start</console>
+==== Monitoring Monit ====
+This hourly cron script will check to make sure monit has not crashed.  As this uses pgrep, make sure to not name it monit.
+{{file|name=/etc/cron.hourly/moncheck|desc=|body=
+#!/bin/bash
+if ! pgrep monit >/dev/null;then
+rc-service monit restart
+fi
+}}
+== Pidfile Check ==
+Monit relies upon pid files. For daemons that do not create a pidfile: a [http://mmonit.com/wiki/Monit/FAQ#pidfile work around] is needed.
+== Examples ==
+=== Auto Restart Mysql ===
+{{file|name=/etc/monitrc|desc=auto restart mysql|body=
+check process mysql with pidfile /var/run/mysqld/mysqld.pid
+    start program = "/bin/bash -c 'rc-service mysql start'"
+    stop program  = "/bin/bash -c 'rc-service mysql stop'"
+}}
+== Web Interface ==
+Navigate to http://localhost:2812/ & login using your edited configuration line or admin / monit if you have not changed it yet.
+[[Category:Monitoring]]
+{{EbuildFooter}}

Difference between pages "User:Duncan.britton" and "Package:Monit"