Disponibilidade e janelas de manutenção

A Mirox funciona em duas regiões independentes. Cada região aloja a plataforma completa e o tráfego é encaminhado automaticamente para uma região saudável. Por trás disso, cada serviço foi construído para continuar a responder durante uma perturbação em vez de desaparecer, e a aplicação diz-lhe claramente o que se passa.

O que vê durante uma perturbação

Cada resposta da plataforma transporta um estado. A aplicação web e a aplicação móvel leem-no e reagem da mesma forma:

Estado	Significado	O que a aplicação mostra
`healthy`	Tudo funciona.	Nada de especial.
`degraded`	Uma parte não essencial está indisponível; a aplicação continua a funcionar.	Nada de especial; as funções afetadas reportam um erro quando usadas.
`unavailable`	A plataforma não consegue servir pedidos neste momento (por exemplo, a base de dados está inacessível).	Um aviso de página inteira substitui a aplicação assim que um pedido falha. A página verifica a plataforma de poucos em poucos segundos e regressa sozinha à aplicação quando esta volta a funcionar.
`maintenance`	Está ativa uma janela de manutenção.	Enquanto a plataforma ainda funciona: um aviso amarelo em baixo à direita com o título e o período da janela. Pode ser recolhido para um pequeno ícone de aviso e reaberto. Se os pedidos começarem a falhar dentro da janela, aparece o aviso de página inteira com a mesma informação.

O aviso de página inteira mostra o título, a descrição e o período da janela quando são conhecidos, e um aviso geral caso contrário. O idioma e o modo escuro podem ser alterados nessa página como na página de início de sessão. Nada precisa de ser recarregado manualmente.

As suas centrais continuam a funcionar

Cada central tem o seu próprio agente Mirox. Os agentes funcionam de forma descentralizada em clusters de agentes próprios, em regiões distintas das da própria plataforma, pelo que um problema regional do lado da plataforma não os afeta. Um agente não depende de a plataforma estar acessível:

O agente continua a recolher e analisar os dados da central e guarda-os numa memória intermédia local enquanto a plataforma está indisponível; os dados guardados são entregues quando a ligação regressa, pelo que o histórico não tem falhas.
A gestão dos agentes trata uma perturbação da plataforma exatamente como tal: as cargas de trabalho da central mantêm-se implementadas e em execução. Nunca são paradas porque a nuvem está temporariamente inacessível ou em manutenção.
Os alarmes que o agente avalia por si próprio continuam a ser avaliados; as notificações que passam pela plataforma seguem assim que esta volta a estar disponível.

Janelas de manutenção

A equipa Mirox anuncia trabalhos planeados como uma janela de manutenção. Uma janela tem um título, um breve motivo mostrado aos utilizadores, um início e um fim planeados e um âmbito: toda a plataforma ou uma região.

Antes do início a janela é anunciada com pelo menos cinco dias úteis de antecedência. As janelas só são agendadas quando os trabalhos o exigem, não num ritmo semanal, e normalmente a um sábado entre as 20:00 e as 23:59, hora da Europa Central. A aplicação não mostra nada antes de a janela começar.
Durante a janela aparece o aviso amarelo e a plataforma pode ficar brevemente indisponível. Os agentes continuam a trabalhar como descrito acima.
Depois do fim o aviso desaparece sozinho. Se os trabalhos terminarem mais cedo, a janela é encerrada mais cedo; se demorarem mais, é prolongada e o aviso mantém-se.

Uma janela nunca altera os seus dados nem a sua configuração. Apenas informa a aplicação, os agentes e os serviços da plataforma de que nesse período são esperadas interrupções.

Para integrações e utilizadores da API

Se chama a API Mirox a partir dos seus próprios sistemas, use o estado para reagir corretamente:

Cada resposta HTTP transporta o cabeçalho X-Mirox-Status com um dos quatro valores acima.
GET /status (sem autenticação) devolve o estado atual e, durante uma janela, o seu título e período.
Um 503 juntamente com unavailable ou maintenance é uma condição da plataforma, não um problema do seu pedido nem das suas credenciais. Tente novamente mais tarde com uma pausa crescente, não de imediato. Os erros de autenticação (401, 403) não têm relação com este mecanismo e não devem ser repetidos às cegas.

Perguntas frequentes

Porque vejo um aviso de manutenção embora tudo funcione? A janela está ativa, por isso são possíveis interrupções. O aviso é informativo; pode recolhê-lo.

Os dados da minha central perdem-se durante uma perturbação? Não. O agente guarda-os e entrega-os depois.

Posso ser informado antes de uma janela? Sim. As janelas planeadas são anunciadas com pelo menos cinco dias úteis de antecedência pelos canais habituais; a própria aplicação só mostra uma janela enquanto está ativa.