Exemplo 9: Personalizando o arquivo de log de rastreamento

Os comandos neste exemplo demonstram métodos diferentes para personalizar o arquivo de log de rastreamento de eventos que o Tracelog produz.

Arquivo circular. O comando a seguir inicia uma sessão de log de rastreamento com um arquivo de log circular. Ele usa o parâmetro -cir para especificar um arquivo de log circular com um tamanho máximo de 2 MB.

Se você omitir o valor máximo do tamanho do arquivo (nesse caso, 2), o Tracelog ignorará o parâmetro e iniciará uma sessão com um arquivo de log de rastreamento sequencial.

tracelog -start MyTrace -guid MyProvider.guid -f testtrace.etl -cir 2

Arquivo pré-alocado. O comando a seguir inicia uma sessão de log de rastreamento com um arquivo pré-alocado. Nesse caso, o arquivo foi pré-alocado para garantir que seu tamanho grande possa ser acomodado antes do início da sessão de rastreamento.

Esse comando usa o parâmetro -seq para especificar um arquivo de log de rastreamento de eventos sequencial com um tamanho máximo de arquivo de 128 MB e usa o parâmetro -prealloc para solicitar um arquivo pré-alocado. Arquivos sequenciais são o padrão, mas o parâmetro -seq foi usado para especificar um tamanho máximo de arquivo, que é necessário para arquivos pré-alocados. O parâmetro -cir também pode ser usado para especificar um tamanho máximo de arquivos para -prealloc, se os arquivos circulares forem preferenciais.

tracelog -start MyTrace -guid MyProvider.guid -f testtrace.etl -seq 128 -prealloc

Vários arquivos. O comando a seguir inicia uma sessão de log de rastreamento que gera uma série de arquivos de log de rastreamento de eventos menores e sequenciais, em vez de um arquivo grande.

O comando usa o parâmetro -newfile com um valor máximo de tamanho de arquivo de 1 para iniciar um novo arquivo de log de rastreamento sempre que o arquivo de log atual atingir 1 MB. Além disso, o nome do arquivo especificado pelo parâmetro -f inclui os caracteres %d, conforme necessário ao usar -newfile. O sistema substitui um valor de contador de arquivos por %d quando cria cada arquivo.

tracelog -start MyTrace −guid MyProvider.guid -f testtrace%d.etl -newfile 1

Os arquivos de 1 MB resultantes são numerados na ordem em que são criados, por exemplo testtrace1.etl.