Skip to main content

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:

  1. Comprobación: cada 5 minutos
  2. 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:

  1. Intervalo: 5 minutos
  2. 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.