Configurando um Adaptador para Monitoração de Aplicativo Ativo

O Adaptador de Log Genérico fornece uma classe de emissor de saída que permite que os objetos Common Base Event gerados por seu adaptador sejam enviados para um agente de log. O Analisador de Log e Rastreio pode anexar ao agente de log para monitorar e analisar o log de aplicativo em tempo real.

Pré-requisitos:

Siga estas etapas para configurar o adaptador para monitoração.

Atualizar o Componente Emissor de Saída

Nota: Quando um novo arquivo de configuração do adaptador é criado, ele é configurado para utilizar, por padrão, a classe CBELogOutputter. Se você não alterou essa configuração, poderá ignorar este procedimento.

O componente emissor de saída no arquivo de configuração do adaptador precisa ser atualizado para utilizar a classe CBELogOutputter, que grava objetos Common Base Event em um agente de log. Você pode atualizar o Componente Emissor de Saída existente ou incluir um novo componente Emissor de Saída.

Para incluir um novo componente emissor de saída:

  1. Para editar o arquivo de configuração do adaptador, selecione o arquivo de configuração na área de janela Navegador. Clique com o botão direito do mouse e selecione Abrir com > Editor de Configuração de Adaptador. O arquivo é aberto no editor.
  2. Na janela Editor de Configuração de Adaptador, expanda o nó Adaptador > Configuração > Instância do Contexto.
  3. Clique com o botão direito do mouse na Instância do Contexto e selecione Incluir > Emissor de Saída. Um novo emissor de saída é criado na Instância do Contexto.
  4. No campo Tipo de Emissor de Saída, selecione LoggingAgentOutputter.
  5. Clique na propriedade agentName. Os detalhes da propriedade são mostrados na área de janela à direita.
  6. Atualize o valor da propriedade com o nome do agente de log desejado. Este é o nome que você verá no Analisador de Log e Rastreio como o Agente de Log a ser monitorado.
  7. Se você desejar que o emissor de saída aguarde antes de registrar informações na classe CBELogOutputter, inclua uma propriedade denominada waitUntilLoggingTime e defina o valor da propriedade para o tempo em milissegundos. Para incluir a propriedade, clique com o botão direito do mouse no Emissor de Saída recém-criado e selecione Incluir > Propriedade. Uma nova propriedade é criada sob o novo nó Emissor de Saída.
  8. Para ativar a classe CBELogOutputter, é necessário criar o componente Emissor de Saída associado nos Contextos Implementação de Contexto Básico. Abra Contextos > Contexto Implementação Básica de Contexto.
  9. Clique com o botão direito do mouse em Contexto Implementação Básica de Contexto e selecione Incluir > Componente. Um novo componente é incluído no contexto.
  10. Configure o novo componente com os valores a seguir:
    Nome: Nome do emissor de saída no contexto
    Descrição: Descrição do que esse emissor de saída faz
    Classe Executável: org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter
    Nível de Log: O nível de log que o emissor de saída deve utilizar. Um valor 0 significa que o emissor de saída não registrará mensagens. Um valor 99 significa que o emissor de saída registrará mensagens de todas as gravidades. O valor recomendado é 60, o que significa que apenas mensagens de erros Fatais são registradas
    Função: Emissor de Saída
    ID Exclusivo: Deve apontar para o emissor de saída definido na Instância do Contexto na etapa 2. Utilize o botão Procurar para selecionar o ID correto.
  11. Salve as alterações do arquivo de configuração do adaptador.

Atualizar a Instância do Contexto

Se você desejar que o analisador de log monitore o arquivo de log continuamente, será necessário atualizar as propriedades de instância do contexto do arquivo de configuração do adaptador para operação contínua.

  1. Para editar o arquivo de configuração do adaptador, selecione o arquivo de configuração do adaptador na perspectiva Navegador. Clique com o botão direito do mouse e selecione Abrir com > Editor de Configuração de Adaptador. O arquivo é aberto no editor.
  2. Na janela do editor, selecione Adaptador > Configuração > Instância do Contexto. Os detalhes da Instância do Contexto são exibidos na área de janela à direita.
  3. Selecione a caixa de opções Operação Contínua.
  4. Configure os campos Tempo Máximo Inativo e Intervalo de Pausa, conforme necessário.
  5. Salve as alterações do arquivo de configuração do adaptador.

Ativar o Processo Java para Executar o Adaptador

O adaptador de log criado pode ser executado externamente a partir de um arquivo em batch no ambiente Windows ou em um script de shell em ambientes não-Windows. A seguir estão arquivos de amostra que podem ser utilizados para ativar o processo Java que executará o adaptador de log.
Nota: Para executar o Adaptador de Log Genérico em um sistema, o Hyades deve ser instalado neste sistema.

Arquivo em batch do Windows:

@rem USO:  runregex
@rem Altere as linhas a seguir para apontar para o diretório no qual você descompactou o arquivo zip de tempo de execução
@rem e o diretório no qual o adaptador de log reside
SET HYADES_HOME=d:\hyades\eclipse\plugins
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%\org.eclipse.hyades.logging.adapter\hgla.jar;%HYADES_HOME%\org.eclipse.hyades.execution.remote\hexr.jar;%HYADES_HOME%\org.eclipse.hyades.logging.core\hlevents.jar;%HYADES_HOME%\org.eclipse.hyades.logging.core\hlcore.jar;%HYADES_HOME%\org.apache.jakarta_oro\jakarta-oro.jar;%HYADES_HOME%\org.apache.xerces\xercesImpl.jar;%HYADES_HOME%\org.apache.xerces\xmlParserAPIs.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"
POPD
Arquivo em batch não-Windows:
#!/bin/sh
# USO:  runregex_example.sh
# Altere a linha a seguir para apontar para o diretório no qual você descompactou o arquivo zip do tempo de execução
HYADES_HOME=/home/eclipse/GenericLogAdapter
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%\org.eclipse.hyades.logging.adapter\hgla.jar;$HYADES_HOME%\org.eclipse.hyades.execution.remote\hexr.jar;$HYADES_HOME%\org.eclipse.hyades.logging.core\hlevents.jar;$HYADES_HOME%\org.eclipse.hyades.logging.core\hlcore.jar;$HYADES_HOME%\org.apache.jakarta_oro\jakarta-oro.jar;$HYADES_HOME%\org.apache.xerces\xercesImpl.jar;$HYADES_HOME%\org.apache.xerces\xmlParserAPIs.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"

cd $CUR_DIR
Configure o arquivo, conforme necessário, para ativar o processo Java que executará o adaptador.

Monitorando o Log de Aplicativo Ativo

Agora você está pronto para monitorar o log de aplicativo ativo.

  1. Assegure-se de que o log esteja ativado nas preferências.
    1. Na barra de ferramentas principal, selecione Janela > Preferências. O assistente Preferências é aberto.
    2. Selecione Gerenciamento de Perfis e Log na área de janela à esquerda. As preferências de Gerenciamento de Perfis e Log são carregadas na área de janela à direita.
    3. Selecione Ativar Log sob as opções de Gerenciamento de Perfis e Log.

      A caixa de opções Ativar Log é selecionada na área de janela de preferências para Gerenciamento de Perfis e Log

    4. Selecione OK para aplicar as alterações.
  2. Na perspectiva Gerenciamento de Perfis e Log, clique no ícone Gerenciamento de Perfis Ícone da ferramenta de gerenciamento de perfis na barra de ferramentas e selecione Perfil. O assistente Perfil é aberto.
  3. Selecione Anexar - Processo Java e clique no botão Novo na parte inferior da lista. Uma nova configuração do processo Java é criada.
  4. Clique na guia Hosts e selecione o host no qual o log de aplicativo reside.
    Nota: Para monitorar um log de aplicativo ativo, o Hyades Data Collection Engine deve estar em execução no mesmo sistema que o aplicativo.
  5. Clique na guia Agentes e utilize as teclas de seta para selecionar o agente de log que você configurou.

    No assistente de preferências de gerenciamento de perfis, o agente de log criado pelo usuário está na área de janela à esquerda

  6. Clique em Aplicar.
  7. Clique em Executar para anexar ao agente de Log.
  8. Na perspectiva Gerenciamento de Perfis e Log na visualização Monitor de Gerenciamento de Perfis, selecione o agente de log.
  9. Clique com o botão direito do mouse no agente e selecione Iniciar Monitoração.
  10. Clique com o botão direito do mouse no agente e selecione Abrir com > Visualização de Log. Os eventos de log do log de aplicativo são carregados na visualização Log.

 

Conceitos Relacionados
Visão Geral do Adaptador de Log Genérico Hyades
Especificação do Formato Common Base Event

Tarefas Relacionadas
Criando um Analisador de Log

Referências Relacionadas
Estrutura do Arquivo de Configuração do Adaptador
Editor de Configuração de Adaptador
Gramática de Expressão Comum