Nodo CandleMonitor


Icona nodo CandleMonitor

Il nodo CandleMonitor fa parte del prodotto IBM Tivoli OMEGAMON XE for Messaging: WebSphere Message Broker Monitoring. Raccoglie statistiche sulle prestazioni del flusso di messaggi e, opzionalmente, produce messaggi di evento per il rilevamento di OMEGAMON XE. È un nodo di passaggio semplice, con un terminale di input ("in") ed un terminale di output ("out"). Il nodo CandleMonitor propaga i messaggi senza modificarli dal terminale di input al terminale di output.

Posizionamento del nodo CandleMonitor nelle statistiche di monitoraggio

Lo scopo principale del nodo CandleMonitor è produrre statistiche. È importante che il nodo venga inserito correttamente nel flusso dei messaggi in modo che i prospetti delle statistiche di monitoraggio dei prodotti contengano dati utili. Per ottenere statistiche più accurate, durante la progettazione di un flusso di messaggi, si consiglia di inserire un nodo CandleMonitor immediatamente dopo il nodo MQInput. L'attributo "Tipo" di un nodo che si trova in questa posizione, dovrebbe essere modificato in "Input". Se si desidera inserire solo un nodo CandleMonitor nel flusso di messaggi, la posizione "Input" è la scelta migliore, perché la maggior parte delle statistiche vengono generate da questa stessa posizione. Tuttavia, un'altra posizione chiave per inserire il nodo è immediatamente prima di qualsiasi nodo di output, ad esempio MQOutput, MQReply o Publication, in modo da consentire il calcolo di frequenza dell'output. In questo caso, l'attributo "Tipo" del nodo, dovrebbe essere modificato in "Output".

Monitoraggio dei flussi secondari

È possibile produrre statistiche per le parti dei flussi di messaggi, indicate in questo contesto come flussi secondari. Un flusso secondario potrebbe essere un flusso di messaggi separato, integrato in un flusso di messaggi principale (Tipo I), o un gruppo di uno o più nodi in un flusso, definito come flusso secondario che utilizza il nodo CandleMonitor (Tipo II).

Per monitorare un flusso secondario di Tipo I, è necessario inserire un nodo CandleMonitor immediatamente dopo il Terminale di input nel flusso ed un altro nodo CandleMonitor immediatamente prima del Terminale di output o di un altro output del flusso. A tutti questi nodi deve essere assegnato lo stesso valore dell'attributo "subFlowName". Il tipo di nodo nella posizione di input deve essere "subFlowInput". Il tipo di nodo nella posizione di output, deve essere "subFlowOutput", o "output" se l'output è un nodo, ad esempio MQOutput, e rappresenta la fine del flusso di messaggi di un messaggio che si trova in un determinato percorso.

Per monitorare un flusso secondario di Tipo II, è necessario inserire un nodo CandleMonitor all'inizio del flusso secondario desiderato, impostare il rispettivo tipo su "subFlowInput", ed assegnarvi l'attributo "subFlowName". Quindi è necessario inserire un nodo CandleMonitor alla fine del flusso secondario, impostare il tipo su "subFlowOutput", ed assegnare lo stesso valore di attributo subFlowName del nodo di input. Se la sezione da monitorare del flusso di messaggi contiene più connettori di input o di output, sarà necessario aggiungere più nodi CandleMonitor allo stesso modo con lo stesso "subFlowName".

Affinché vengano calcolate statistiche valide, sia l'input che l'output del flusso devono essere contrassegnati con i nodi CandleMonitor. Il nodo CandleMonitor di tipo "subFlowOutput" è richiesto nel flusso secondario. Non è facoltativo, in quanto si tratta del caso corrente con il nodo di tipo "Output" per il flusso di messaggi principale. Se l'attributo "subFlowName" viene impostato insieme all'attributo "Tipo" di "Input", il nodo risulterà essere una combinazione del tipo "Input" e del tipo "subFlowInput". Se l'attributo "subFlowName" è impostato con un attributo "Tipo" di "Output", il nodo risulterà una combinazione del tipo "Output" e del tipo "subFlowOutput".

Monitoraggio di singoli punti in un flusso di messaggi

