Ver el código de «Monit»


== Instalación de monit ==

Veremos el proceso de instalación en un Sistema Debian 9 (Stretch)

Monit solo requiere de la instalación de un paquete

<pre>
apt update
apt install monit
</pre>

== Configuración de Monit ==

=== Activación de la interfaz http ===

Monit dispone de un servidor http integrado. A través de esta interfaz http puede accederse al estado de los servicios monitorizados por Monit, aunque también se utiliza esta interfaz para el envío de comandos Monit desde la línea de comandos.

Para activar la interfaz http editamos el archivo '''/etc/monit/monitrc'''

<pre>
vi /etc/monit/monitrc
</pre>

Localizamos la sección comentada

<pre>
<nowiki># set httpd port 2812 and</nowiki>
<nowiki># </nowiki>use address localhost <nowiki># only accept connection from localhost</nowiki>
<nowiki># </nowiki>allow localhost <nowiki># allow localhost to connect to the server and</nowiki>
<nowiki># </nowiki>allow admin:monit <nowiki># require user 'admin' with password 'monit'</nowiki>
</pre>

Y la editamos para que quede

<pre>
set httpd port 2812 and
use address 0.0.0.0
allow 0.0.0.0/0 <nowiki># permitir todos</nowiki>
allow admin:monit <nowiki># require user 'admin' with password 'monit'</nowiki>
</pre>

Con esta configuración podremos acceder al servicio http utilizando la URL

http://IP_Monit_Server:2812

Para acceder a la información de monitorización usaremos (como se define en la configuración anterior)

user: '''admin'''
password: '''monit'''

[[Archivo:monit_http.png|600px]]

Pinchando en el enlace el host accedemos al estado del mismo


[[Archivo:monit-status.png|600px]]

=== Definición de directivas genéricas ===

Algunas directivas interesantes que pueden ser establecidas en el archivo '''monitrc'''

==== Período de ejecución de chequeos ====

'''set daemon'''

<pre>
set daemon 120
</pre>

Indica que se hará un chequeo de los servicios a monitorizar cada 2 minutos, puede ser modificado si necesitamos una periodicidad mayor

==== Credenciales smtp para envío de alertas al mail ====
'''
set mailserver'''

Permite definir un servidor SMTP para el envío de alertas por correo. Por ejemplo podemos establecer la siguiente definición de esa directiva

<pre>
<nowiki># Configuracion de servidor de correo para alertas de Monit</nowiki>
set mailserver smtp.gmail.com port 587
username "monitortest" password "abc123."
using tlsv1
<nowiki># Configuracion </nowiki>del buzón al que se enviarán las alertas
set alert monitortest@gmail.com
</pre>

'''NOTA''': Hay que efectuar un par de pasos adicionales en la cuenta de gmail para poder habilitar el envío utilizando este sistema.

'''ATENCIÓN A LAS URLs'''

[[Archivo:gmail-less-secure.png]]

[[Archivo:gmail-unlock-captcha.png]]

[[Archivo:gmail-enable-access.png]]

==== Formato del mail enviado ====

'''set mail-format'''

Esta directiva permite establecer el formato del correo de alerta que se enviará cuando se produzca alguno de los eventos notificados por monit. Por defecto utiliza un formato de plantilla de mail genérico que puede ser modificado con esta directiva

Podemos acceder a los parámetros del '''runtime''' desde el enlace Monit is [[running]] on base and monitoring de la página principal:

[[Archivo:monit-runtime.png|600px]]

== Definición de componentes a monitorizar ==

Es posible definir las directivas de monitorización directamente en el archivo monitrc. Sin embargo, a efectos organizativos y aclaratorios es más recomendable definir las directivas en archivos dentro del directorio '''/etc/monit/conf.d'''

A continuación vamos a crear varios archivos de texto en los que se incorporán directivas de monitorización específicas para distintos casos de uso.

=== Monitorización de parámetros generales del sistema ===

Crearemos un archivo '''/etc/monit/conf.d/system.monit'''

<pre>
vi /etc/monit/conf.d/system.monit
</pre>

Dentro del archivo incorporaremos las directivas siguientes

<pre>
check system $HOST
if loadavg (1min) > 4 then alert
if loadavg (5min) > 2 then alert
if cpu usage > 95% for 10 cycles then alert
if memory usage > 75% then alert
if swap usage > 25% then alert
</pre>

