Disponibilità e finestre di manutenzione

Mirox funziona in due regioni indipendenti. Ogni regione ospita la piattaforma completa e il traffico viene instradato automaticamente verso una regione sana. Inoltre ogni servizio è costruito per continuare a rispondere durante un disservizio invece di sparire, e l'app dice chiaramente cosa sta succedendo.

Cosa si vede durante un disservizio

Ogni risposta della piattaforma porta uno stato. L'app web e l'app mobile lo leggono e reagiscono allo stesso modo:

Stato	Significato	Cosa mostra l'app
`healthy`	Tutto funziona.	Niente di particolare.
`degraded`	Una parte non essenziale non è disponibile; l'app continua a funzionare.	Niente di particolare; le funzioni interessate segnalano un errore quando vengono usate.
`unavailable`	La piattaforma al momento non può servire le richieste (per esempio il database non è raggiungibile).	Un avviso a pagina intera sostituisce l'app non appena una richiesta fallisce. La pagina controlla la piattaforma ogni pochi secondi e torna da sola all'app quando funziona di nuovo.
`maintenance`	È attiva una finestra di manutenzione.	Finché la piattaforma funziona ancora: un avviso giallo in basso a destra con titolo e periodo della finestra. Può essere ridotto a una piccola icona di avvertimento e riaperto. Se le richieste iniziano a fallire durante la finestra, compare l'avviso a pagina intera con le stesse informazioni.

L'avviso a pagina intera mostra titolo, descrizione e periodo della finestra quando sono noti, altrimenti un avviso generico. Lingua e modalità scura si possono cambiare lì come nella pagina di accesso. Non serve ricaricare nulla manualmente.

I vostri impianti continuano a funzionare

Ogni impianto ha il proprio agente Mirox. Gli agenti funzionano in modo decentralizzato su cluster di agenti dedicati, in regioni diverse da quelle della piattaforma stessa, quindi un problema regionale lato piattaforma non li riguarda. Un agente non dipende dalla raggiungibilità della piattaforma:

L'agente continua a raccogliere e analizzare i dati dell'impianto e li conserva in un buffer locale finché la piattaforma non è disponibile; i dati nel buffer vengono consegnati quando la connessione torna, quindi lo storico non ha buchi.
La gestione degli agenti tratta un disservizio della piattaforma esattamente come tale: i carichi di lavoro dell'impianto restano distribuiti e in esecuzione. Non vengono mai fermati perché il cloud è temporaneamente irraggiungibile o in manutenzione.
Gli allarmi che l'agente valuta autonomamente continuano a essere valutati; le notifiche che passano dalla piattaforma seguono non appena questa è di nuovo disponibile.

Finestre di manutenzione

Il team Mirox annuncia i lavori pianificati come finestra di manutenzione. Una finestra ha un titolo, un breve motivo mostrato agli utenti, inizio e fine pianificati e un ambito: l'intera piattaforma o una regione.

Prima dell'inizio la finestra viene annunciata con almeno cinque giorni lavorativi di anticipo. Le finestre vengono pianificate solo quando i lavori lo richiedono, non con un ritmo settimanale, e di norma di sabato tra le 20:00 e le 23:59, ora dell'Europa centrale. L'app non mostra nulla prima dell'inizio della finestra.
Durante la finestra compare l'avviso giallo e la piattaforma può essere brevemente non disponibile. Gli agenti continuano a lavorare come descritto sopra.
Dopo la fine l'avviso sparisce da solo. Se i lavori finiscono prima, la finestra viene chiusa prima; se durano di più, viene prolungata e l'avviso resta.

Una finestra non modifica mai i vostri dati o la vostra configurazione. Comunica soltanto all'app, agli agenti e ai servizi della piattaforma che in quel periodo sono attese interruzioni.

Per integrazioni e utenti dell'API

Se chiamate l'API Mirox dai vostri sistemi, usate lo stato per reagire correttamente:

Ogni risposta HTTP porta l'intestazione X-Mirox-Status con uno dei quattro valori sopra.
GET /status (senza autenticazione) restituisce lo stato attuale e, durante una finestra, il suo titolo e periodo.
Un 503 insieme a unavailable o maintenance è una condizione della piattaforma, non un problema della vostra richiesta o delle vostre credenziali. Riprovate più tardi con una pausa crescente, non subito. Gli errori di autenticazione (401, 403) non c'entrano con questo meccanismo e non vanno ripetuti alla cieca.

Domande frequenti

Perché vedo un avviso di manutenzione anche se tutto funziona? La finestra è attiva, quindi sono possibili interruzioni. L'avviso è informativo; potete ridurlo.

I dati del mio impianto vanno persi durante un disservizio? No. L'agente li conserva nel buffer e li consegna dopo.

Posso essere informato prima di una finestra? Sì. Le finestre pianificate vengono annunciate con almeno cinque giorni lavorativi di anticipo attraverso i canali consueti; l'app stessa mostra una finestra solo finché è attiva.