Supervisión de los servicios de Medulla
En el marco de la supervisión de una infraestructura Medulla On-Premise, se recomienda supervisar no solo el estado de los principales servicios de Medulla, sino también los recursos del sistema, los puertos de red, los componentes XMPP, las bases de datos MariaDB y, según la arquitectura, MaxScale y los servidores de relay.
Esta supervisión puede integrarse en su herramienta de monitorización habitual con el fin de detectar rápidamente la interrupción, el deterioro o el mal funcionamiento de un componente de Medulla.
Nota:
Los elementos que deben supervisarse dependen de la función de cada servidor. Un servidor principal, un servidor de relay, un servidor MariaDB o un servidor MaxScale no disponen necesariamente de los mismos servicios.
1. Principios generales de supervisión
En el caso de una infraestructura de Medulla, recomendamos supervisar, como mínimo, los siguientes elementos:
- disponibilidad del servidor;
- carga de la CPU;
- uso de la memoria;
- ocupación de los sistemas de archivos;
- disponibilidad de la interfaz web;
- estado de los servicios de Medulla;
- conectividad en los principales puertos utilizados;
- estado del servicio XMPP ejabberd;
- estado y rendimiento de MariaDB cuando la base de datos está alojada en el servidor;
- estado de MaxScale cuando se utiliza;
- ocupación del espacio de almacenamiento destinado a paquetes, datos y copias de seguridad.
Frecuencia de comprobación recomendada
En el caso de los servicios críticos, una comprobación cada 5 minutos constituye una frecuencia razonable.
Con el fin de evitar que se activen alertas por una indisponibilidad muy puntual, es posible activar la alerta tras varios fallos consecutivos.
Por ejemplo:
- Comprobación: cada 5 minutos
- Alerta: tras 3 comprobaciones consecutivas con error
Recomendación:
Las frecuencias y los umbrales deben adaptarse a las exigencias de disponibilidad y a la arquitectura de su organización.
2. Supervisión del sistema
Independientemente de la función que desempeñe el servidor Medulla, es necesario supervisar los recursos del sistema.
| Elemento | Comprobación recomendada |
|---|---|
| CPU | Carga y uso del procesador |
| Memoria | Uso de la RAM y memoria disponible |
| Sistemas de archivos | Espacio ocupado y libre |
| Sistema operativo | Disponibilidad e información del sistema |
| Interfaz web | Comprobación HTTP/HTTPS de la URL de Medulla |
Importante:
Debe prestarse especial atención a las particiones que contienen las bases de datos, los paquetes de despliegue, las copias de seguridad y los registros. Un espacio en disco saturado puede provocar varios fallos simultáneos en Medulla.
3. Servicios de Medulla que deben supervisarse
En un servidor Medulla principal, recomendamos supervisar los siguientes servicios cuando estén instalados:
ejabberd
mmc-agent
pulse-xmpp-agent-relay
pulse2-register-pxe
pulse2-package-server
pulse-xmpp-master-substitute-master
pulse-xmpp-master-substitute-logger
pulse-xmpp-master-substitute-updates
pulse-xmpp-master-substitute-assessor
pulse-xmpp-master-substitute-inventory
pulse-xmpp-master-substitute-deployment
pulse-xmpp-master-substitute-monitoring
pulse-xmpp-master-substitute-registration
pulse-xmpp-master-substitute-subscription
En función de su versión y de las funcionalidades instaladas, también pueden estar presentes otros servicios, entre los que destacan:
pulse-xmpp-master-substitute-reconfigurator
Nota:
No todos estos servicios están necesariamente presentes en cada instalación. La lista de supervisión debe elaborarse a partir de los servicios realmente instalados y activados en cada servidor.
4. Comprobar el estado de un servicio
El comando systemctl permite comprobar manualmente el estado de un servicio.
Por ejemplo, para comprobar mmc-agent:
systemctl status mmc-agent
Para obtener únicamente su estado:
systemctl is-active mmc-agent
Cuando el servicio funciona con normalidad, el comando devuelve:
active
Los siguientes estados deben considerarse, en particular, anormales para un servicio que se espera que funcione correctamente:
inactive
failed
5. Comprobar todos los servicios de Medulla
Para realizar una comprobación rápida de los principales servicios, puede utilizar el siguiente script:
#!/bin/bash
SERVICES="
ejabberd
mmc-agent
pulse-xmpp-agent-relay
pulse2-register-pxe
pulse2-package-server
pulse-xmpp-master-substitute-master
pulse-xmpp-master-substitute-logger
pulse-xmpp-master-substitute-updates
pulse-xmpp-master-substitute-assessor
pulse-xmpp-master-substitute-inventory
pulse-xmpp-master-substitute-deployment
pulse-xmpp-master-substitute-monitoring
pulse-xmpp-master-substitute-registration
pulse-xmpp-master-substitute-subscription
"
for SERVICE in $SERVICES
do
if systemctl is-active --quiet "$SERVICE"; then
echo "[OK] $SERVICE"
else
echo "[ERROR] $SERVICE"
fi
done
Ejemplo de resultado:
[OK] ejabberd
[OK] mmc-agent
[OK] pulse-xmpp-agent-relay
[ERROR] pulse2-package-server
[OK] pulse-xmpp-master-substitute-master
Atención:
Este script utiliza una lista genérica. Elimine los servicios que no estén instalados en el servidor supervisado para evitar generar incidencias falsas.
6. Supervisión de ejabberd
ejabberd es un componente importante de la arquitectura de comunicación de Medulla. Se recomienda supervisar tanto su servicio del sistema como varios indicadores XMPP.
Estado del servicio
systemctl status ejabberd
O bien:
systemctl is-active ejabberd
Número de usuarios conectados
/usr/bin/ejabberdctl stats onlineusers
Este valor puede utilizarse como indicador de funcionamiento y realizarse un seguimiento a lo largo del tiempo.
Número de usuarios registrados
/usr/bin/ejabberdctl stats registeredusers
Una variación significativa o inesperada de este valor puede utilizarse como señal de supervisión.
Mensajes sin conexión
También se puede supervisar el número de mensajes pendientes en las distintas cuentas técnicas de Medulla.
Ejemplo:
/usr/bin/ejabberdctl get_offline_count NOMBRE_DE_LA_CUENTA pulse
Un aumento significativo y persistente del número de mensajes sin conexión puede indicar que un componente de Medulla ya no procesa correctamente sus mensajes.
Recomendación:
Los valores onlineusers, registeredusers y las colas de mensajes sin conexión son especialmente interesantes de registrar históricamente para detectar evoluciones anómalas, incluso cuando ningún servicio se ha detenido.
7. Supervisión de los puertos del servidor Medulla
Como complemento a la supervisión de los servicios, se recomienda comprobar que los puertos necesarios estén activos y sean accesibles desde los equipos correspondientes.
En función de la arquitectura y las funcionalidades utilizadas, se pueden supervisar, entre otros, los siguientes puertos:
| Puerto | Uso |
|---|---|
5222 |
Comunicación XMPP |
7080 |
Servicio MMC |
8443 |
Servicio HTTPS de Medulla según la configuración |
2222 |
Servicio SSH según la arquitectura |
22000 |
Sincronización/dependencia de Medulla según la configuración |
23000 |
Sincronización/dependencia de Medulla según la configuración |
57040 |
Agente master según la arquitectura |
Importante:
Esta lista es genérica. Los puertos que se utilizan realmente dependen de su arquitectura de Medulla, de las funcionalidades activadas y de la función del servidor. No active ninguna alerta sobre un puerto que no esté previsto en el servidor en cuestión.
8. Supervisión del servidor web y de Guacamole
La disponibilidad de la interfaz web debe supervisarse mediante un control HTTP o HTTPS.
Se recomienda comprobar:
- que el servidor web esté en funcionamiento;
- que la URL de Medulla responda;
- que el código HTTP devuelto se corresponda con el comportamiento esperado.
Dependiendo de la instalación, el estado del servicio web puede comprobarse, por ejemplo, con:
systemctl status httpd
o con el nombre del servicio web que utilice su instalación.
Guacamole
La disponibilidad del componente Guacamole también puede comprobarse a través de su URL local.
Ejemplo de punto de control:
http://localhost:8081/guacamole/
En una configuración en la que no se permita el acceso directo a esta URL, una respuesta HTTP 403 puede constituir el comportamiento esperado y confirmar que el servicio responde.
9. Supervisión de Syncthing
Cuando se utilice Syncthing en la arquitectura Medulla, supervise su servicio:
systemctl status syncthing@syncthing
Los puertos asociados también pueden supervisarse en función de la configuración:
22000
23000
8384
Nota:
Los puertos que deben supervisarse deben corresponder a la configuración de Syncthing que utilice realmente su infraestructura.
10. Supervisión de un servidor de relay Medulla
Un servidor de relay Medulla suele requerir una supervisión más limitada que el servidor principal.
En función de las funciones activadas, recomendamos supervisar, en particular:
pulse-xmpp-agent-relay;ejabberd, cuando esté presente en el relay;- Syncthing, cuando se utilice;
- el servidor web cuando el relay distribuya paquetes;
- la conectividad XMPP;
- el espacio en disco utilizado por el repositorio de despliegue.
Servicio Relay
systemctl status pulse-xmpp-agent-relay
Puerto XMPP
5222
Syncthing
systemctl status syncthing@syncthing
Espacio en disco
Es necesario supervisar el sistema de archivos que contiene los paquetes de despliegue para garantizar que quede suficiente espacio disponible.
Importante:
Si el repositorio de un relay se satura, puede impedir la sincronización o la distribución de nuevos paquetes sin que ello implique necesariamente la interrupción del servicio.
11. Supervisión de MariaDB
Cuando MariaDB se aloja en una infraestructura dedicada o en el servidor Medulla, se recomienda supervisar su servicio, sus conexiones, sus errores y los recursos utilizados.
Estado del servicio
systemctl status mariadb
O bien:
systemctl is-active mariadb
Elementos recomendados
| Indicador | Objetivo |
|---|---|
| Servicio MariaDB | Comprobar que el servicio esté activo |
| Tiempo de conexión | Detectar una disminución del rendimiento |
| Conexiones abandonadas | Detectar errores o problemas de red |
| Hilos conectados | Supervisar el consumo de las conexiones disponibles |
| Archivos abiertos | Detectar cuando se están alcanzando los límites del sistema o de MariaDB |
| Consultas lentas | Detectar la disminución del rendimiento |
| Registro de errores de MariaDB | Detectar errores del servidor |
| Ocupación del directorio de datos | Prevenir la saturación del disco |
| Ocupación del espacio de almacenamiento de las copias de seguridad | Prevenir la saturación del almacenamiento de copias de seguridad |
Número de conexiones
Se recomienda, en particular, supervisar el número de conexiones activas en relación con el número máximo de conexiones permitidas.
Se puede activar una alerta cuando el uso se acerque a una proporción significativa de la capacidad máxima.
Ejemplo:
Se puede establecer un umbral de alerta antes de alcanzar el 100 % de max_connections, con el fin de disponer de un margen que permita intervenir antes de que se produzca la saturación.
Consultas lentas
Se puede registrar históricamente el número de consultas lentas con el fin de detectar un deterioro progresivo del rendimiento de la base de datos.
Errores de MariaDB
Se recomienda supervisar el registro de errores de MariaDB y activar una alerta cuando aparezca un nuevo error significativo.
12. Supervisión de MaxScale
Cuando la arquitectura Medulla utiliza MariaDB MaxScale, también debe supervisarse su estado.
Estado del servicio
systemctl status maxscale
O bien:
systemctl is-active maxscale
Puertos
En función de la configuración de MaxScale utilizada, se pueden supervisar, entre otros, los siguientes puertos:
| Puerto | Uso |
|---|---|
4006 |
Conexión de lectura/escritura según la configuración |
4008 |
Conexión de solo lectura según la configuración |
Nota:
Los puertos de MaxScale deben ajustarse a la configuración real definida en su infraestructura.
13. Supervisión de los espacios de almacenamiento
La disponibilidad de los servicios no basta para garantizar el correcto funcionamiento de Medulla. También es necesario supervisar los sistemas de archivos.
Se debe prestar especial atención a:
- a la partición raíz
/; - al directorio temporal
/tmp; - al directorio de datos de MariaDB;
- al almacenamiento de las copias de seguridad;
- al repositorio de despliegue;
- a los volúmenes que contienen los registros y los datos de Medulla.
Importante:
Establezca umbrales de alerta con suficiente antelación para permitir una intervención antes de que el sistema de archivos se sature por completo.
14. Integración en una herramienta de supervisión
Los distintos controles descritos en esta documentación pueden integrarse en la mayoría de las soluciones de supervisión.
Los controles pueden agruparse en varias categorías:
| Categoría | Ejemplos |
|---|---|
| Sistema | CPU, memoria, espacio en disco, disponibilidad del sistema operativo |
| Servicios | systemctl is-active |
| Red | Puertos TCP, disponibilidad de HTTP/HTTPS |
| XMPP | ejabberd, usuarios conectados, colas de mensajes |
| Base de datos | MariaDB, conexiones, errores, consultas lentas |
| Proxy de base de datos | MaxScale y puertos asociados |
| Almacenamiento | Datadir, copias de seguridad, despliegue |
Para los servicios críticos, se puede aplicar una política del tipo siguiente:
- Intervalo: 5 minutos
- Alerta: tras 3 fallos consecutivos
Importante:
Estos valores constituyen una recomendación genérica y deben adaptarse a su nivel de servicio y a su política de supervisión.
15. Consultar los registros de un servicio
Cuando un servicio esté detenido o presente un error, comience por comprobar su estado:
systemctl status NOMBRE_DEL_SERVICIO
A continuación, consulte sus registros:
journalctl -u NOMBRE_DEL_SERVICIO
Para mostrar los 100 eventos más recientes:
journalctl -u NOMBRE_DEL_SERVICIO -n 100
Por ejemplo:
journalctl -u mmc-agent -n 100
Para seguir los eventos en tiempo real:
journalctl -u NOMBRE_DEL_SERVICIO -f
16. Reiniciar un servicio
Tras analizar el problema, si es necesario, se puede reiniciar un servicio con:
systemctl restart NOMBRE_DEL_SERVICIO
Por ejemplo:
systemctl restart mmc-agent
A continuación, compruebe su estado:
systemctl status mmc-agent
Atención:
Antes de reiniciar un servicio que presenta un error, consulte su estado y sus registros para identificar el origen del problema. Un reinicio sistemático puede ocultar un problema recurrente sin abordar su causa.
17. Resumen por función del servidor
| Función | Comprobaciones principales |
|---|---|
| Servidor Medulla principal | CPU, RAM, discos, HTTP/HTTPS, mmc-agent, XMPP, servicios substitute, paquetes, PXE según la configuración |
| Servidor de relay | CPU, RAM, discos, pulse-xmpp-agent-relay, XMPP, Syncthing, repositorio, HTTP según la configuración |
| Servidor MariaDB | CPU, RAM, datadir, servicio MariaDB, conexiones, errores, consultas lentas, copias de seguridad |
| Servidor MaxScale | CPU, RAM, discos, servicio MaxScale, puertos de conexión |
18. Buenas prácticas
- adaptar los controles a la función real de cada servidor;
- supervisar los servicios, así como los recursos del sistema y los puertos;
- mantener un historial de las métricas importantes para detectar desviaciones progresivas;
- evitar activar una alerta por un único fallo puntual;
- prestar especial atención al espacio disponible en disco;
- supervisar las colas de mensajes de ejabberd;
- supervisar MariaDB más allá del simple estado del servicio;
- consultar los registros antes de reiniciar cualquier servicio;
- comprobar periódicamente el correcto funcionamiento de las alertas.
Recomendación:
Una supervisión eficaz de Medulla no debe limitarse a comprobar que los procesos estén en marcha. Se recomienda combinar la supervisión de los servicios, los recursos del sistema, los puertos de red, las métricas XMPP, el rendimiento de MariaDB y los espacios de almacenamiento. A continuación, adapte los controles a la función y a las funcionalidades realmente instaladas en cada servidor de su infraestructura.