Registradores

Os loggers são utilizados pelos aplicativos e componentes de tempo de execução para capturar mensagens e eventos de rastreio.

Quando ocorrem situações significativas devido a uma alteração no estado, por exemplo, quando um servidor conclui a inicialização ou devido à detecção de um problema potencial, como um tempo limite aguardando um recurso, uma mensagem é gravada nos registros. Os eventos de rastreio são registrados nos cenários de depuração, em que um desenvolvedor precisa de uma visualização clara do que está ocorrendo em cada componente para entender o que pode estar errado. Os eventos registrados, normalmente, são os únicos eventos disponíveis quando um problema é detectado e são utilizados durante a recuperação e a resolução de problemas.

Os loggers são estruturados em uma hierarquia. Cada logger pode ter zero ou mais filhos.

Os loggers podem ser associados a um pacote de recursos. Se especificado, o pacote de recursos é utilizado pelo registrador para localizar mensagens registradas nele. Se o pacote de recursos não for especificado, um registrador utilizará o mesmo pacote de recursos que seu pai.

Você pode configurar registradores com um nível. Se especificado, o nível será comparado pelo registrador com os eventos de entrada. Os eventos menos graves que o nível configurado para o registrador são ignorados pelo registrador. Se o nível não for especificado, um registrador assumirá o nível utilizado por seu pai. O nível padrão para os loggers é Level.INFO.

Os registradores podem ter zero ou mais manipuladores anexados. Se fornecidos, todos os eventos registrados no registrador serão transmitidos aos manipuladores anexados. As rotinas de tratamento gravam eventos nos destinos de saída, como arquivos de log ou sockets de rede. Quando um registrador conclui a transmissão de um evento registrado para todos os manipuladores anexados a ele, o registrador transmite o evento aos manipuladores anexados aos pais dele. Esse processo parará se um registrador pai estiver configurado para não utilizar seus manipuladores pai. Os manipuladores no WebSphere Application Server são conectados ao criador de logs raiz. Configure a propriedade do registrador useParentHandlers como false para impedir que o registrador grave eventos nos manipuladores mais altos na hierarquia.

Os registradores podem ter um filtro. Se fornecido, o filtro é chamado para cada evento de entrada, para informar ao logger se deve ignora-lo ou não.

Os aplicativos interagem diretamente com loggers para registrar eventos. Para obter ou criar um logger, é feita uma chamada ao método Logger.getLogger com um nome para o logger. Geralmente, o nome do logger é o nome de classe completo do pacote ou o nome do pacote pelo qual o logger é utilizado. O espaço de nomes hierárquico do logger é criado automaticamente, utilizando os pontos no nome do logger. Por exemplo, o registrador com.ibm.websphere.ras possui um registrador pai com.ibm.websphere, que possui um pai com.ibm. O pai no topo da hierarquia é chamado de registrador raiz. Esse logger raiz é criado durante a inicialização. O registrador raiz é o pai do registrador com.

Os loggers são estruturados em uma hierarquia. Todo registrador, exceto o registrador raiz, possui um pai. Cada logger também pode ter 0 ou mais filhos. Um logger herda rotinas de tratamento do log, nomes de pacotes de recursos e configurações de filtragem de eventos do pai na hierarquia. A hierarquia do logger é gerenciada pela função LogManager.

Os loggers criam registros de log. Um registro de log é o objeto contêiner para os dados de um evento. Esse objeto é utilizado por filtros, rotinas de tratamento e formatadores na infraestrutura de log.

o logger fornece vários conjuntos de métodos para geração de mensagens de log. Alguns métodos de log precisam de apenas um nível e informações suficientes para construir uma mensagem. Outros métodos logp (preciso ao registro) mais complexos suportam o responsável pela chamada na transmissão dos atributos de nome de classe e nome de método, além das informações de nível e mensagem. Os métodos logrb (registro com pacote de recursos) incluem o recurso para especificar um pacote de recursos, bem como o nível, as informações de mensagem, o nome de classe e o nome de método. Utilizando métodos como severe, warning, fine, finer e finest, é possível registrar uma mensagem em um nível particular. Para obter informações adicionais sobre registro e como utilizá-lo em seus aplicativos, leia Usando a Criação de Logs do Java em um Aplicativo. Para obter uma lista completa de métodos, consulte a documentação java.util.logging em http://docs.oracle.com/javase/1.4.2/docs/api/index.html.


Ícone que indica o tipo de tópico Tópico de Conceito



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ctrb_loggers
Nome do arquivo: ctrb_loggers.html