El lenguaje de definición de directivas de monitorización es bastante claro e intuitivo, utilizando prolijamente la estructura condicional if. Ante cualquier duda de sintaxis o semántica acerca de las mismas se recomienda consultar el '''Monit Manual''' de la sección '''Referencias'''

Tras editar el fichero reiniciamos el servicio

<pre>
service monit restart
</pre>

=== Monitorización de un servicio ===

Vamos a ver un conjunto de directivas de monitorización para el servicio apache2. Si este servicio no está instalado en la máquina lo instalamos previamente

<pre>
apt install -y apache2
</pre>

A continuación crearemos un archivo '''/etc/monit/conf.d/apache2.monit'''

<pre>
vi /etc/monit/conf.d/apache2.monit
</pre>

Dentro de ese archivo incorporaremos las siguientes directivas de monitorización

<pre>
check process apache with pidfile /var/run/apache2/apache2.pid
start program = "/etc/init.d/apache2 start" with timeout 60 seconds
stop program <nowiki>= "/etc/init.d/apache2 stop"</nowiki>
if cpu > 60% for 2 cycles then alert
if cpu > 80% for 5 cycles then restart
if totalmem > 200.0 MB for 5 cycles then restart
if children > 250 then restart
if loadavg(5min) greater than 10 for 8 cycles then stop
if failed host localhost port 80 protocol http
and request "/index.html"
then restart
<nowiki># </nowiki>if failed port 443 protocol https with timeout 15 seconds then restart
<nowiki># </nowiki>if 3 restarts within 5 cycles then unmonitor
group server
</pre>

En este bloque de definición se hace uso de las directivas '''start program''' y '''stop program''' las cuales se utilizan en caso de ser necesario ejecutar el reinicio (restart) del servicio. Por ejemplo en la línea

'''if totalmem > 200.0 MB for 5 cycles then restart'''

... en caso de que la memoria total del proceso monitorizado excediera los 200MB durante 5 períodos de monitorización consecutivos se ejecutaría un reinicio del servicio, para ello se invocaría primero al comando de la directiva '''stop program''' y a continuación al comando de '''start program'''

Tras editar el fichero reiniciamos el servicio

<pre>
service monit restart
</pre>

Página de monitorización de Apache;

[[Archivo:monit-apache.png|600px]]

=== Monitorización del sistema de archivos ===

A continuación crearemos un archivo '''/etc/monit/conf.d/filesystem.monit'''

<pre>
vi /etc/monit/conf.d/filesystem.monit
</pre>

<pre>
check filesystem root with path /dev/sda1
if space usage > 80% for 5 times within 15 cycles then alert
if space usage > 99% then stop
if inode usage > 30000 then alert
if inode usage > 99% then stop
group server
</pre>

Tras editar el fichero reiniciamos el servicio

<pre>
service monit restart
</pre>

[[Archivo:monit-fs.png|600px]]

=== Monitorización de host ===

A continuación crearemos un archivo '''/etc/monit/conf.d/host.monit'''

<pre>
vi /etc/monit/conf.d/host.monit
</pre>

<pre>
check host localhost with address 127.0.0.1
if failed ping then alert
if failed port 3306 protocol mysql with timeout 15 seconds then alert
if failed port 80 protocol http
then alert
</pre>

En este caso hacemos un chequeo del host local consistente en varias acciones

* ejecución de un ping
* chequeo del puerto 3306 local (mysql)
* chequeo del puerto 80 local (http)

En caso de fallo de cualquiera de los chequeos se envía una alerta

Tras editar el fichero reiniciamos el servicio

<pre>
service monit restart
</pre>

=== Monitorización de un enlace de red ===

A continuación crearemos un archivo '''/etc/monit/conf.d/network.monit'''

<pre>
vi /etc/monit/conf.d/network.monit
</pre>

<pre>
check network public with interface enp0s3
if failed link then alert
if changed link then alert
if saturation > 90% then alert
if download > 10 MB/s then alert
if total uploaded > 1 GB in last hour then alert
</pre>

Tras editar el fichero reiniciamos el servicio

<pre>
service monit restart
</pre>

[[Archivo:monit-net.png|600px]]

== Referencias ==

[https://mmonit.com/monit/documentation/monit.html https://mmonit.com/monit/documentation/monit.html]

[[Monitorización|Volver]]

JavierFP 18:42 09 jue 2018 (CET)