Utilize este tópico para configurar e gerenciar configurações no nível do registro.
Para visualizar esta página do console administrativo, clique em
Utilizando níveis de controle, é possível controlar quais eventos são processados pela criação de log Java. Quando você altera o nível de um logger, a alteração é propagada para os filhos do logger.
- Desativar a Criação de Log e o Rastreio de Dados Potencialmente Sensíveis
- O servidor de aplicativos possui uma lista de criadores de log que, quando ativados, são conhecidos por gravarem informações potencialmente sensíveis no log e no rastreio. Por exemplo, a ativação de determinados criadores de log relacionados a HTTP no nível FINEST pode resultar no armazenamento de informações especificadas pelo usuário, provenientes de solicitações HTTP, nos arquivos de rastreio. Se você desejar que o servidor evite a ativação desses criadores de log em níveis que são usados para informações potencialmente sensíveis, marque a caixa de seleção Desativar criação de log e rastreio de dados potencialmente sensíveis. Quando o servidor é iniciado, ou quando a especificação de nível de detalhe de log é modificada no tempo de execução, o servidor comparará a lista de criadores de log e de níveis determinados na especificação de nível de detalhe de log com a lista de criadores de logs e de níveis na lista de criadores de logs sensíveis e atualizará a especificação do nível de detalhes de log conforme necessário.
- Alterar Níveis de Detalhes do Log
Digite um nível de detalhe do registro que especifica os componentes, os pacotes ou os grupos para rastreio. A cadeia de nível de detalhe do registro deve corresponder à gramática específica descrita neste tópico. É possível digitar a cadeia de nível de detalhe do registro diretamente ou gerá-la utilizando a interface de rastreio gráfica.
Se você selecionar a guia Configuração e expandir Componentes e Grupos, uma lista estática de componentes, pacotes e grupos bem conhecidos será exibida. Essa lista pode não ser completa.
Se você selecionar a guia Tempo de Execução e expandir Componentes e Grupos, a lista de componentes, pacotes e grupos será exibida com todos os componentes que estiverem registrados no servidor de aplicativos em execução e na lista estática.
O formato da especificação do nível de detalhe do registro é:<component> = <level>
em que <component> é o componente para o qual o nível de detalhe de log é configurado e <level> é um dos níveis do criador de logs válidos (off, fatal, severe, warning, audit, info, config, detail, fine, finer, finest, all). Separe várias especificações de nível de detalhe do log com dois pontos (:).
Evitar Problemas: As cláusulas incluídas
em uma especificação de rastreio são lidas na ordem em que aparecem na
sequência. Portanto, se diversas variações da cláusula *=info forem
incluídas em uma especificação de rastreio, o último valor especificado será o valor que determina o nível de rastreio que o sistema registra. Se você
especificar *=info como a última cláusula, o rastreio
ocorrerá no nível da informação, independentemente de outras cláusulas que estão
especificadas na sequência de rastreio. Por exemplo, se você tiver especificado a sequência
de rastreio a seguir:
será equivalente a simplesmente especificar:*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all
Porque a cláusula final substitui todas as cláusulas que foram especificadas antes dela na sequência.gotcha*=allOs componentes correspondem a pacotes e classes Java ou a coletas de pacotes Java. Utilize um asterisco (*) como curinga para indicar componentes que incluem todas as classes de todos os pacotes contidos pelo componente especificado. Por exemplo:- *
- Especifica todo o código rastreável em execução no servidor de aplicativos, incluindo o código do sistema do produto e o código do cliente.
- com.ibm.ws.*
- Especifica todas as classes com o nome de pacote iniciado por com.ibm.ws.
- com.ibm.ws.classloader.JarClassLoader
- Especifica somente a classe JarClassLoader.
Poderá ocorrer um erro ao configurar uma especificação de nível de detalhe do log no console administrativo se as seleções forem feitas a partir das listas de Grupos e de Componentes. Em alguns casos, a seleção feita em uma lista é perdida quando uma seleção é incluída da outra lista. Para solucionar esse problema, digite a especificação de nível de detalhe do registro diretamente no campo de entrada do nível de detalhe do registro.
Evitar Problemas: Os valores do nível de criação de log fazem distinção entre maiúsculas e minúsculas e começam com uma letra minúscula.gotcha| Nível de Criação de Log Versão 6 e Posterior | Conteúdo / Significância |
|---|---|
| off | O registro está desligado. |
| fatal | A tarefa não pode continuar e o componente, o aplicativo e o servidor não podem funcionar. |
| severe | A tarefa não pode continuar, mas o componente, o aplicativo e o servidor ainda podem funcionar. Esse nível também pode indicar um erro irrecuperável iminente. |
| warning | Erro potencial ou erro iminente. Este nível também pode indicar um defeito progressivo (por exemplo, a possível perda de recursos). |
| audit | Evento significativo afetando o estado do servidor ou os recursos |
| info | Informações gerais esboçando o progresso da tarefa global |
| config | Alteração na configuração ou status |
| detail | Informações gerais detalhando o progresso da subtarefa |
| fine | Informações de rastreio - Rastreio geral + valores de entrada, saída e retorno do método |
| finer | Informações de rastreio - Rastreio detalhado |
| finest | Informações de rastreio - Um rastreio mais detalhado que inclui todos os detalhes necessários para depurar problemas |
| all | Todos os eventos são registrados. Se você criar níveis customizados, Todos inclui esses níveis, e pode fornecer um rastreio mais detalhado do que mais fino. |
[Criação de Log do Modo Básico] As informações de rastreio, que são eventos dos níveis Fine, Finer e Finest, só podem ser registradas no log de rastreio. Portanto, se o rastreio de diagnóstico não for ativado, configurar o nível de detalhes do registro para Fine, Finer ou Finest não terá efeito nos dados registrados.
- Correlação
- Especifica as configurações de correlação que deseja ativar. Marque a
caixa de seleção Ativar Correlação de Log e Rastreio para ativar
a correlação para o servidor de aplicativos. Desmarque a
caixa de seleção Ativar Correlação de Log e Rastreio para desativar
a correlação para o servidor de aplicativos. Selecione Incluir IDs de solicitação nos registros de log e rastreio, Incluir IDs de solicitação nos registros de log e rastreio e nos registros de log de correlação ou Incluir IDs de solicitação nos registros de log e rastreio, criar registros de log de correlação e tomar capturas instantâneas de dados, da maneira apropriada.
Boas Práticas: Ative o XCT para incluir IDs da
solicitação em arquivos de log e rastreio quando desejar ver quais entradas
de log e rastreio, em todos os encadeamentos e processos do servidor de aplicativos,
estão relacionadas à mesma solicitação. Os IDs da solicitação são registrados apenas ao usar
o modo de log e rastreio HPEL e podem ser vistos ou usados para filtragem usando o
comando logViewer. bprac Boas Práticas: Ative o XCT para criar
registros de log de correlação quando você deseja registrar como as solicitações são
ramificadas entre encadeamentos e processos e veja informações extras sobre cada solicitação.
A ativação de XCT para criar registros de log de correlação pode ter um impacto no
desempenho significativo em seu sistema, portanto, é melhor adequado para ambientes de
teste e desenvolvimento.bprac Boas Práticas: Ative o XCT para capturar
capturas instantâneas de dados quando você deseja armazenar corpos inteiros de
solicitação e resposta no sistema de arquivos. A ativação de XCT para capturar capturas instantâneas de dados
pode ter um impacto no desempenho significativo em seu sistema, portanto, é
melhor adequado para ambientes de teste e desenvolvimento. O XCT captura capturas
instantâneas de dados para solicitações e respostas de mensagens manipuladas pelo SIBus.bprac Evitar Problemas: As capturas instantâneas de dados são capturadas e gravadas no diretório $SERVER_LOG_ROOT/snapdata.
O servidor de aplicativos não limpa automaticamente arquivos a partir
deste diretório. Será necessário excluir os arquivos deste diretório
periodicamente quando a captura da captura instantânea de dados está ativada. As capturas instantâneas de dados
armazenam conteúdo inteiro de solicitação e resposta e podem incluir informações
sigilosas. Esta opção pode não ser apropriada para uso em ambientes de
produção.gotcha
- Salvar Mudanças de Tempo de Execução Também para Configuração
- Especifica quais mudanças serão feitas ao estado dinâmico do servidor em execução e à configuração do servidor, que entram em vigor na próxima reinicialização. Se a caixa de seleção não estiver marcada, o servidor não copiará as definições para a configuração do servidor.