{"id":36901,"date":"2024-04-25T11:07:24","date_gmt":"2024-04-25T09:07:24","guid":{"rendered":"https:\/\/help.qualiware.it\/qw-help\/?p=36901"},"modified":"2024-04-26T15:00:30","modified_gmt":"2024-04-26T13:00:30","slug":"monitoraggio-dei-flussi-applicativi-e-dello-stato-dei-servizi","status":"publish","type":"post","link":"https:\/\/help.qualiware.it\/qw-help\/monitoraggio-dei-flussi-applicativi-e-dello-stato-dei-servizi\/","title":{"rendered":"Monitoraggio dei flussi applicativi e dello stato dei servizi"},"content":{"rendered":"<p>Tutte le attivit\u00e0 compiute dal sistema vengono registrate nella tabella del database LOGDOC. Questo consente una precisa analisi degli eventi intervenuti sia su documenti e registrazione sia a livello di servizi di sistema, come ad esempio quelli forniti da <a href=\"https:\/\/help.qualiware.it\/qw-help\/sd-qwntsecservice\/\">QualiWare Server Daemon<\/a>. La disponibilit\u00e0 di identificativi univoci a livello di documento, conformemente a quanto previsto dal protocollo <a href=\"https:\/\/opentelemetry.io\/docs\/specs\/otel\/trace\/api\/#span\" target=\"_blank\" rel=\"noopener\">OTLP<\/a>, consente di ricostruire la sequenza di eventi che hanno riguardato uno specifico documento, ivi incluse eventuali interazioni con applicativi esterni.<\/p>\n<p>A tale scopo, \u00e8 disponibile lo strumento <strong>Health Monitor<\/strong>, descritto nel seguito, che offre una visione completa dello stato del sistema, con la possibilit\u00e0 di effettuare ricerche nelle registrazioni delle attivit\u00e0 attraverso molteplici parametri.<\/p>\n<p>La tabella LOGDOC comprende alcuni campi particolarmente importanti ai fini della ricerca delle cause di eventuali problemi:<\/p>\n<ul>\n<li>TOP: tipo di evento<\/li>\n<li>NOTE: contiene informazioni dettagliate sull&#8217;evento, fra le quali, ad esempio, il nome del file e i metadati nel caso di importazione.<\/li>\n<li>OTLP_TraceID:&nbsp; TraceID del protocollo <a href=\"https:\/\/opentelemetry.io\/docs\/specs\/otel\/trace\/api\/#span\" target=\"_blank\" rel=\"noopener\">OTLP<\/a>&nbsp;<\/li>\n<li>OTLP_SpanID: SpanID del protocollo <a href=\"https:\/\/opentelemetry.io\/docs\/specs\/otel\/trace\/api\/#span\" target=\"_blank\" rel=\"noopener\">OTLP<\/a>&nbsp;<\/li>\n<li>LEVEL: livello di gravit\u00e0 dell&#8217;evento (0= informativo; 1= warning; 2=error)<\/li>\n<li>SQL: istruzioni sql inviate al server per le operazioni di aggiornamento dei dati<\/li>\n<\/ul>\n<h3>Health Monitor<\/h3>\n<p>Lo strumento Health Monitor \u00e8 composto di due sezioni: <strong>Overview<\/strong> e <strong>Dettaglio Eventi<\/strong>. La prima offre una visione sintetica dello stato, attraverso alcuni indicatori di base.<\/p>\n<p id=\"the-pasted-async\"><a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-12.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36920\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-12.png\" alt=\"\" width=\"600\" height=\"278\" srcset=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-12.png 1804w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-12-768x355.png 768w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-12-1536x711.png 1536w\" sizes=\"(max-width: 600px) 100vw, 600px\" \/><\/a><\/p>\n<p>Di default, l&#8217;intervallo di date selezionato \u00e8 relativo al giorno corrente, ma \u00e8 possibile modificarlo attraverso la scheda di modifica dei parametri del cruscotto, attivabile dall&#8217;apposito pulsante presente in alto a destra.&nbsp;<\/p>\n<p>La sezione &#8220;Dettaglio eventi&#8221; si presenta invece come segue.<\/p>\n<p><a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-13.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36922\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-13.png\" alt=\"\" width=\"599\" height=\"255\" srcset=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-13.png 1810w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-13-768x327.png 768w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/image-13-1536x653.png 1536w\" sizes=\"(max-width: 599px) 100vw, 599px\" \/><\/a><\/p>\n<p>Viene presentato un dettaglio di tutte le registrazioni presenti nella tabella LOGDOC. Tale dettaglio \u00e8 filtrabile attraverso le caselle a discesa presenti subito sopra l&#8217;elenco, oppure usando la casella di filtro presente nell&#8217;intestazione di ogni colonna.&nbsp;<\/p>\n<p>Attraverso questa scheda, quindi, si ha la possibilit\u00e0 di visualizzare la traccia degli eventi che hanno riguardato uno specifico documento, filtrando sul parametro OTLP_TraceID, oppure di verificare eventuali errori di importazione di uno specifico file o di uno specifico messaggio, riportandone rispettivamente parte del nome o parte del soggetto nella casella di filtro presente nella colonna &#8220;Messaggio&#8221;.<\/p>\n<p>NOTA: i filtri presenti su questa scheda agiscono a valle di quelli impostati tramite la scheda &#8220;Parametri&#8221; attivabile tramite il pulsante in alto a destra. Questi ultimi vanno utilizzati se si vogliono effettuare ricerche mirate per data, per livello di criticit\u00e0, per testo contenuto nel messaggio e per OTLP_TraceID avendo prestazioni migliori, in quanto i parametri agiscono a livello di server SQL.<\/p>\n<h3><strong>Best practices<\/strong><\/h3>\n<p>Quando i flussi implementati comprendono l&#8217;esecuzione di script, come ad esempio avviene per gli <a href=\"https:\/\/help.qualiware.it\/qw-help\/qwntsec_actionlink_cfgform\/\"><strong>Action Link<\/strong><\/a>, i <strong><a href=\"https:\/\/help.qualiware.it\/qw-help\/qwntsec_trigger_cfgform\/\">Trigger<\/a><\/strong>, oppure per le azioni conseguenti ai cambiamenti di stato del workflow BPM, \u00e8 opportuno prevedere opportune registrazioni su LOGDOC a fronte, ad esempio, di errori o di condizioni anomale. A tale scopo, sono disponibili le primitive <strong>Write_LogDoc<\/strong> e <strong>BPMWorkflowWriteEvent<\/strong>, descritte <a href=\"https:\/\/help.qualiware.it\/qw-help\/primitive-di-sistema\">qui<\/a>. Entrambe le primitive consentono di specificare il riferimento ad un documento, tramite i parametri IdDoc e CodDoc. E&#8217; anche possibile specificare i valori di OTLP_TraceID e OTLP_SpanID, per correlare l&#8217;evento ad una specifica traccia. Se sono stati specificati IdDoc e CodDoc, e questi fanno riferimento ad un documento archiviato in una categoria BPM, \u00e8 possibile omettere i due parametri OTLP, che vengono acquisiti dal documento stesso.<\/p>\n<p>Nel caso degli <strong>ActionLink<\/strong>, \u00e8 opportuno prevedere, nella chiamata, la specifica dei parametri OTLP_TraceID e OTLP_SpanID, che vengono utilizzati nella registrazione automatica su LOGDOC delle chiamate ricevute, contraddistinte da IDDOC=&#8217;**&#8217; e CODDOC=&#8217;ACTIONLINK&#8217;. Tali parametri possono essere inseriti direttamente nella URL di richiamo, assieme al parametro ActionID.<\/p>\n<p>Nel caso dei <strong>Trigger<\/strong>, l&#8217;esecuzione viene registrata su LOGDOC con IDDOC=&#8217;**&#8217; e CODDOC=&#8217;TRIGGER&#8217;. La registrazione stessa avr\u00e0 il campo OTLP_TraceID assegnato automaticamente nel caso sia presente per il documento sul quale il trigger si \u00e8 attivato.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Tutte le attivit\u00e0 compiute dal sistema vengono registrate nella tabella del database LOGDOC. Questo consente una precisa analisi degli eventi intervenuti sia su documenti e registrazione sia a livello di servizi di sistema, come ad esempio quelli forniti da QualiWare Server Daemon. La disponibilit\u00e0 di identificativi univoci a livello di documento, conformemente a quanto previsto&hellip;<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"ngg_post_thumbnail":0,"footnotes":""},"categories":[4],"tags":[],"acf":[],"_links":{"self":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/36901"}],"collection":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/comments?post=36901"}],"version-history":[{"count":9,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/36901\/revisions"}],"predecessor-version":[{"id":36925,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/36901\/revisions\/36925"}],"wp:attachment":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/media?parent=36901"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/categories?post=36901"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/tags?post=36901"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}