User Tools

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
services:monit [2024/02/22 13:31] – willyservices:monit [Unknown date] (current) – removed - external edit (Unknown date) 127.0.0.1
Line 1: Line 1:
-===== Monit ===== 
- 
-[[https://mmonit.com/monit//|Monit]] is a free, simple and effective monitoring tool that can help you keep an eye on your home server and services while also perform actions like restart or stop services if some events happens.  
- 
-It can also monitor your filesystems for overload and free space. 
- 
-Check: [[https://wiki.gentoo.org/wiki/Monit|Gentoo Wiki Monit]] page for specific Gentoo suggestions, which i will mostly repeat also in this page. 
- 
-==== Installation ==== 
- 
-First of all, installing //MonIt// is pretty easy: 
-<code bash> 
-emerge -v monit 
-</code> 
- 
-It is recommended to start monit through the **/etc/inittab** so that init itself launches the monit application, and will automatically relaunch it when monit would suddenly die. Starting monit through an init script would not provide this functionality. 
- 
-To start Monit via init, add the following line at the end of your **/etc/inittab** file: 
-<code> 
-# Run monit in standard runlevels 
-mo:2345:respawn:/usr/bin/monit -Ic /etc/monitrc 
-</code> 
- 
-==== Configuration ==== 
- 
-Monit is configured from it's main config file **/etc/monitrc**. I assume you want your users in the **users** group to be allowed Monit access, and also you want to disable the default admin/monit password. So edit the **/etc/monitrc** file and do the following changes: 
-<code> 
-... omissis ... 
-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    # comment this line to disable default user! 
-    allow @users                  # allow members of the //users// group to access Monit 
-... omissis ... 
-## It is possible to include additional configuration parts from other files or 
-## directories. 
-include /etc/monit.d/*    # uncomment this line to enable custom configs! 
-... omissis ...     
-</code> 
- 
-You will place all your custom monitors under **/etc/monit.d/** folder. For example, to monitor your filesystems create the file **/etc/monit.d/filesystems**: 
-<file - filesystems> 
-check filesystem Data with path /data 
-     if space usage > 90% then alert 
- 
-check filesystem Deposito with path /deposito 
-     if space usage > 90% then alert 
- 
-check filesystem Root with path / 
-     if space usage > 90% then alert 
-</file> 
- 
-And to monitor some services: 
- 
-<file - services> 
-check process sonarr with pidfile /var/run/sonarr.pid 
-    start program = "/bin/bash -c 'rc-service sonarr start'" 
-    stop program  = "/bin/bash -c 'rc-service sonarr stop'" 
- 
-check process radarr with pidfile /var/run/radarr.pid 
-    start program = "/bin/bash -c 'rc-service radarr start'" 
-    stop program  = "/bin/bash -c 'rc-service radarr stop'" 
- 
-check process readarr with pidfile /var/run/readarr.pid 
-    start program = "/bin/bash -c 'rc-service readarr start'" 
-    stop program  = "/bin/bash -c 'rc-service readarr stop'" 
- 
-check process readarr-audiobooks with pidfile /var/run/readarr-audiobooks.pid 
-    start program = "/bin/bash -c 'rc-service readarr-audiobooks start'" 
-    stop program  = "/bin/bash -c 'rc-service readarr-audiobooks stop'" 
- 
-check process lidarr with pidfile /var/run/lidarr.pid 
-    start program = "/bin/bash -c 'rc-service lidarr start'" 
-    stop program  = "/bin/bash -c 'rc-service lidarr stop'" 
- 
-check process prowlarr with pidfile /var/run/prowlarr.pid 
-    start program = "/bin/bash -c 'rc-service prowlarr start'" 
-    stop program  = "/bin/bash -c 'rc-service prowlarr stop'" 
-</file> 
- 
-And to monitor some network links: 
- 
-<file - networks> 
-check network ISP1 with interface enp0s20f0u4u4c2 
-    if link down then alert 
-    if changed link then alert 
- 
-check network ISP2 with interface enp59s0u2u4c2 
-    if link down then alert 
-    if changed link then alert 
- 
-check network internal with interface enp0s31f6 
-    if link down then alert 
-    if changed link then alert 
-</file> 
- 
-Feel free to add/edit as needed. 
- 
-To have monit read the changes, issue the command: 
-<code bash> 
-monit reload 
-</code> 
- 
- 
-==== Reverse Proxy ==== 
- 
-Create the following NGINX configuration file: 
-<file - monit.conf> 
-location /monit/ { 
-        rewrite ^/monit/(.*) /$1 break; 
-        proxy_ignore_client_abort on; 
-        proxy_pass   http://192.168.1.10:2812;  
-        proxy_redirect  http://192.168.1.10:2812 /monit;  
-        proxy_cookie_path / /monit/; 
-    } 
-</file> 
-place it accordingly to [[selfhost:nginx|The Reverse Proxy concept]] and restart NGINX. 
- 
- 
-====  Start & Test ==== 
- 
-Now start it manually, no need to reboot the server for this: 
-<code bash> 
-telinit q 
-</code> 
- 
-Open your browser and head to **https://10.0.0.1/monit** to login with your user credentials (or a user in the //users// group!) 
- 
- 
- 
-