Disponibilidad y ventanas de mantenimiento

Mirox funciona en dos regiones independientes. Cada región alberga la plataforma completa y el tráfico se dirige automáticamente a una región sana. Además, cada servicio está construido para seguir respondiendo durante una incidencia en lugar de desaparecer, y la aplicación le dice claramente qué ocurre.

Qué ve durante una incidencia

Cada respuesta de la plataforma lleva un estado. La aplicación web y la aplicación móvil lo leen y reaccionan igual:

Estado	Significado	Qué muestra la aplicación
`healthy`	Todo funciona.	Nada especial.
`degraded`	Una parte no esencial no está disponible; la aplicación sigue funcionando.	Nada especial; las funciones afectadas informan de un error al usarlas.
`unavailable`	La plataforma no puede atender solicitudes en este momento (por ejemplo, la base de datos no es accesible).	Un aviso a página completa sustituye a la aplicación en cuanto falla una solicitud. La página comprueba la plataforma cada pocos segundos y vuelve sola a la aplicación cuando funciona de nuevo.
`maintenance`	Hay una ventana de mantenimiento activa.	Mientras la plataforma sigue funcionando: un aviso amarillo abajo a la derecha con el título y el periodo de la ventana. Se puede plegar a un pequeño icono de advertencia y volver a abrir. Si las solicitudes empiezan a fallar dentro de la ventana, aparece el aviso a página completa con la misma información.

El aviso a página completa muestra el título, la descripción y el periodo de la ventana cuando se conocen, y un aviso general en caso contrario. El idioma y el modo oscuro se pueden cambiar en esa página como en la de inicio de sesión. No hay que recargar nada manualmente.

Sus plantas siguen funcionando

Cada planta tiene su propio agente Mirox. Los agentes funcionan de forma descentralizada en clústeres de agentes propios, en regiones distintas de las de la propia plataforma, por lo que un problema regional del lado de la plataforma no les afecta. Un agente no depende de que la plataforma sea accesible:

El agente sigue recopilando y analizando los datos de la planta y los guarda en un búfer local mientras la plataforma no está disponible; los datos almacenados se entregan cuando vuelve la conexión, así que el historial no tiene huecos.
La gestión de los agentes trata una incidencia de la plataforma exactamente como tal: las cargas de trabajo de la planta permanecen desplegadas y en ejecución. Nunca se detienen porque la nube esté temporalmente inaccesible o en mantenimiento.
Las alarmas que el agente evalúa por sí mismo se siguen evaluando; las notificaciones que se envían a través de la plataforma siguen en cuanto esta vuelve a estar disponible.

Ventanas de mantenimiento

El equipo de Mirox anuncia los trabajos planificados como una ventana de mantenimiento. Una ventana tiene un título, un breve motivo que se muestra a los usuarios, un inicio y un fin planificados y un ámbito: toda la plataforma o una región.

Antes del inicio la ventana se anuncia con al menos cinco días laborables de antelación. Las ventanas solo se programan cuando los trabajos lo requieren, no con un ritmo semanal, y normalmente un sábado entre las 20:00 y las 23:59, hora de Europa Central. La aplicación no muestra nada antes de que empiece la ventana.
Durante la ventana aparece el aviso amarillo y la plataforma puede no estar disponible brevemente. Los agentes siguen trabajando como se describe arriba.
Después del fin el aviso desaparece solo. Si el trabajo termina antes, la ventana se cierra antes; si dura más, se amplía y el aviso permanece.

Una ventana nunca modifica sus datos ni su configuración. Solo informa a la aplicación, a los agentes y a los servicios de la plataforma de que en ese periodo son esperables interrupciones.

Para integraciones y usuarios de la API

Si llama a la API de Mirox desde sus propios sistemas, use el estado para reaccionar correctamente:

Cada respuesta HTTP lleva la cabecera X-Mirox-Status con uno de los cuatro valores anteriores.
GET /status (sin autenticación) devuelve el estado actual y, durante una ventana, su título y periodo.
Un 503 junto con unavailable o maintenance es una condición de la plataforma, no un problema de su solicitud ni de sus credenciales. Reintente más tarde con una pausa creciente, no de inmediato. Los errores de autenticación (401, 403) no tienen relación con este mecanismo y no deben reintentarse a ciegas.

Preguntas frecuentes

¿Por qué veo un aviso de mantenimiento si todo funciona? La ventana está activa, así que son posibles interrupciones. El aviso es informativo; puede plegarlo.

¿Se pierden los datos de mi planta durante una incidencia? No. El agente los guarda en su búfer y los entrega después.

¿Puedo ser informado antes de una ventana? Sí. Las ventanas planificadas se anuncian con al menos cinco días laborables de antelación por los canales habituales; la propia aplicación muestra una ventana solo mientras está activa.