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:

  1. 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.
  2. Nella finestra Editor configurazione adattatore, espandere il nodo Adattatore > Configurazione > Istanza di contesto.
  3. 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.
  4. Nel campo Tipo di programma di creazione output, selezionare LoggingAgentOutputter.
  5. Fare clic sulla proprietà agentName. I dettagli sulla proprietà vengono visualizzati nel riquadro di destra.
  6. 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.
  7. Se si desidera che il programma di creazione output attenda prima di scrivere i Common Base Event nell'agente di registrazione, aggiungere una proprietà denominata waitUntilLoggingTime e impostare il valore della proprietà 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.
  8. 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.
  9. Fare clic con il tasto destro del mouse su Implementazione contesto di base e selezionare Aggiungi > Componente. Viene aggiunto un nuovo componente al contesto.
  10. Configurare il nuovo componente con i seguenti valori:
    Nome: Nome del programma di creazione output nel contesto
    Descrizione: Descrizione delle azioni eseguite dal programma di creazione output
    Classe eseguibile: org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter
    Livello di log:Il livello di log interno che il componente programma di creazione output interno deve utilizzare.
    Un valore pari a 99 indica che il programma di creazione output non registrerà alcun messaggio.
    Un valore pari a 0 indica che il programma di creazione output registrerà i messaggi di qualsiasi gravità.
    Il valore consigliato è di 50 e indica che vengono registrati solo i messaggi di errore del programma di creazione output interno irreversibile o critico.
    Ruolo: Programma di creazione output
    IDUnivoco: Deve indicare il programma di creazione output definito nell'istanza di contesto al passo 3. Utilizzare il pulsante Sfoglia per selezionare l'ID corretto.
  11. Salvare le modifiche del file di configurazione dell'adattatore.

Configurare l'Istanza di contesto

Se si desidera che il programma di analisi di log controlli il file di log continuamente, è necessario aggiornare le proprietà dell'istanza di contesto del file di configurazione dell'adattatore per l'operazione continua.

  1. Per modificare il file di configurazione dell'adattatore, selezionare il file di configurazione dell'adattatore nella prospettiva Selezione. Fare clic con il tasto destro del mouse e selezionare Apri con > Editor configurazione adattatore. Il file viene aperto nell'editor.
  2. Nella finestra dell'editor, selezionare Adattatore > Configurazione > Istanza di contesto. I dettagli dell'istanza di contesto vengono visualizzati nel riquadro di destra.
  3. Selezionare la casella di controllo Operazione continua.
  4. Configurare il campo Periodo di tempo di inattività massimo e Intervallo in base alle esigenze.
  5. 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 creato dall'adattatore log generico, sarà necessario installare un Agent Controller Hyades nel sistema su cui occorre eseguire l'adattatore log generico e avviarlo prima di quest'ultimo.

File batch Windows:

@rem USAGE:  runregex
@rem PURPOSE: Illustrates the functional capabilities of the Generic Log Adapter (GLA) 
@rem run-time using an example adapter file and sample log file. 
@rem ASSUMPTIONS: This batch file assumes the GLA run-time and required files are 
@rem stored in the following directory structure: 
@rem %GLA_HOME%\config - GLA adapter configuration files 
@rem %GLA_HOME%\lib - GLA run-time and required jars 
@rem %GLA_HOME%\schema - GLA adapter configuration schema files 
@rem INSTRUCTIONS: 
@rem If the GLA run-time and required files are stored as indicated in the 
@rem assumptions section above, change the value of the %GLA_HOME% 
@rem environment variable to the absolute path where the GLA run-time 
@rem and required files are stored. 
@rem If the GLA run-time files are stored in a plug-in (e.g. Eclipse) 
@rem environment, perform the following instructions: 
@rem 1) Create a temporary directory to store the GLA run-time and required files. 
@rem 2) Create the config, lib, and schema directories in the temporary 
@rem directory creatd in step 1) 
@rem 3) Change the value of the %GLA_HOME% environment variable to the 
@rem absolute path of the temporary directory created in step 1) 
@rem 4) Copy the adapter files you want to run into the %GLA_HOME%\config directory. 
@rem For example if you want to run the Apache adapter files then copy the 
@rem Apache directory of the org.eclipse.hyades.logging.adapter.config 
@rem plug-in and all of its contents to the %GLA_HOME%\config directory. 
@rem 5) Copy the contents of the schema directory of 
@rem org.eclipse.hyades.logging.adapter plug-in to the %GLA_HOME%\schema directory. 
@rem 6) Copy the following jar files to the %GLA_HOME%\lib directory 
@rem Plug-in | 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 CONFIG_FILE=%GLA_HOME%\config\my.adapter 
@PUSHD %GLA_HOME%\config\ 
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.sh 
# PURPOSE: Illustrates the functional capabilities of the Generic Log Adapter (GLA) 
# run-time using an example adapter file and sample log file. 
# ASSUMPTIONS: This shell file assumes the GLA run-time and required files are 
# stored in the following directory structure: 
# %GLA_HOME%/config - GLA adapter configuration files 
# %GLA_HOME%/lib - GLA run-time and required jars 
# %GLA_HOME%/schema - GLA adapter configuration schema files 
# INSTRUCTIONS: 
# If the GLA run-time and required files are stored as indicated in the 
# assumptions section above, change the value of the %GLA_HOME% 
# environment variable to the absolute path where the GLA run-time 
# and required files are stored. 
# If the GLA run-time files are stored in a plug-in (e.g. Eclipse) 
# environment, perform the following instructions: 
# 1) Create a temporary directory to store the GLA run-time and required files. 
# 2) Create the config, lib, and schema directories in the temporary 
# directory creatd in step 1) 
# 3) Change the value of the %GLA_HOME% environment variable to the 
# absolute path of the temporary directory created in step 1) 
# 4) Copy the adapter files you want to run to the %GLA_HOME%/config directory. 
# For example, if you want to run the Apache adapter files then copy the 
# Apache directory of the org.eclipse.hyades.logging.adapter.config 
# plug-in and all of its contents to the %GLA_HOME%/config directory. 
# 5) Copy the contents of the schema directory of 
# org.eclipse.hyades.logging.adapter plug-in to the %GLA_HOME%/schema directory. 
# 6) Copy the following jar files to the %GLA_HOME%/lib directory 
# Plug-in | 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 

