Monitor de integraciones – Athento

Athento permite monitorizar integraciones con servicios web de terceros. De esta forma podremos saber que integraciones están funcionando y cuales están produciendo errores.

Los servicios de integración que se quieren monitorizar deben configurarse desde la administración. Para cada uno de ellos se debe especificar un nombre para el monitor.

Tipos de servicios

Servicios configurados en los settings

SMTP configurado en el settings de Athento. Se configuran en el apartado "Health > Smtp settings service monitors".

Servicios configurados en objetos

Para cada uno de ellos se debe indicar el servidor a monitorizar.

SMTP configurado en el modelo "SMTPServer". Se configuran en el apartado "Health > Smtp service monitors".
SFTP configurado en el modelo "SFTPServer". Se configuran en el apartado "Health > Sftp service monitors".
LDAP configurado en el modelo "LDAPServer". Se configuran en el apartado "Health > Ldap service monitors".
EWS configurado en el modelo "EWSMailboxConnection". Se configuran en el apartado "Health > Ews service monitors".

Servicios HTTP/HTTPS

Se configuran en el apartado "Health > Http service monitors" y debemos especificar los siguientes datos:

URL. URL que queremos monitorizar.
Método. Método de conexión.
Tiempo de espera. Tiempo de espera de respuesta del servicio que se quiere monitorizar.
Verificación SSL. Indica si se verificará el certificado SSL de la URL.
Nombre de usuario. Para realizar autenticación si es necesaria. No es obligatorio.
Contraseña. Para realizar autenticación si es necesaria. No es obligatorio

Servicios personalizados

Adicionalmente, se puede configurar la monitorización de servicios de integración personalizados. Para ello necesitamos especificar los siguientes datos:

Ruta del método de conexión. Es la ruta a un método definido en el servidor de Athento, encargado de realizar la comprobación de conexión.
- Si la conexión se realiza correctamente, debe devolver dos valores: True, None.
- Si la conexión no se realiza correctamente, debe devolver dos valores: False, excepción devuelta.
Configuración de la conexión. Datos que llegarán al método de conexión.

Ejemplo de método:

Visualización del monitor

Una vez configurados todos los monitores, los usuarios con permiso de superusuario podrán ver el estado dentro del apartado de "Health".

Dentro de este encontraremos una nueva pestaña "Service monitor".

En esta pestaña podremos ver todos los monitores configurados, con su nombre, su tipo de servicio y el estado del mismo. Además podremos acceder a su configuración haciendo click en el simbolo de administración que aparece en la parte superior derecha de cada monitor.

Cada cierto tiempo se lanzará un comando que comprobará el estado de los monitores y actualizará el estado de cada uno de ellos, mostrando en la interfaz cuales de ellos están funcionando bien y cuales de ellos están provocando un error. Este comando es "check_services_status" y para que este envie una notificación a soporte con los monitores que se encuentran caídos debemos indicar el parámetro "send-support-notification".

Ejecución del comando sin enviar notificación a soporte:

python manage.py check_services_status

Ejecución del comando enviando notificación a soporte:

python manage.py check_services_status --send-support-notification

Tras el lanzamiento de este comando podremos ver el estado de cada uno de los monitores.

A partir del estado de cada uno de ellos podremos saber que servidores debemos comprobar para mantener todos y cada uno de ellos funcionando.