Definições de Diagnóstico do Serviço de Rastreio

Utilize esta página para rever e modificar as propriedades do serviço de rastreio de diagnóstico.

Para visualizar essa página, clique em Resolução de Problemas > Logs e Rastreio > servidor > Rastreio de diagnóstico.

Guia Configuração

Ativar Rastreio
Ativa o serviço de rastreio.

Se essa opção não for selecionada, as seguintes propriedades de configuração não serão transmitidas para o serviço de rastreio do servidor de aplicativos durante a inicialização do servidor.

Especificação de Rastreio
Especifica detalhes de rastreio.

Insira uma cadeia de rastreio que especifique os componentes, pacotes ou grupos a serem rastreados. A cadeia de rastreio deve estar de acordo com a gramática específica descrita abaixo. Você pode digitar a cadeia de rastreio diretamente, ou gerá-la utilizando a interface gráfica de rastreio. Clique em Modificar para iniciar a interface gráfica de rastreio.

Se você iniciar a interface gráfica de rastreio a partir da guia Configuração, será exibida uma lista de componentes, pacotes e grupos bem conhecidos. Essa lista pode não ser completa.

Se você iniciar a interface gráfica de rastreio a partir da guia Tempo de Execução, a lista de componentes, pacotes e grupos exibirá todos estes componentes atualmente registrados no servidor de execução.

O formato da especificação de rastreio é:

<componente> =
<tipo_de_rastreio>= enabled | disabled
em que: <componente> é o componente para o qual o rastreio será ativado ou desativado e <tipo_de_rastreio> é o tipo de rastreio a ser ativado ou desativado. Separe várias especificações de rastreio com dois-pontos (:).

Os componentes correspondem a pacotes e classes Java, ou a coleções de pacotes Java. Utilize * como um curinga para indicar componentes que incluem todas as classes em todos os pacotes contidos pelo componente especificado. Por exemplo:

*
Especifica todo o código que pode ser rastreado no servidor de aplicativos, incluindo o código do sistema WebSphere Application Server e o código do cliente.
com.ibm.ws.*
especifica todas as classes cujo nome de pacote inicia com com.ibm.ws.
com.ibm.ws.classloader.JarClassLoader
Especifica somente a classe JarClassLoader.

Para obter informações adicionais sobre a gramática da cadeia de rastreio, consulte o artigo Ativando Rastreio na navegação do centro de informações do WebSphere Application Server.

Nota: Pode ocorrer um erro ao definir uma especificação de rastreio a partir do console administrativo se as seleções forem feitas a partir das listas Grupos e Componentes. Em alguns casos, a seleção feita em uma lista não é perdida quando uma seleção é adicionada da outra lista. Para evitar esse problema, insira a especificação de rastreio desejada diretamente no campo de entrada Especificação de Rastreio.

Saída do Rastreio  
Especifica onde a saída de rastreio deve ser gravada.

A saída do rastreio pode ser gravada diretamente em um arquivo de saída ou armazenada na memória e gravada em um arquivo por pedido, utilizando o botão Dump na página de tempo de execução.

Buffer de Memória
Especifica que a saída de rastreio deve ser gravada em um buffer circular na memória. Se você selecionar esta opção, deverá especificar os seguintes parâmetros:
Tamanho Máximo do Buffer
Especifica o número de entradas, em números de mil, que podem ser armazenadas em cache no buffer. Quando este número é excedido, as entradas mais antigas são substituídas por novas entradas.
Nome do Arquivo de Dump
O nome do arquivo no qual o buffer de memória será gravado após o dump. Essa opção está disponível apenas na guia Tempo de Execução.

Arquivo
Especifica que a saída de rastreio deve ser gravada em um arquivo de log de auto-gerenciamento.

O arquivo de log de auto-gerenciamento grava mensagens no arquivo até que um critério de tamanho seja atingido. Quando o arquivo alcança o tamanho especificado, o registro é temporariamente suspenso e o arquivo de log é fechado e renomeado. O novo nome será baseado no nome original do arquivo, além de um qualificador de data e hora que indica quando ocorreu a renomeação. Após a conclusão da renomeação, um arquivo de log novo e vazio com o nome original será reaberto, e o registro será retomado. Nenhuma mensagem será perdida como resultado do rollover, embora uma única mensagem possa ser dividida nos dois arquivos.

Se você selecionar esta opção, deverá especificar os seguintes parâmetros:

Tamanho Máximo do Arquivo
Especifica o tamanho máximo, em megabytes, que o arquivo de saída pode alcançar.

Este atributo será válido somente se o atributo Tamanho do Arquivo estiver selecionado. Quando o arquivo alcança este tamanho, é executado rollover, conforme descrito acima.

Número Máximo de Arquivos Históricos
Especifica o número máximo de arquivos de rollover a serem mantidos.
Nome do Arquivo
Especifica o nome do arquivo no qual a saída de rastreio será gravada.

Formato da Saída do Rastreio  
Especifica o formato da saída de rastreio.

Você pode especificar um dos três níveis para as saída do rastreio:

Básica (Compatível)
Preserva somente as informações básicas de rastreio. Selecione esta opção para diminuir a quantidade de espaço tomada pela saída de rastreio.
Avançada
Preserva informações de rastreio mais específicas. Selecione esta opção para consultar informações detalhadas do rastreio para ser utilizada em resolução e determinação de problemas.
Analisador de Logs
Preserva as informações de rastreio em um formato compatível com a ferramenta Analisador de Log. Selecione esta opção se deseja utilizar a saída de rastreio como entrada para a ferramenta do Analisador de Logs.

Guia Tempo de Execução  
Especifica o formato da saída de rastreio.
Salvar Rastreio
Salva as alterações feitas na guia tempo de execução na configuração do rastreio.

Selecione essa caixa para copiar alterações de rastreio de tempo de execução também para as definições de configuração de rastreio. Salvar estas alterações na configuração do rastreio fará com que as alterações persistam mesmo se o aplicativo for iniciado novamente.

Especificação de Rastreio
Especifica detalhes de rastreio.

Insira uma cadeia de rastreio que especifique os componentes, pacotes ou grupos a serem rastreados. A cadeia de rastreio deve estar de acordo com a gramática específica descrita abaixo. Você pode digitar a cadeia de rastreio diretamente, ou gerá-la utilizando a interface gráfica de rastreio. Clique em Modificar para iniciar a interface gráfica de rastreio.

Se você iniciar a interface gráfica de rastreio a partir da guia Configuração, será exibida uma lista de componentes, pacotes e grupos bem conhecidos. Essa lista pode não ser completa.

O formato da especificação de rastreio é:

<componente>
= <tipos_de_rastreio> = enabled | disabled

em que <componente> é o componente para o qual o rastreio será ativado ou desativado e <tipo_de_rastreio> é o tipo de rastreio a ser ativado ou desativado. Separe várias especificações de rastreio com dois-pontos (:).

Os componentes correspondem a pacotes e classes Java, ou a coleções de pacotes Java. Utilize * como um curinga para indicar componentes que incluem todas as classes em todos os pacotes contidos pelo componente especificado. Por exemplo:

*
Especifica todo o código que pode ser rastreado no servidor de aplicativos, incluindo o código do sistema WebSphere Application Server e o código do cliente.
com.ibm.ws.*
especifica todas as classes cujo nome de pacote inicia com com.ibm.ws.
com.ibm.ws.classloader.JarClassLoader
Especifica somente a classe JarClassLoader.

Para obter informações adicionais sobre a gramática da cadeia de rastreio, consulte o artigo Ativando Rastreio na navegação do centro de informações do WebSphere Application Server.

Nota: Pode ocorrer um erro ao definir uma especificação de rastreio a partir do console administrativo se as seleções forem feitas a partir das listas Grupos e Componentes. Em alguns casos, a seleção feita em uma lista não é perdida quando uma seleção é adicionada da outra lista. Para evitar esse problema, insira a especificação de rastreio desejada diretamente no campo de entrada Especificação de Rastreio.

Saída do Rastreio  
Especifica onde a saída de rastreio deve ser gravada.

Especifica onde a saída de rastreio deve ser gravada.

A saída de rastreio pode ser gravada diretamente em um arquivo de saída, ou armazenada na memória e gravada em um arquivo por pedido, utilizando o botão Dump encontrado na página de tempo de execução.

Buffer de Memória
Especifica que a saída de rastreio deve ser gravada em um buffer circular na memória. Se você selecionar esta opção, deverá especificar os seguintes parâmetros:
Tamanho Máximo do Buffer
Especifica o número de entradas, em números de mil, que podem ser armazenadas em cache no buffer. Quando este número é excedido, as entradas mais antigas são substituídas por novas entradas.
Nome do Arquivo de Dump
O nome do arquivo no qual o buffer de memória será gravado após o dump. Esta opção está disponível apenas na guia Tempo de execução.
Arquivo
Especifica que a saída de rastreio deve ser gravada em um arquivo de log de auto-gerenciamento.

O arquivo de log de auto-gerenciamento grava mensagens no arquivo até que um critério de tamanho seja atingido. Quando o arquivo alcança o tamanho especificado, o registro é temporariamente suspenso e o arquivo de log é fechado e renomeado. O novo nome será baseado no nome original do arquivo, além de um qualificador de data e hora que indica quando ocorreu a renomeação. Após a conclusão da renomeação, um arquivo de log novo e vazio com o nome original será reaberto, e o registro será retomado. Nenhuma mensagem será perdida como resultado do rollover, embora uma única mensagem possa ser dividida nos dois arquivos.

Se você selecionar esta opção, deverá especificar os seguintes parâmetros:

Tamanho Máximo do Arquivo
Especifica o tamanho máximo, em megabytes, que o arquivo de saída pode alcançar.

Este atributo será válido somente se o atributo Tamanho do Arquivo estiver selecionado. Quando o arquivo alcança este tamanho, é executado rollover, conforme descrito acima.