È possibile inserire un nodo CandleMonitor in qualsiasi punto del flusso di messaggi se si desidera ottenere statistiche in un singolo punto del flusso di messaggi e visualizzarle nella vista di prospetto Statistiche nodo CandleMonitor. In questi casi, l'attributo "Tipo" del nodo, deve essere "Altro". Per i nodi "Altro" dell'attributo "Tipo", è possibile impostare l'attributo "subFlowName", ma avrà solo la funzione di identificare il nodo come parte del flusso secondario e non avrà alcuna influenza sulle statistiche del flusso secondario generate.

Generazione eventi del flusso di messaggi

Il nodo CandleMonitor può anche essere utilizzato per produrre eventi del flusso di messaggi definiti dall'utente che possano essere rilevati mediante le situazioni e i prospetti di OMEGAMON XE Message Flow Events. Quando si inserisce un nodo con questo scopo, l'attributo "Tipo" deve essere "Altro" e l'impostazione dell'attributo "eventMessage" dovrà essere il testo del messaggio che si desidera visualizzare nei prospetti e/o rilevare con le situazioni ogni qual volta viene immesso questo nodo. Il nodo CandleMonitor inoltre cattura altre informazioni nell'evento, utili per identificare la parte del flusso di messaggi coinvolta e il messaggio in corso di elaborazione nel momento in cui si verificava l'evento.

L'inserimento di un nodo per la generazione di eventi del flusso di messaggi è a discrezione dell'utente, ma IBM consiglia di non inserire nodi con questo scopo nelle parti del flusso di messaggi considerate come procedura normale. Si consiglia di utilizzare questa funzione nei percorsi di un flusso di messaggi con errori di elaborazione o con altre condizioni non considerate normali che devono essere segnalate. Ad esempio, è possibile inserire un nodo con questo scopo dopo il terminale "failure" nel nodo MQInput. Non si consiglia di impostare l'attributo "eventMessage" per i nodi di tipo "Input" o "Output". Allo stesso modo, l'attributo "eventMessage" dovrebbe essere impostato solo per i tipi di nodi "subFlowInput" o "subFlowOutput" che normalmente non fanno parte dell'elaborazione (ad esempio, in un flusso secondario di gestione errori). Qualsiasi nodo CandleMonitor genera automaticamente eventi per le eccezioni del flusso di messaggi rilevate dal nodo. Tenere presente che il nodo CandleMonitor non effettua nessun recupero di errore in quanto è solo un nodo di passaggio. Per questo tipo di problema, funziona come un meccanismo di avviso.

Monitoraggio tempi della coda

L'attributo "collectQueueTime" si applica ai nodi di tipo "Input" e consente di disattivare la raccolta di statistiche dei tempi della coda. I tempi della coda vengono calcolati utilizzando la data e ora di immissione del messaggio nella coda. Se la coda di input in un flusso di messaggi contiene messaggi con data e ora di immissione che non rispecchiano accuratamente il momento in cui il messaggio è stato inserito nella coda, durante la configurazione del nodo CandleMonitor di tipo "Input", l'attributo "collectQueueTime" dovrà essere impostato su "no" in modo che non vengano raccolti i tempi della coda relativi a tali messaggi. La data e l'ora di immissione non sono indicatori validi quando il contesto di origine di un messaggio viene conservato durante l'immissione da parte di un'applicazione nella coda di input del flusso di messaggi. Questa condizione generalmente si verifica quando l'applicazione è un'utilità di spostamento messaggio che sposta i messaggi da una coda all'altra o quando qualsiasi applicazione trasmette o imposta l'origine del contesto di un messaggio. In particolare, se la coda di input di un flusso di messaggi B è la coda di output del flusso di messaggi A, il broker trasmette il contesto di origine in modo che la data e l'ora di immissione per il messaggio nel flusso di messaggi B non consente un calcolo accurato dei tempi della coda. L'attributo "collectQueueTime" del nodo CandleMonitor nel flusso di messaggi B dovrà essere impostato su "no".

Attivazione e disattivazione dei nodi CandleMonitor

