Opções de parâmetro de sessão de registo

Na aba Opções de Parâmetro da Sessão de Log, pode-se especificar os valores das características variáveis de uma sessão de rastreio.

Você pode definir e alterar os valores das opções a seguir ao criar uma sessão de rastreamento. Várias opções podem ser alteradas durante a execução de uma sessão de rastreamento. As opções que não podem ser alteradas aparecem esmaecidas ("acinzentadas") na caixa de diálogo Opções de parâmetro da sessão de log .

Bandeiras
Especifica os sinalizadores de rastreamento para o provedor de rastreamento. Os sinalizadores de rastreamento determinam quais mensagens de rastreamento o provedor gera. O significado das bandeiras é determinado independentemente por cada provedor.

Se o TraceView puder encontrar um ficheiro de controlo de mensagem de rastreio (.tmc) para o fornecedor, pode selecionar sinalizadores e um nível a partir de uma lista apresentada na caixa de diálogo Sinalizadores de Rastreio e Seleção de Nível. Para abrir a caixa de diálogo Flags de Rastreamento e Seleção de Nível, clique no valor SET da opção Flags ou Nível na caixa de diálogo Opções de Parâmetro da Sessão de Log.

Tempo de descarga (S)
Especifica a frequência (em segundos) com que os buffers de sessão de rastreamento são liberados para um log de rastreamento ou para a exibição do TraceView. O padrão é 1 (segundo).

Estas descargas forçadas ocorrem para além das descargas que acontecem automaticamente quando uma memória intermédia está cheia. Um valor de 0 significa que não há limpezas forçadas.

Para liberar com mais frequência do que uma vez por segundo, use a opção Tamanho do buffer para reduzir o tamanho de cada buffer.

Você pode alterar o valor Flush Time enquanto a sessão de rastreamento está em execução.

Buffers máximos
Especifica o número máximo de buffers alocados para a sessão de rastreamento.

O valor padrão é determinado pelo número de processadores, a quantidade de memória física e o sistema operacional que você está usando. Você pode alterar esse valor enquanto a sessão de rastreamento está em execução.

Buffers mínimos
Especifica o número de buffers inicialmente alocados para armazenar mensagens de rastreamento.

Quando os buffers estão cheios, mais buffers são alocados até que o número de buffers atinja o valor especificado na opção Buffers máximos . O valor padrão é determinado pelo número de processadores, a quantidade de memória física e o sistema operacional em uso. Não é possível alterar esse valor enquanto a sessão de rastreamento estiver em execução.

Tamanho do buffer
Especifica o tamanho, em kilobytes (KB), de cada buffer alocado para a sessão de rastreamento. O valor padrão é determinado pelo número de processadores, a quantidade de memória física e o sistema operacional em uso. Não é possível alterar esse valor enquanto a sessão de rastreamento estiver em execução.

Tempo de decaimento (minutos)
Especifica por quanto tempo (em minutos) os buffers de rastreamento não utilizados são mantidos antes de serem liberados. O valor padrão é 15. O valor dessa opção é exibido na coluna Idade da Lista de Sessões de Rastreamento.

Este parâmetro é válido apenas no Windows 2000. Não é possível alterar esse valor enquanto a sessão de rastreamento estiver em execução.

Tamanho do buffer circular (MB)
Especifica que os buffers de rastreamento sejam circulares e especifica o tamanho máximo (em MB) de cada buffer.

Quando um buffer circular está cheio, novas mensagens de rastreamento são gravadas no início do buffer, substituindo as mensagens de rastreamento mais antigas. Por padrão, os buffers de rastreamento são sequenciais, não circulares.

Não é possível alterar esse valor enquanto a sessão de rastreamento estiver em execução.

Tamanho do buffer sequencial (MB)
Especifica se os buffers de rastreamento são sequenciais e especifica o tamanho máximo (em MB) de cada buffer.

Quando um buffer sequencial está cheio, as mensagens de rastreamento são gravadas em outro buffer ou são perdidas. Por padrão, os buffers de rastreamento são sequenciais, não circulares e têm 200 MB cada.

