Log Java

A criação de log Java™ é o kit de ferramentas de criação de log fornecido pelo java.util.logging pacote. O log Java fornece uma API de log padrão para seus aplicativos.

O log de mensagens (mensagens) e o rastreio de diagnóstico (rastreio) são conceptualmente semelhantes, mas têm diferenças importantes. É importante para os desenvolvedores de aplicativos compreender essas diferenças para utilizar essas ferramentas de forma apropriada. São fornecidas as definições operacionais de mensagens e rastreio a seguir.

Mensagem
Uma entrada de mensagem é um registro informativo que é destinado a ser visualizado por usuários finais, administradores de sistemas e pessoal de suporte. O texto da mensagem deve ser claro, conciso e interpretável por um usuário final. As mensagens geralmente são localizadas e exibidas no idioma nacional do usuário final. Embora o destino e o tempo de duração das mensagens possam ser configurados, ative algum nível de registro de mensagens na operação normal do sistema. Utilize o registro de mensagens criteriosamente devido a considerações de desempenho e ao tamanho do repositório de mensagens.
Rastreamento
Uma entrada de rastreio é um registro de informação que é destinado a ser utilizado por engenheiros de serviço ou desenvolvedores. Como tal, um registro de rastreio pode ser consideravelmente mais complexo, verboso e detalhado que uma entrada de mensagem. O suporte a localização em geral não é utilizado para entradas de rastreio. As entradas de rastreio podem ser bastante inescrutáveis, compreensíveis somente para o desenvolvedor ou pessoal de serviço apropriados. Supõe-se que as entradas de rastreio não são gravadas durante a operação normal de tempo de execução, mas podem ser ativadas conforme necessário para reunir informações de diagnóstico.

O servidor de aplicativos redireciona os fluxos do sistema na inicialização do servidor. Não há como permitir que o aplicativo envie o registro para o console porque os fluxos do sistema não podem ser obtidos pelo aplicativo. Se você deseja utilizar o console para monitorar o aplicativo sem utilizar o manipulador de console, é possível monitorar o arquivo SystemOut.log ou monitorar um arquivo criado por outro manipulador de arquivos.

Observação: O servidor de aplicativos usa a criação de log Java internamente e, portanto, determinadas restrições se aplicam ao uso de fluxos do sistema com essa API de criação de log por aplicativos. Durante a inicialização do servidor, a saída padrão e os fluxos de erros são substituídos pelos fluxos especiais que são gravados para a infra-estrutura de registro, para incluir a saída dos fluxos do sistema nos arquivos de registro. Devido a isso, os aplicativos não podem usar java.util.logging.ConsoleHandler, ou qualquer manipulador que grave nos fluxos SystemErr.log ou System.out, anexados ao criador de logs raiz. Se o usuário anexar o manipulador ao registrador raiz, será criado um loop infinito dentro da infra-estrutura de log, conduzindo à sobrecarga da pilha e ao travamento do servidor.

Se for necessário o uso de um manipulador gravado nos fluxos do sistema, anexe-o a um registrador não-raiz de modo que não publique os registros de log para os manipuladores pai. Os dados gravados nos fluxos do sistema são então formatados e gravados para o arquivo de registro de fluxo do sistema correspondente. Para monitorar o que está sendo gravado nos fluxos do sistema, os arquivos de registro configurados (SystemOut.log e SystemErr.log, por padrão) podem ser monitorados.

Observação: Este tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como alternativa recomendada, é possível configurar o servidor para usar a infraestrutura de log e rastreio High Performance Extensible Logging (HPEL) em vez de usarSystemOut.log ,SystemErr.log ,trace.log , eactivity.log arquivos distribuídos e IBM® i sistemas. Você também pode usar HPEL em conjunto com seu software nativo z/OS® instalações de registro. Se estiver usando o HPEL, é possível acessar todas as suas informações de rastreamento e log usando a ferramenta de linha de comandos LogViewer no diretório bin do perfil do servidor. Veja o informações sobre como usar HPEL para solucionar problemas de aplicativos para obter mais informações sobre o uso do HPEL.