Número Máximo de Arquivos Históricos
Especifica o número máximo de arquivos de rollover a serem mantidos.
Nome do Arquivo
Especifica o nome do arquivo no qual a saída de rastreio será gravada.

Guia Tempo de Execução

Salvar Rastreio
Salva as alterações feitas na guia tempo de execução na configuração do rastreio.

Selecione esta caixa para copiar as alterações de rastreio em tempo de execução nas definições de configuração do rastreio. Salvar estas alterações na configuração do rastreio fará com que as alterações persistam mesmo se o aplicativo for iniciado novamente.

Especificação de Rastreio
Especifica detalhes de rastreio.

Insira uma cadeia de rastreio que especifique os componentes, pacotes ou grupos a serem rastreados. A cadeia de rastreio deve estar de acordo com a gramática específica descrita abaixo. Você pode digitar a cadeia de rastreio diretamente, ou gerá-la utilizando a interface gráfica de rastreio. Clique em Modificar para iniciar a interface gráfica de rastreio.

Se você iniciar a interface gráfica de rastreio a partir da guia Configuração, será exibida uma lista de componentes, pacotes e grupos bem conhecidos. Essa lista pode não ser completa.

Se você iniciar a interface gráfica de rastreio a partir da guia Tempo de Execução, a lista de componentes, pacotes e grupos exibirá todos estes componentes atualmente registrados no servidor de execução.

O formato da especificação de rastreio é:

<componente> =
<tipo_de_rastreio>= enabled | disabled
em que: <componente> é o componente para o qual o rastreio será ativado ou desativado e <tipo_de_rastreio> é o tipo de rastreio a ser ativado ou desativado. Separe várias especificações de rastreio com dois-pontos (:).

Os componentes correspondem a pacotes e classes Java, ou a coleções de pacotes Java. Utilize * como um curinga para indicar componentes que incluem todas as classes em todos os pacotes contidos pelo componente especificado. Por exemplo:

*
Especifica todo o código que pode ser rastreado no servidor de aplicativos, incluindo o código do sistema WebSphere Application Server e o código do cliente.
com.ibm.ws.*
especifica todas as classes cujo nome de pacote inicia com com.ibm.ws.
com.ibm.ws.classloader.JarClassLoader
Especifica somente a classe JarClassLoader.

Para obter informações adicionais sobre a gramática da cadeia de rastreio, consulte o artigo Ativando Rastreio na navegação do centro de informações do WebSphere Application Server.

Nota: Pode ocorrer um erro ao definir uma especificação de rastreio a partir do console administrativo se as seleções forem feitas a partir das listas Grupos e Componentes. Em alguns casos, a seleção feita em uma lista não é perdida quando uma seleção é adicionada da outra lista. Para evitar esse problema, insira a especificação de rastreio desejada diretamente no campo de entrada Especificação de Rastreio.

Saída do Rastreio  
Especifica onde a saída de rastreio deve ser gravada.

A saída do rastreio pode ser gravada diretamente em um arquivo de saída ou armazenada na memória e gravada em um arquivo por pedido, utilizando o botão Dump na página de tempo de execução.

Buffer de Memória
Especifica que a saída de rastreio deve ser gravada em um buffer circular na memória. Se você selecionar esta opção, deverá especificar os seguintes parâmetros:
Tamanho Máximo do Buffer
Especifica o número de entradas, em números de mil, que podem ser armazenadas em cache no buffer. Quando este número é excedido, as entradas mais antigas são substituídas por novas entradas.
Nome do Arquivo de Dump
O nome do arquivo no qual o buffer de memória será gravado após o dump. Essa opção está disponível apenas na guia Tempo de Execução.

Arquivo
Especifica que a saída de rastreio deve ser gravada em um arquivo de log de auto-gerenciamento.

O arquivo de log de auto-gerenciamento grava mensagens no arquivo até que um critério de tamanho seja atingido. Quando o arquivo alcança o tamanho especificado, o registro é temporariamente suspenso e o arquivo de log é fechado e renomeado. O novo nome será baseado no nome original do arquivo, além de um qualificador de data e hora que indica quando ocorreu a renomeação. Após a conclusão da renomeação, um arquivo de log novo e vazio com o nome original será reaberto, e o registro será retomado. Nenhuma mensagem será perdida como resultado do rollover, embora uma única mensagem possa ser dividida nos dois arquivos.

Se você selecionar esta opção, deverá especificar os seguintes parâmetros:

Tamanho Máximo do Arquivo
Especifica o tamanho máximo, em megabytes, que o arquivo de saída pode alcançar.

Este atributo será válido somente se o atributo Tamanho do Arquivo estiver selecionado. Quando o arquivo alcança este tamanho, é executado rollover, conforme descrito acima.

Número Máximo de Arquivos Históricos
Especifica o número máximo de arquivos de rollover a serem mantidos.
Nome do Arquivo
Especifica o nome do arquivo no qual a saída de rastreio será gravada.

Informações relacionadas

Botões do console administrativo
Definições de escopos do console administrativo
Definições de filtros do console administrativo
Definições de preferências do console administrativo
Recursos de páginas do console administrativo