Configurazione di un adattatore per il controllo delle applicazioni attive
L'Adattatore di log generico fornisce una classe del programma di creazione output che consente agli
oggetti di Common Base Event generati dall'adattatore di essere inviati a un agente di registrazione log.
L'Analizzatore di log e di traccia può essere utilizzato per collegarsi all'agente di registrazione log
per controllare e analizzare il log dell'applicazione in tempo reale.
Prerequisiti:
Procedere come segue per configurare l'adattatore per il controllo.
Configurare il componente Programma di creazione output
Nota: quando viene creato un nuovo file di configurazione dell'adattatore, questo viene configurato in modo da utilizzare la classe CBELogOutputter per impostazione predefinita. Se questa impostazione non è stata modificata, è possibile saltare questa procedura.
Il componente programma di creazione output nel file di configurazione dell'adattatore deve essere aggiornato in modo da utilizzare la classe CBELogOutputter che scrive gli oggetti di Common Base Event in un agente di registrazione log. È anche possibile aggiornare il componente programma di creazione output esistente o aggiungerne uno nuovo.
Per aggiungere un nuovo componente programma di creazione output:
- Per modificare il file di configurazione dell'adattatore, selezionare il file di configurazione dell'adattatore nel riquadro Selezione.
Fare clic con il tasto destro del mouse e selezionare Apri con > Editor configurazione adattatore. Il file viene aperto nell'editor.
- Nella finestra Editor configurazione adattatore, espandere il nodo Adattatore > Configurazione > Istanza di contesto.
- Fare clic con il tasto destro del mouse sull'Istanza di contesto e selezionare Aggiungi > Programma di creazione output. Viene creato un nuovo programma di creazione output nell'Istanza di contesto.
- Nel campo Tipo di programma di creazione output, selezionare LoggingAgentOutputter.
- Fare clic sulla proprietà agentName. I dettagli sulla proprietà vengono visualizzati nel riquadro di destra.
- Aggiornare il valore della proprietà con il nome dell'agente di registrazione log desiderato. Questo è il nome che verrà visualizzato nell'Analizzatore di log e di traccia come l'agente di registrazione log da controllare.
- Se si desidera che il programma di creazione output aspetti prima di scrivere i Common Base Events nell'agente di registrazione log, aggiungere una proprietà waitUntilLoggingTime e impostare il relativo valore sul tempo in millisecondi. Per aggiungere la proprietà, fare clic con il tasto destro del mouse sul programma di creazione output appena creato e selezionare Aggiungi > Proprietà.
Viene creata una nuova proprietà nel nodo Programma di creazione output.
- Per abilitare la classe CBELogOutputter, è necessario creare il componente programma di creazione output associato nell'Implementazione contesto di base. Aprire Contesti > Implementazione contesto di base.
- Fare clic con il tasto destro del mouse su Implementazione contesto di base e selezionare Aggiungi > Componente.
Viene aggiunto un nuovo componente al contesto.
- Configurare il nuovo componente con i seguenti valori:
- Salvare le modifiche del file di configurazione dell'adattatore.
Configurare l'istanza di contesto
Se si desidera che il programma di analisi del log controlli costantemente il file di log, è necessario aggiornare le proprietà dell'istanza di contesto del file di configurazione dell'adattatore per l'operazione continua.
- Per modificare il file di configurazione dell'adattatore, selezionarlo nella prospettiva Selezione.
Fare clic con il tasto destro del mouse e selezionare Apri con > Editor configurazione adattatore. Il file viene aperto nell'editor.
- Nella finestra dell'editor, selezionare Adattatore > Configurazione > Istanza di contesto.
I dettagli dell'istanza di contesto vengono visualizzati nel riquadro di destra.
- Selezionare la casella di controllo Operazione continua.
- Configurare i campi Periodo di tempo di inattività massimo e Intervallo in base alle esigenze.
- Salvare le modifiche del file di configurazione dell'adattatore.
Avviare un processo Java per eseguire l'adattatore
L'adattatore di log creato può essere eseguito esternamente da un file batch in ambienti Windows o da uno script shell in ambienti non Windows. Di seguito sono riportati esempi di file che possono essere utilizzati per avviare il processo Java che eseguirà l'adattatore di log.
Nota: per collegare e controllare l'agente di registrazione log creato
dall'Adattatore di log generico, un Agent Controller deve essere installato sull'Adattatore di log generico
e deve essere avviato prima di esso.
File batch Windows:
@rem USAGE: runregex
@rem PURPOSE: Illustrates the functional capabilities of the Generic Log Adapter (GLA) run-time using an example adapter file and sample log file.
@rem INSTRUCTIONS: When executing in a GLA run-time environment, change the value of the %GLA_HOME% environment variable to the absolute path of the unzipped GLA run-time.
@rem NOTE: When executing in a plugin (e.g. Eclipse) run-time environment, create a temporary working directory and change the value of the %GLA_HOME% environment variable to the
@rem absolute path of the new temporary working directory. Furthermore, create a %GLA_HOME%\config directory and copy the contents of the org.eclipse.hyades.logging.adapter.config
@rem plugin to the new %GLA_HOME%\config directory. Finally, create a %GLA_HOME%\lib directory and copy the following JAR files to the new %GLA_HOME%\lib directory:
@rem Plugin | JAR
@rem ---------------------------------------------------
@rem org.eclipse.hyades.logging.adapter | hgla.jar
@rem org.eclipse.hyades.logging.core | hlcbe101.jar
@rem org.eclipse.hyades.logging.core | hlcore.jar
@rem org.eclipse.hyades.execution.remote | hexr.jar
@rem org.eclipse.emf.ecore | ecore.jar
@rem org.eclipse.emf.common | common.jar
SET GLA_HOME=d:\GenericLogAdapter
SET MY_DIRECTORY=MyAdapter
SET CONFIG_FILE=%GLA_HOME%\config\%MY_DIRECTORY%\myadapter.adapter
PUSHD %GLA_HOME%\config\%MY_DIRECTORY%\java -DGLA_HOME="%GLA_HOME%" -classpath "%GLA_HOME%\lib\hgla.jar;%GLA_HOME%\lib\hexr.jar;%GLA_HOME%\lib\hlcbe101.jar;%GLA_HOME%\lib\ecore.jar;%GLA_HOME%\lib\common.jar;%GLA_HOME%\lib\hlcore.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"
POPD
File batch non Windows:
#!/bin/sh
# USAGE: runregex_example.sh
# PURPOSE: Illustrates the functional capabilities of the Generic Log Adapter (GLA) run-time using an example adapter file and sample log file.
# INSTRUCTIONS: When executing in a GLA run-time environment, change the value of the $GLA_HOME environment variable to the absolute path of the unzipped GLA run-time.
# NOTE: When executing in a plugin (e.g. Eclipse) run-time environment, create a temporary working directory and change the value of the $GLA_HOME environment variable to the
# absolute path of the new temporary working directory. Furthermore, create a $GLA_HOME/config directory and copy the contents of the com.ibm.etools.logging.adapter.config
# plugin to the new $GLA_HOME/config directory. Finally, create a $GLA_HOME/lib directory and copy the following JAR files to the new $GLA_HOME/lib directory:
# Plugin | JAR
# ---------------------------------------------------
# org.eclipse.hyades.logging.adapter | hgla.jar
# org.eclipse.hyades.logging.core | hlcbe101.jar
# org.eclipse.hyades.logging.core | hlcore.jar
# org.eclipse.hyades.execution.remote | hexr.jar
# org.eclipse.emf.ecore | ecore.jar
# org.eclipse.emf.common | common.jar
GLA_HOME=/home/eclipse/GenericLogAdapter
export GLA_HOME
YOUR_DIRECTORY=MY_DIRECTORY
export MY_DIRECTORY
CONFIG_FILE="$GLA_HOME/config/$MY_DIRECTORY/myadapter.adapter"
export CONFIG_FILE
CUR_DIR=`pwd`
export CUR_DIR
cd "$GLA_HOME/config/$MY_DIRECTORY
java -DGLA_HOME="$GLA_HOME" -classpath "$GLA_HOME/lib/hgla.jar:$GLA_HOME/lib/hexr.jar:$GLA_HOME/lib/hlcbe101.jar:$GLA_HOME/lib/ecore.jar:$GLA_HOME/lib/common.jar:$GLA_HOME/lib/hlcore.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "$CONFIG_FILE" -cc "$CONFIG_FILE"
cd "$CUR_DIR"
Configurare il file come indicato per avviare il processo Java che eseguirà l'adattatore.
Controllo del log dell'applicazione attiva
È possibile adesso controllare il log dell'applicazione attiva.
- Verificare che la registrazione log sia abilitata nelle preferenze.
- Dalla barra degli strumenti principale, selezionare
Finestra > Preferenze. Viene aperta la procedura guidata Preferenze.
- Selezionare Creazione profili e log dal riquadro di sinistra. Le preferenze di Creazione profili e log vengono caricate nel riquadro di destra.
- Selezionare Attiva registrazione nelle opzioni Creazione profili e log.

