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.

Aggiornare 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 aspetti prima di registrare le informazioni nella classe CBELogOutputter, 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.
  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 2. Utilizzare il pulsante Sfoglia per selezionare l'ID corretto.
  11. Salvare le modifiche del file di configurazione dell'adattatore.

Aggiornare l'istanza di contesto

Se si desidera che il programma di analisi del 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 il 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 eseguire l'Adattatore di log generico su un sistema, è necessario che Hyades sia installato sul sistema in questione.

File batch Windows:

@rem USAGE:  runregex
@rem Change the following lines to point to the directory where you unzipped the runtime
@rem and the directory where your log adapter resides 
SET HYADES_HOME=d:\hyadesDC
SET YOUR_ADAPTER_DIRECTORY=MyAdapterDirectory
SET CONFIG_FILE=%HYADES_HOME%\%YOUR_ADAPTER_DIRECTORY%\myadapter.adapter
PUSHD %HYADES_HOME%\%YOUR_ADAPTER_DIRECTORY%
java -classpath "%HYADES_HOME%\lib\glaconfigs.jar;%HYADES_HOME%\lib\hexr.jar;%HYADES_HOME%\lib\hgla.jar;%HYADES_HOME%\lib\hglaconfig.jar;%HYADES_HOME%\lib\hlcore.jar;%HYADES_HOME%\lib\hlevents.jar;%HYADES_HOME%\lib\hparse.jar;;%HYADES_HOME%\lib\logparsers.jar;%HYADES_HOME%\lib\xalan.jar;" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"
POPD
File batch non Windows:
#!/bin/sh
# USAGE:  runregex_example.sh
# Change the following line to point to the directory where you unzipped the runtime
HYADES_HOME=/home/hyadesDC
export HYADES_HOME
YOUR_DIRECTORY=/yourdirectory
export YOUR_DIRECTORY

CONFIG_FILE=$HYADES_HOME/$YOUR_DIRECTORY/myadapter.adapter
export CONFIG_FILE

CUR_DIR=`pwd`
export CUR_DIR

cd $HYADES_HOME/$YOUR_DIRECTORY

java -classpath "$HYADES_HOME\lib\glaconfigs.jar;$HYADES_HOME\lib\hexr.jar;$HYADES_HOME\lib\hgla.jar;$HYADES_HOME\lib\hglaconfig.jar;$HYADES_HOME\lib\hlcore.jar;$HYADES_HOME\lib\hlevents.jar;$HYADES_HOME\lib\hparse.jar;;$HYADES_HOME\lib\logparsers.jar;$HYADES_HOME\lib\xalan.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, Hyades Data Collection Engine 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 delle preferenze di creazione profili, l'agente di registrazione log creato dall'utente è nel riquadro di sinistra

  6. Scegliere Applica.
  7. Fare clic su Esegui per collegarsi all'agente di registrazione log.
  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 dal log dell'applicazione vengono caricati nella vista Log.

 

Argomenti correlati
Panoramica dell'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