Configurando o Registro
Um aspecto importante de qualquer aplicativo do servidor é o registro. O Agent
Controller fornece relatórios de registro e de depuração. Isso é
realizado por meio do uso de um único arquivo de registro, servicelog.log, que é, por
padrão, colocado no diretório config onde o Agent Controller está instalado.
É possível configurar o registro
Alterando o Diretório de Registro Padrão
Em determinadas situações, será necessário alterar o diretório de registro
padrão. Por exemplo, isso seria necessário em sistemas que possuem o Agent Controller instalado
em um sistema de arquivos somente leitura.
Para alterar o diretório de registro padrão, siga estas etapas:
- Localize o arquivo de configuração serviceconfig.xml. Consulte
a tarefa relacionada.
- Abra-o em um editor e procure o elemento <Logging>.
- Especifique o novo diretório de registro como o valor do atributo
directory desse elemento.
Modificando Filtros de Registro
É possível especificar que apenas mensagens de um
nível de registro especificado ou superior sejam registradas no arquivo pelo uso de um
filtro de registro simples. Os vários
níveis de registro são especificados a seguir:
- GRAVE: Registra apenas mensagens de erro não recuperáveis.
- CRÍTICA: (padrão) Inclui as mensagens acima, além daquelas que indicam
interrupção das operações normais por motivo de erro.
- AVISO: Inclui as mensagens acima, além daquelas sobre eventos inesperados que
não devem interferir na continuidade da operação.
- INFORMATIVA: Inclui as mensagens acima, além daquelas sobre eventos normais que
podem interessar ao usuário.
- DEPURAÇÃO: Inclui as mensagens acima, além daquelas referentes ao fluxo detalhado de
operações internas utilizadas para resolução de problemas.
Para modificar os filtros de registro, siga estas etapas:
- No arquivo serviceconfig.xml, localize o elemento <Logging>.
- Altere o valor de seu atributo level para um dos
níveis de registro indicados, de acordo com os requisitos.
Alterando o Formato das Mensagens Registradas
É possível especificar o formato da mensagem registrada como
texto simples ou formatado por CBE. As especificações de formato são:
- CBE:
(padrão) As mensagens serão registradas utilizando o formato Common Base Event.
Estão incluídas informações detalhadas sobre o contexto e a origem de cada
mensagem. Essas mensagens são lidas com maior facilidade ao usar um utilitário
de leitura de registro CBE.
- Simples: A mensagem será registrada em texto simples.
Para modificar o formato do registro, siga estas etapas:
- No arquivo serviceconfig.xml, localize o elemento <Logging>.
- Altere o valor de seu atributo de formato para um dos
indicados acima, de acordo com os requisitos.
Tarefas Relacionadas
Localizando os Arquivos de Configuração
Administrando o Agent Controller