- Selezionare OK per applicare le modifiche.
- Nella prospettiva Creazione profili e log, fare clic su Creazione profili
nella barra degli strumenti e selezionare Profilo. Viene visualizzata la procedura guidata Profilo.
- Selezionare Collega - processo Java e fare clic sul pulsante Nuovo in fondo all'elenco. Viene creata una nuova configurazione processo Java.
- Fare clic sulla scheda Host e selezionare l'host sul quale si trova il log dell'applicazione
spostandola nel riquadro Agenti selezionati utilizzando il pulsante freccia.
Nota: per controllare un log dell'applicazione attiva, Agent Controller deve essere in esecuzione sullo stesso sistema dell'applicazione.
- Fare clic sulla scheda Agenti e utilizzare i tasti freccia per selezionare l'agente di registrazione log configurato.
- Fare clic su Applica.
- Fare clic su Profilo per collegarsi all'agente di registrazione log.
- Nella vista Controllo profili della prospettiva Creazione profili e log,
selezionare l'agente di registrazione.
- Fare clic con il tasto destro del mouse sull'agente e selezionare Avvia controllo.
- Fare clic con il tasto destro del mouse sull'agente e selezionare Apri con > Vista Log.
Gli eventi del log dell'applicazione vengono caricati nella vista Log.
Argomenti correlati
Panoramica sull'Adattatore di log generico Hyades
Specifica del formato di Common Base Event
Attività correlate
Creazione di un programma di analisi del log
Riferimenti correlati
Struttura del file di configurazione dell'adattatore
Editor configurazione adattatore
Grammatica espressione regolare
(C) Copyright IBM Corporation 2000, 2005. Tutti i diritti riservati.