Tracciamento su File
Le informazioni inerenti le comunicazioni gestite dal gateway vengono registrate su una base dati di tracciamento (Tracciamento su Database) e sono consultabili tramite una console di monitoraggio (Introduzione).
È possibile estendere o sostituire il normale tracciamento su database, attivando il tracciamento su file.
La nuova funzionalità consente il tracciamento su file di tutte le informazioni relative alle comunicazioni gestite da GovWay e un successivo processamento del file da strumenti esterni (es. FileBeat) permette così una facile integrazione con sistemi di tracciamento esterni (es. Logstash, Kafka, …).
La funzionalità consente una completa personalizzazione delle informazioni da riportare su file di log, permettendo anche di definirne il formato e l’ordine in cui vengono salvate. È inoltre possibile suddividere le informazioni in più file di log in modo da facilitare l’invio di informazioni selezionate a destinazioni diverse.
Le informazioni possono essere riversate in uno o più topic, dove ad ogni topic corrisponde tipicamente un file di log. Di seguito un esempio di file prodotto:
"req"|"b6cdd758-342c-4599-ae95-33a781730b3f"|"govway"|"2020-06-26 12:46:50:629"|"+0200"|"192.168.1.2"|"HTTP/1.1"|"POST"|"https://server:8446/example"|"application/soap+xml; charset=UTF-8; action=\"test/\""|"10490"|"200" "req"|"2a9dc253-9dd5-458b-8689-edee7c9ba139"|"govway"|"2020-06-26 12:47:50:561"|"+0200"|"192.168.1.2"|"HTTP/1.1"|"POST"|"https://server:8446/app2"|"application/soap+xml; charset=UTF-8; action=\"test/\""|"1090"|"503" "req"|"eeedb92b-66b5-451e-8266-ade2cf1f34ce"|"govway"|"2020-06-26 12:47:53:291"|"+0200"|"192.168.1.19"|"HTTP/1.1"|"POST"|"https://server:8446/example"|"application/soap+xml; charset=UTF-8; action=\"test/\""|"11230"|"200" "req"|"b4355a45-71cc-4293-b3b7-a4622af8ea84"|"govway"|"2020-06-26 12:48:00:102"|"+0200"|"192.168.1.22"|"HTTP/1.1"|"POST"|"https://server:8446/example"|"application/soap+xml; charset=UTF-8; action=\"test/\""|"17999"|"200"
Maggiori dettagli sul formato dei log vengono forniti nella sezione (Configurazione Tracciamento su File).
Nella sezione Configurazione dei Topic viene descritto il formato del file di configurazione, mentre nella sezione Informazioni Tracciabili sono riportate tutte le informazioni disponibili.
Per abilitare il tracciamento su file è possibile agire nella configurazione dedicata descritta nella sezione Registrazione della Transazione e riportata nella figura Fig. 353.
Fig. 353 Configurazione del tracciamento su file di log
La configurazione consente inoltre di abilitare la produzione dei log su file:
rispetto agli esiti di una transazione come descritto nella sezione Tracciamento filtrato per Esiti;
rispetto alle varie fasi di tracciamento descritte nella sezione Fasi di Tracciamento (Fig. 354).
Fig. 354 Configurazione delle fasi di tracciamento su file di log
È inoltre possibile configurare un ulteriore stato “configurazioneEsterna” (Fig. 355) che serve ad indicare che lo stato del tracciamento deve essere compreso esaminando la proprietà «org.openspcoop2.pdd.transazioni.fileTrace.enabled» del file di configurazione locale «/etc/govway/govway_local.properties». In questo caso è inoltre utilizzabile per attivare la funzionalità di FileTrace su una singola API la Proprietà “fileTrace.enabled” definibile sulla singola erogazione o sulla fruizione attraverso la sua valorizzazione con i valori “true” o “false” rispettivamente per attivare o disattivare la funzionalità.
Fig. 355 Configurazione del tracciamento su file di log tramite govway_local.properties
Maggiori dettagli sulla configurazione e sul formato dei log vengono forniti nella sezione (Configurazione Tracciamento su File).