CONFIG_FILE="$GLA_HOME/config/my.adapter" 
export CONFIG_FILE

CUR_DIR=`pwd`
export CUR_DIR

cd "$GLA_HOME/config" 

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 per avviare il processo Java che eseguirà l'adattatore.

Controllo del log dell'applicazione attiva

È possibile adesso controllare il log dell'applicazione attiva.

  1. Verificare che la registrazione log sia abilitata nelle preferenze.
    1. Dalla barra degli strumenti principale, selezionare Finestra > Preferenze. Viene aperta la procedura guidata Preferenze.
    2. Selezionare Creazione profili e log dal riquadro di sinistra. Le preferenze di Creazione profili e log vengono caricate nel riquadro di destra.
    3. Selezionare Attiva registrazione nelle opzioni Creazione profili e log.

      La casella di controllo Attiva registrazione è selezionata nel riquadro delle preferenze per la Creazione profili e log

    4. Selezionare OK per applicare le modifiche.
  2. Nella prospettiva Creazione profili e log, fare clic sull'icona Creazione profili Icona dello strumento di creazione profili nella barra degli strumenti e selezionare Profilo.Viene visualizzata la procedura guidata Profilo.
  3. Selezionare Collega - processo Java e fare clic sul pulsante Nuovo in fondo all'elenco. Viene creata una nuova configurazione processo Java.
  4. Fare clic sulla scheda Host e selezionare l'host sul quale si trova il log dell'applicazione.
    Nota: per controllare un log dell'applicazione attiva, Agent Controller deve essere in esecuzione sullo stesso sistema dell'applicazione.
  5. Fare clic sulla scheda Agenti e utilizzare i tasti freccia per selezionare l'agente di registrazione log configurato.

    Nella procedura guidata Preferenze di creazione profili, l'agente di registrazione creato dall'utente si trova nel riquadro a sinistra

  6. Fare clic su Applica.
  7. Fare clic su Profilo per collegarsi all'agente di registrazione.
  8. Nella prospettiva Creazione profili e log nella vista Controllo di creazione profili, selezionare l'agente di registrazione log.
  9. Fare clic con il tasto destro del mouse sull'agente e selezionare Avvia controllo.
  10. Fare clic con il tasto destro del mouse sull'agente e selezionare Apri con > Vista Log. Gli eventi di log vengono caricati nella vista log dal log dell'applicazione.
    Nota: se nella vista log non sono disponibili dei record di log, fare clic sul pulsante Aggiorna viste nella parte superiore del riquadro Controllo di creazione profili.

 

Argomenti correlati
Panoramica dell'Adattatore di log generico
Specifica del formato di Common Base Event

Attività correlate
Creazione di un programma di analisi di log

Riferimenti correlati
Struttura del file di configurazione dell'adattatore
Editor configurazione adattatore
Grammatica espressione regolare