JC3 - Monitor servizi
JC3.1 - Vedere quali servizi sono accesi
In una frase. Il Monitor servizi ha una pagina con l'elenco dei servizi iscritti: chi gestisce il server la apre per capire, in un colpo d'occhio, chi è acceso.
Quando una pagina non si apre, la prima domanda è sempre la stessa: quale servizio non risponde? Senza un elenco bisognerebbe provarli uno per uno. Il Monitor servizi l'elenco ce l'ha già, e non lo scrive nessuno a mano: ogni servizio, quando si accende, si iscrive da solo con il suo nome e il suo indirizzo. Poi manda un segnale a intervalli regolari per dire «ci sono ancora».
Ogni servizio si iscrive quando si accende; il Gateway consulta l'elenco per sapere a chi inoltrare
Collegati al server. La pagina del Monitor servizi si apre solo dal server stesso, non dal tuo PC. È una scelta di sicurezza: il Monitor servizi non ha password.
Apri la pagina. Sul server, in un browser, vai all'indirizzo
http://localhost:8761.Leggi l'elenco dei servizi iscritti. C'è una riga per servizio, con il nome e lo stato. Con tutto acceso trovi il Gateway (
API-GATEWAY), ADEnext (ADE-NEXT-SERVICE), SIGEAnext (SIGEA-NEXT-SERVICE) e GPEnext (GPE-NEXT-SERVICE). Lo statoUPvuol dire che il servizio risponde.Cerca chi manca. Un servizio che non compare non si è iscritto: è spento, sta ancora partendo o non riesce a raggiungere il Monitor servizi.
Nota. L'elenco non è istantaneo. Un servizio appena acceso compare dopo qualche decina di secondi. Uno caduto all'improvviso può restare scritto ancora per un po', perché il Monitor servizi aspetta prima di cancellarlo: un attimo di rete lenta non deve far sparire un servizio che sta bene.
Attenzione. Nell'elenco non trovi il Ponte col COBOL, l'Assistente dei dati e l'Accesso: non si iscrivono al Monitor servizi. Che manchino è normale.
Per chi sviluppa.
• Il Monitor servizi è backend/middleware/it_gsba_eureka_server; la pagina è il cruscotto standard di Eureka, sulla porta 8761.
• Nell'installazione la porta è pubblicata solo su 127.0.0.1 (PORTE_INTERNE_BIND, vedi devops/deploy/README.md).
• Ogni servizio ha anche il suo controllo di stato: /actuator/health. Quello del Gateway risponde senza accesso.
• L'attesa prima di cancellare un servizio muto si regola con EUREKA_SERVER_ENABLE_SELF_PRESERVATION e EUREKA_SERVER_EVICTION_INTERVAL_TIMER_IN_MS.
JC3.2 - Cosa succede se un servizio è spento
In una frase. Si ferma solo quello che quel servizio faceva: il resto del gestionale continua a lavorare, e quando il servizio torna riparte da solo.
In un programma fatto di un pezzo solo, un guasto ferma tutto. Qui ogni servizio ha il suo compito, e il Gateway inoltra una richiesta solo al servizio che la riguarda. Se quel servizio non c'è, la richiesta torna indietro con un errore. Le altre non se ne accorgono.
Le stampe sono spente: le richieste di stampa tornano con l'errore 503, le altre arrivano a destinazione
Un esempio. GPEnext, il servizio delle stampe, è fermo.
- Apri una tabella: funziona. La richiesta va a SIGEAnext, che è acceso.
- Apri una schermata disegnata: funziona. La richiesta va a ADEnext.
- Chiedi un PDF: non funziona. Il Gateway cerca GPEnext nell'elenco del Monitor servizi, non lo trova e risponde con l'errore 503, che vuol dire «servizio non disponibile». I pulsanti della stampa diventano grigi e dicono perché.
Quando GPEnext riparte non c'è niente da riattivare. Si iscrive di nuovo al Monitor servizi, il Gateway rilegge l'elenco e le stampe tornano. Di solito basta un minuto da quando il servizio è pronto.
Per questo, subito dopo un aggiornamento, può capitare di vedere un errore 503: i servizi stanno partendo e non sono ancora tutti nell'elenco. Aspetta un minuto e riprova.
| Se è spento | Cosa non va | Cosa continua |
|---|---|---|
| GPEnext | Stampe in PDF e designer dei modelli | Tabelle, schermate, analisi |
| ADEnext | Schermate disegnate e cruscotti salvati | Maschere storiche di SBHweb |
| SIGEAnext | Dati del gestionale nelle pagine nuove | Maschere storiche di SBHweb |
| Gateway | Tutte le pagine nuove | Le maschere storiche, che fanno l'altra strada |
Attenzione. Il Gateway e il Monitor servizi sono i due pezzi da cui dipendono tutte le pagine nuove. Se si ferma il Gateway, nessuna richiesta arriva ai servizi. Se si ferma il Monitor servizi, il Gateway va avanti per un po' con l'ultimo elenco che ha letto, ma i servizi che ripartono non riescono più a farsi trovare.
Per chi sviluppa.
• Il 503 lo dà il Gateway quando per lb://NOME-DEL-SERVIZIO non c'è nessuna istanza iscritta.
• Nell'installazione i servizi partono dopo che il Monitor servizi ha risposto al controllo di stato (depends_on in devops/deploy/docker-compose.deploy.yml).
• Se è il Gateway a essere fermo o in riavvio, il server web dell'app risponde 502: ritrova il Gateway da solo appena torna.