Configurar o registo
Um importante aspecto de qualquer aplicação do servidor é o registo. O Controlador de Agentes fornece o registo para efeitos de depuração e registo. Isto faz-se através da utilização de um ficheiro de registo único, servicelog.log, que é, por predefinição, colocado no directório config onde está instalado o Controlador de Agentes. Pode configurar o registo:
Alterar o directório de registo predefinido
Em determinadas situações, será necessário alterar o directório de registo predefinido. Por exemplo, será necessário fazê-lo em sistemas que têm o Controlador de Agentes instalado num sistema de ficheiros só de leitura.
Para alterar o directório de registo predefinido, siga estes passos:
- Localizar o ficheiro de configuração serviceconfig.xml. Consulte a tarefa relacionada.
- Abrir o ficheiro num editor e procurar o elemento <Logging>.
- Especificar p novo directório de registo como o valor para o atributo
directory deste elemento.
Modificar os filtros de registo
Pode especificar que apenas serão registadas as mensagens de um nível de registo especificado ou superiores a esse nível no ficheiro, utilizando um filtro de registo simples. Os vários níveis de registo encontram-se especificados a seguir:
- SEVERE: Regista apenas mensagens de erros não recuperáveis.
- CRITICAL: (predefinição) Inclui os níveis acima, acrescido de mensagens que indicam que
as operações normais foram interrompidas devido a um erro.
- WARNING: Inclui os níveis acima, acrescido de eventos inesperados que não devem
interferir com a operação continuada.
- INFORMATION: Inclui os níveis acima, acrescido de mensagens sobre eventos normais que
podem ser de interesse para o utilizador.
- DEBUG: Inclui os níveis acima, acrescido de mensagens sobre o fluxo detalhado das
operações utilizadas para resolução de problemas.
Para modificar os filtros de registo, siga estes passos:
- No ficheiro serviceconfig.xml, localize o elemento <Logging>.
- Alterar o valor do respectivo atributo level para um dos níveis de registo acima indicados, de acordo com os seus requisitos.
Alterar o formato das mensagens de registo
Pode especificar o formato das mensagens que são registadas para serem formatadas como texto simples ou CBE. As especificações de formato são:
- CBE:
(predefinição) As mensagens serão registadas utilizando o formato Evento de Base Comum.
Esta opção inclui informações detalhadas sobre o contexto e a origem de cada mensagem. Estas mensagens são lidas de forma mais fácil quando é utilizado um utilitário de leitura de registo CBE.
- Simples: A mensagem será registada em texto simples.
Para modificar o formato de registo, execute os passos seguintes:
- No ficheiro serviceconfig.xml, localize o elemento <Logging>.
- Altere o valor do respectivo atributo de formato para um dos formatos de registo acima indicados, de acordo com os seus requisitos.
Tarefas relacionadas
Localizar os ficheiros de configuração
Administrar o Controlador de Agentes