Não é possível alterar esse valor enquanto a sessão de rastreamento estiver em execução.

Iniciar novo arquivo após o tamanho do buffer (MB)
Cria um novo ficheiro de registo de rastreamento (.etl) sempre que o ficheiro de registo existente atinge o valor especificado. O valor especifica o tamanho máximo de cada arquivo de log em MB.

O valor dessa opção é exibido na coluna Novo arquivo da Lista de Sessões de Rastreamento.

Esta opção só é efetiva quando o provedor está gerando logs de rastreamento, ou seja, quando o utilizador seleciona a opção Registar os Dados de Eventos de Rastreamento num Ficheiro na página Opções de Sessão de Log. Esta opção não tem efeito em buffers circulares ou em logs de uma sessão de rastreamento do NT Kernel Logger. Não é suportado no Windows 2000.

Usar números de sequência global
Gera um número de sequência global para cada mensagem de rastreamento.

Os números de sequência global são exclusivos para todas as sessões de rastreamento no computador. O valor padrão dessa opção é FALSE.

Esta opção não é suportada no Windows 2000 e não tem efeito nos logs de uma sessão de rastreamento do NT Kernel Logger.

Usar número de sequência local
Gera um número de sequência local para cada mensagem de rastreamento. O valor padrão é TRUE.

Os números de sequência local são exclusivos dentro de uma sessão de rastreamento.

Esta opção não é suportada no Windows 2000 e não tem efeito nos logs de uma sessão de rastreamento do NT Kernel Logger.

Nível
Especifica um nível de rastreamento para o provedor de rastreamento. O nível de rastreamento determina quais mensagens de rastreamento o provedor gera. O significado do valor do nível é determinado independentemente por cada provedor. Normalmente, representa níveis crescentes de detalhe.

Se o TraceView puder encontrar um arquivo de controle de mensagem de rastreamento (.tmc) para o provedor, você poderá selecionar sinalizadores e um nível em uma lista exibida na caixa de diálogo Sinalizadores de rastreamento e Seleção de nível . Para abrir a caixa de diálogo Sinalizadores de Rastreamento e Seleção de Nível, clique no valor de configuração SET da opção Sinalizadores ou Nível na caixa de diálogo Opções do Parâmetro da Sessão de Registo.

Para obter mais informações sobre níveis de rastreamento, consulte a descrição do parâmetro EnableLevel da função EnableTrace no SDK do Microsoft Windows.

WinDbg
Redireciona mensagens de rastreamento para KD ou WinDbg, o que estiver habilitado, além de exibi-las na janela TraceView. Esta opção também define o tamanho do buffer para 3 KB, o tamanho máximo permitido pelo WinDbg. O valor exibido para a opção Tamanho do buffer é ignorado.

Para exibir mensagens de rastreamento em um depurador, wmitrace.dll e traceprt.dll devem estar no caminho de pesquisa do depurador no computador host. Essas DLLs estão incluídas no Ferramentas de Depuração para Windows Além disso, para permitir que o depurador localize os arquivos de formato de mensagem de rastreamento (.tmf) para as mensagens de rastreamento, os arquivos TMF devem estar no caminho de pesquisa do depurador no computador host. Para definir o caminho de pesquisa do depurador, use a extensão do depurador especializado !wmitrace.searchpath ou defina o valor da variável de ambiente %TRACE_FORMAT_SEARCH_PATH%. Para obter informações sobre extensões de rastreamento WinDbg e WMI, consulte Ferramentas de depuração para Windows.

Ignorar TraceView
Suprime mensagens de rastreamento resultantes de operações TraceView.

Tamanho do arquivo virtual
Indica o número máximo de mensagens de rastreamento que o TraceView armazena antes de começar a substituir as mensagens mais antigas para abrir espaço para mensagens mais recentes.

Um valor 0 significa que não existe um valor máximo. O TraceView retém todas as mensagens e nunca as substitui. O valor padrão dessa opção, 65536, é o valor recomendado para a maioria dos sistemas. Valores maiores podem causar atrasos significativos.

Esse valor aparece na coluna Max Trace Records da Lista de Sessões de Rastreamento.