L'attributo "activateNode" consente di specificare il livello di attivazione del nodo CandleMonitor in modo che sia possibile disattivarlo. L'impostazione predefinita è "Sì" che indica che il nodo è attivo (non disattivato). In WebSphere Business Integration versione 5.0 e versioni successive, è possibile configurare l'attributo "activateNode". L'attributo può essere impostato durante la configurazione del file di barra in modo da avere diverse impostazioni nei diversi file utilizzati per l'istanza da distribuire per la verifica e la produzione. Inoltre, nella versione 5.0 è possibile promuovere le impostazioni dell'attributo in modo che siano le stesse per ciascuna istanza del nodo CandleMonitor in un flusso di messaggi. L'impostazione dei valori possibili per l'attributo supporta la specifica di alcune regole generali per quando il nodo è attivo, ad esempio si indica che il nodo deve essere attivo per tutti i tipi di nodi di input ed output, ma per nessun altro. In generale, durante la configurazione di un nodo CandleMonitor in un flusso di messaggi, lasciare l'impostazione predefinita "Sì" inalterata per facilitare l'uso del nodo durante la verifica. Durante la distribuzione in un broker di produzione, configurare le impostazioni del file di barra per "activateNode" sul livello desiderato e far sì che l'attributo modifichi automaticamente le impostazioni di tutti i nodi nel flusso al livello di attivazione specificato. Per le versioni precedenti alla 5.0 (e per la 5.0), il codice di plugin del nodo CandleMonitor accetta la specifica di un'impostazione di sostituzione al runtime per l'attributo "activateNode", consentendo così diversi livelli di attivazione per diversi broker. Per ulteriori informazioni consultare la Guida per l'utente.

Terminali nodo CandleMonitor

in Il terminale di input che accetta un messaggio perché venga elaborato dal nodo.
out Il terminale di output in cui viene propagato il messaggio.

Proprietà nodo CandleMonitor

Attributo Predefinito Descrizione
Tipo "Altro" Specifica il tipo di nodo CandleMonitor. I valori validi sono:
Input
Vengono utilizzate le statistiche raccolte nella maggior parte dei calcoli (tranne per i valori "Output") per tutti i livelli di prospetto fatta eccezione per il flusso secondario se non viene specificato subFlowName.
Output
Vengono utilizzate le statistiche raccolte nella frequenza dell'output e nei conteggi per tutti i livelli di prospetto fatta eccezione per il flusso secondario se subFlowName non è specificato.
Altro
Vengono utilizzate le statistiche raccolte solo per i prospetti Statistiche nodo CandleMonitor. Questo tipo risulta utile se utilizzato con l'attributo eventMessage.
subFlowInput
Vengono utilizzate le statistiche raccolte solo per il calcolo di statistiche del flusso secondario. È necessario specificare l'attributo subFlowName.
subFlowOutput
Vengono utilizzate le statistiche raccolte solo per il calcolo di statistiche del flusso secondario. È necessario specificare l'attributo subFlowName.
eventMessage "" Causa un evento da produrre quando viene specificato il nodo se il valore non è impostato su "".
collectQueueTime "Sì" Specifica se il nodo deve raccogliere i tempi della coda. I valori validi sono e No.
subFlowName "" Specifica il nome del flusso secondario a cui appartiene il nodo CandleMonitor.
activateNode "Sì" Specifica il livello di attivazione del nodo. I valori validi sono:
Il nodo CandleMonitor è attivo.
No
Il nodo CandleMonitor non è attivo. Non produrrà statistiche o eventi del flusso dei messaggi.
eventOnly
Il nodo CandleMonitor è attivo solo se viene assegnato un valore diverso da "" all'attributo "eventMessage". Tuttavia, non produce statistiche, ma solo eventi del flusso dei messaggi.
inputOutputOnly
Il nodo CandleMonitor è attivo solo se l'attributo "Tipo" è "Input" o "Output". In questi casi produce statistiche. Inoltre produce eventi del flusso di messaggi se è impostato l'attributo "eventMessage".
inputOutputAndEventOnly
Il nodo CandleMonitor è attivo solo se l'attributo "Tipo" è "Input" o "Output", o se all'attributo "eventMessage" è stato assegnato un valore diverso da "". In questi casi produce statistiche. Inoltre produce eventi del flusso di messaggi se è impostato l'attributo "eventMessage".

 

(C) IBM Corporation 2006. Tutti i diritti riservati