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
- 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.
- 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.
- 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:
- Confirmar que todos os erros de compilação foram corrigidos.
- 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.
- Abrir a perspectiva Perfilar e Registar (Janela > Abrir Perspectiva > Outra... > Perfilar e Registar).
-
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).
- 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).
- 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:
- Confirmar que todos os erros de compilação foram corrigidos.
- 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.
-
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).
- Abrir a perspectiva Perfilar e Registar (Janela > Abrir Perspectiva > Outra... > Perfilar e Registar).
- 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).
- 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).
- 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).
- 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).
(C) Copyright IBM Corporation 2000, 2006.