Servizi di Monitoraggio

Per consentire l’integrazione con i sistemi di monitoraggio, GovPay mette a disposizione servizi interrogabili per verificare il funzionamento del sistema.

I servizi di monitoraggio sono di due tipi:

• Monitoraggio Domini

  per verificare l’esito delle ultime comunicazioni con il Nodo dei Pagamenti, relativamente ad uno specifico dominio.

• Monitoraggio GovPay

  per verificare il funzionamento delle singole componenti del prodotto.

Monitoraggio domini

Viene esposto un servizio di monitoraggio per dominio che fornisce indicazioni di stato inerenti l’esito delle interazioni con il Nodo dei Pagamenti. Il servizio si interroga con la seguente chiamata HTTP:

GET /govpay/frontend/api/pagopa/rs/check/{id_dominio} HTTP/1.1

Accept: application/json

in ritorno si ha un messaggio con questo formato:

{

«ultimo_aggiornamento»:null,

«codice_stato»:1,

«operazione_eseguita»:null,

«errore_rilevato»:»STATO NON VERIFICATO»

}

con la seguente semantica:

ultimo_aggiornamento	Data dell’ultimo aggiornamento dello stato
codice_stato	0: ok 1: stato non verificato 2: fail
operazione_eseguita	Operazione richiesta al nodo che ha aggiornato lo stato
errore_rilevato	Dettaglio dell’errore riscontrato

Monitoraggio GovPay

Sono implementati dei check sui servizi gestiti da GovPay per verificarne il corretto funzionamento. Lo stato dei check è consultabile tramite servizi REST.

GET /govpay/frontend/api/pagopa/rs/check/sonda/

Il servizio restituisce una panoramica dei check attivi sul sistema e del loro stato attuale. Per ciascuno è possibile acquisirne il dettaglio:

GET /govpay/frontend/api/pagopa/rs/check/sonda/{nome}

dove nome può assumere i seguenti valori:

update-psp	Check del servizio di aggiornamento PSP
update-rnd	Check del servizio di acquisizione flussi rendicontazione
update-pnd	Check del servizio di risoluzione pagamenti pendenti
update-ntfy	Check del servizio di spedizione notifiche
update-conto	Check del servizio di generazione estratti conto
check-ntfy	Check della coda di notifiche da spedire

in ritorno si ha un messaggio con questo formato:

{

«nome»:»check-ntfy»,

«stato»:0,

«descrizioneStato»:null,

«durataStato»:null,

«sogliaWarn»:»Numero di elementi accodati: 10»,

«sogliaError»:»Numero di elementi accodati: 100»,

«sogliaWarnValue»:10,

«sogliaErrorValue»:100,

«dataUltimoCheck»:1489673880116,

«tipo»:»Coda»

}

con la seguente semantica:

Nome	Identificativo della check
stato	null: stato non verificato 0: ok 1: warning 2: error
descrizioneStato	Descrizione informativa sullo stato assunto dal check
durataStato	Tempo in millisecondi in cui il check e” nello stato attuale
sogliaWarn	Soglia di Warning in forma descrittiva
sogliaError	Soglia di Error in forma descrittiva
sogliaWarnValue	Valore di soglia per lo stato di warning. La semantica del valore dipende dal tipo di check:
sogliaError	Come sogliaWarnValue ma per lo stato di error
dataUltimoCheck	Data dell’ultima verifica del check
tipo	Tipologia di check: