Trabalhar com o exemplo de Registo Log4J

Este exemplo demonstra o suporte TPTP para o registo de Eventos Base Comum utilizando APIs de registo Apache Log4J. Os utilizadores efectuam registos de Eventos Base Comuns na consola e num Agente de Registo.

Crie o exemplo através de Ficheiro > Novo > Exemplo... > Exemplo de Registo Apache Log4J, caso ainda não o tenha feito.

O conteúdo do exemplo inclui o código de origem Java, as dependências e o ficheiro de configuração necessários para registar Eventos Base Comuns num registador Apache Log4J.

É necessário o Apache Log4J 1.2.8 (incluído) ou superior para compilar e executar este exemplo.

Pressupostos

  1. Ao lançar esta aplicação a partir da Perspectiva Perfilar e Registar da área de trabalho, a configuração de lançamento da aplicação ou a aplicação ou serviço de caminho da classe do Controlador de Agentes contém o Apache Log4J 1.2.8 ou superior no caminho da classe.
  2. A variável de ambiente 'log4j.configuration' é definida para o caminho absoluto e nome do ficheiro de configuração (HyadesLoggingLog4JSample.xml) de registo do Apache Log4J, sob a forma de um URL. Por exemplo, file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml.
  3. A DTD do Apache Log4J (Document Type Definition - Definição de Tipo de Documento) definida em <Apache Log4J logging JAR>/org/apache/log4j/xml/log4j.dtd é copiada para o directório <workspace>/HyadesLoggingLog4JProject/cfg/ para ser utilizada pelo fichwieo de configuração de registo Apache Log4J (file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml).
Para executar este exemplo e anexar automaticamente ao Agente de Registo, siga estes passos:
  1. Confirmar que todos os erros de compilação foram corrigidos.
  2. Se estiver a utilizar uma instalação autónoma do Controlador de Agentes (AC - Agent Controler), certifique-se que foi iniciada (não é necessário). Em alternativa, pode utilizar uma ligação directa que consiste num número limitado de serviços do AC incluídos na área de trabalho.
  3. Abrir a perspectiva Perfilar e Registar (Janela > Abrir Perspectiva > Outra... > Perfilar e Registar).
  4. Execute a classe exemplo a partir da Perspectiva Perfilar e Registar (Executar > Perfil... > Criar uma nova configuração de tipo de Aplicação Java > Definir o nome do projecto para o nome do projecto de exemplo > Definir a classe Principal para 'HyadesLoggingLog4JSample' > Mude para o separador Argumentos e especifique a seguinte propriedade JVM: -Dlog4j.configuration="file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" >Mude para o separador Supervisor > Desmarcar " Perfilamento de Java " e seleccione "Descobridor de Agentes " > Perfil).
  5. Após alguns segundos, o agente de registo deverá ser detectado e anexado automaticamente. Seleccione o agente de registo identificado e abra a vista Registo na Perspectiva Perfilar e Registar para visualizar as entradas de registo de Evento Base Comum registadas (Janela > Mostrar Vista > Outra... > Perfilar e Registar > Vista Registo > OK).
  6. Actualizar a vista Registo na perspectiva Perfilar e Registar (<Fazer clique com o botão direito do rato sobre o Agente de Registo 'HyadesLoggingLog4JSample' > > Actualizar).

Em alternativa, para executar este exemplo e anexar manualmente ao Agente de Registo, siga estes passos:

  1. Confirmar que todos os erros de compilação foram corrigidos.
  2. Se estiver a utilizar uma instalação autónoma do Controlador de Agentes (AC - Agent Controler), certifique-se que foi iniciada (não é necessário). Em alternativa, pode utilizar uma ligação directa que consiste num número limitado de serviços do AC incluídos na área de trabalho.
  3. Execute a classe exemplo a partir da Perspectiva de Java (Run > Executar... > Criar uma nova configuração de tipo de Aplicação Java > Classe Principal > Pesquisar... > HyadesLoggingLog4JSample > OK >Mude para o separador Argumentos e especifique a seguinte propriedade JVM: -Dlog4j.configuration="file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" > Executar).
  4. Abrir a perspectiva Perfilar e Registar (Janela > Abrir Perspectiva > Outra... > Perfilar e Registar).
  5. Anexar ao Agente de Registo 'HyadesLoggingLog4JSample' na Perspectiva Perfilar e Registar (Executar > Perfil... > Anexar - Processo Java > Novo > Separador Sistemas Centrais > Utilize 'Ligação Directa Local' se não estiver a utilizar a instalação autónoma do Controlador de Agentes. Caso contrário, utilize um nome do sistema central válido e uma porta. >Separador Agentes > Faça duplo clique no agente HyadesLoggingLog4JSample > Seleccione o separador Destino > Projecto de Perfilamento > Procurar... > 'HyadesLoggingLog4JProject' > OK > Perfil).
  6. Iniciar supervisão do Agente de Registo 'HyadesLoggingLog4JSample' (<Fazer clique com o botão direito do rato sobre o Agente de Registo 'HyadesLoggingLog4JSample'> > Iniciar Supervisão).
  7. Abrir a vista Registo na perspectiva Perfilar e Registar para visualizar as entradas de registo de Evento Base Comum registados (Janela > Mostrar Vista > Outra... > Perfilar e Registar > Vista Registo > OK).
  8. Actualizar a vista Registo na perspectiva Perfilar e Registar (<Fazer clique com o botão direito do rato sobre o Agente de Registo 'HyadesLoggingLog4JSample' > > Actualizar).