Comandos de controle do TraceView
Observação
As opções de linha de comando do TraceView foram preteridas. Use tracepdb.exe e tracefmt.exe para analisar PDBs em arquivos TMF e analisar arquivos .etl em texto, respectivamente.content
Use um comando de controle Traceview para gerenciar sessões de rastreamento, incluindo iniciar e interromper a sessão, habilitar e desabilitar provedores, atualizar as propriedades da sessão de rastreamento e liberar buffers de rastreamento.
traceview {-start | -stop | -update | -enable | -disable | -flush | -q} SessionName [Parameters]
traceview {-enumguid | -l | -h | -x}
Parâmetros de comando
Ações
| Ação | Descrição |
|---|---|
| -começar | Inicia a sessão de rastreamento especificada. |
| -parar | Interrompe a sessão de rastreamento especificada. |
| -atualização | Atualiza as propriedades da sessão de rastreamento especificada. |
| -habilitar | Habilita provedores para a sessão de rastreamento especificada. |
| -desabilitar | Desabilita provedores para a sessão especificada. |
| -flush | Libera os buffers ativos da sessão de rastreamento especificada. Essa liberação forçada é um acréscimo às liberações automáticas que ocorrem quando um buffer está cheio e quando a sessão de rastreamento é interrompida. |
| -q | Consulte o status da sessão de rastreio especificada. |
| -enumguid | Lista os provedores no sistema registrados no ETW (Rastreamento de Eventos para Windows). |
| -l | Liste todas as sessões de rastreamento em execução no computador. |
| -x | Interrompe todas as sessões de rastreamento. |
Parâmetros
Nome da sessão
Quando usado com -start, SessionName é um nome que você seleciona para representar a sessão de rastreamento. Com todos os outros comandos, SessionName identifica a sessão de rastreamento.
-f [Arquivo de log]
Quando usado com -start, -f inicia uma sessão de log de rastreamento. LogFile especifica o caminho (opcional) e o nome do arquivo de log de rastreamento de eventos (.etl). O padrão é C:\LogFile.etl.
Quando usado com -update, -f envia todas as novas mensagens de rastreamento somente para o log de rastreamento especificado. Use esse parâmetro para converter uma sessão de rastreamento em tempo real em uma sessão de log de rastreamento ou para iniciar um novo log de rastreamento para uma sessão de log de rastreamento existente. Para enviar mensagens de rastreio para um consumidor de rastreio em tempo real e para um log de rastreio, use os parâmetros -rt e -f no comando -update .
-Rt
Quando usado com -start, -rt inicia uma sessão de rastreamento em tempo real (uma sessão de log de rastreamento (-f) é o padrão.) Se você usar -rt e -f em um comando -start , as mensagens de rastreamento serão enviadas para o consumidor de rastreamento e para um arquivo de log de rastreamento de eventos.
Quando usado com -update, -rt adiciona entrega de mensagens em tempo real a uma sessão de log de rastreamento. Todas as novas mensagens de rastreamento são enviadas diretamente para o consumidor de rastreamento (como em uma sessão de rastreamento em tempo real), além de um log de rastreamento.
-guid {#GUID | GUIDFile}
Especifica um ou mais provedores de rastreamento. Use com -start para habilitar provedores para uma sessão de rastreamento. Use com -enable para habilitar os provedores ou alterar seus valores -flag ou -level . Use com -disable para especificar os provedores a serem desabilitados.
O GUID pode especificar um GUID de controle (precedido por um sinal de número (#)) ou o caminho (opcional) e o nome de arquivo de um arquivo de texto, como um arquivo GUID de controle (.ctl), que contém os GUIDs de controle de um ou mais provedores de rastreamento.
Se você omitir o parâmetro -guid de um comando -start, o TraceView iniciará uma sessão de rastreamento do Agente de Kernel NT.
TraceView passa os valores dos subparâmetros a seguir para os provedores especificados.
| Parâmetro | Descrição |
|---|---|
| Nome da sessão | Quando usado com -start, SessionName é um nome que você seleciona para representar a sessão de rastreamento. Com todos os outros comandos, SessionName identifica a sessão de rastreamento. |
| -f \[ArquivoDe Log\] | Quando usado com -start, -f inicia uma sessão de log de rastreamento. LogFile especifica o caminho (opcional) e o nome do arquivo de log de rastreamento de eventos (.etl). O padrão é C:\\LogFile.etl. Quando usado com -update, -f envia todas as novas mensagens de rastreamento apenas para o [log de rastreamento](trace-log.md) especificado. Use esse parâmetro para converter uma sessão de rastreamento em tempo real em uma sessão de log de rastreamento ou para iniciar um novo log de rastreamento para uma sessão de log de rastreamento existente. Para enviar mensagens de rastreio para um consumidor de rastreio em tempo real e para um log de rastreio, use os parâmetros -rt e -f no comando -update . |
| -Rt | Quando usado com -start, -rt inicia uma sessão de rastreamento em tempo real (uma sessão de log de rastreamento (-f) é o padrão.) Se você usar -rt e -f em um comando -start , as mensagens de rastreamento serão enviadas para o consumidor de rastreamento e para um arquivo de log de rastreamento de eventos. Quando usado com -update, -rt adiciona entrega de mensagens em tempo real a uma sessão de log de rastreamento. Todas as novas mensagens de rastreamento são enviadas diretamente para o consumidor de rastreamento (como em uma sessão de rastreamento em tempo real), além de um [log de rastreamento](trace-log.md). |
| -guid {\#GUID | GUIDFile} | Especifica um ou mais provedores de rastreamento. Use com -start para habilitar provedores para uma sessão de rastreamento. Use com -enable para habilitar os provedores ou alterar seus valores -flag ou -level . Use com -disable para especificar os provedores a serem desabilitados. O GUID pode especificar um [GUID de controle](control-guid.md) (precedido por um sinal de número (\#)) ou o caminho (opcional) e o nome de arquivo de um arquivo de texto, como um arquivo GUID de controle (.ctl), que contém os GUIDs de controle de um ou mais provedores de rastreamento. Se você omitir o parâmetro -guid de um comando -start, o TraceView iniciará uma [sessão de rastreamento do NT Kernel Logger](nt-kernel-logger-trace-session.md). |
TraceView passa os valores dos seguintes subparâmetros para o provedor especificado:
-b Tamanho do Buffer
Especifica o tamanho, em KB, de cada buffer alocado para a sessão de rastreamento. Use apenas com -start.
O valor padrão é determinado pelo número de processadores, pela quantidade de memória física e pelo sistema operacional em uso.
-Min Número de buffers
Especifica o número de buffers inicialmente alocados para armazenar mensagens de rastreamento. Use apenas com -start.
O valor padrão é determinado pelo número de processadores, pela quantidade de memória física e pelo sistema operacional em uso.
-Max Número de buffers
Quando usado com -start, -max 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, pela quantidade de memória física e pelo sistema operacional em uso.
Quando usado com -update, -max altera o número máximo de buffers alocados para a sessão de rastreamento.
-Ft Tempo de descarga
Quando usado com -start, -ft especifica com que frequência, em segundos, os buffers de mensagens de rastreamento são liberados. Quando usado com -update, -ft altera o tempo de liberação para o tempo especificado.
O tempo mínimo de descarga é de 1 segundo. O valor padrão é 0 (sem liberação forçada).
Essa liberação forçada é adicional às liberações que ocorrem automaticamente sempre que um buffer de mensagem de rastreamento está cheio e quando uma sessão de rastreamento é interrompida.
Veja também: -flush.
-Paginada
Usa memória paginável para os buffers de mensagens de rastreamento. Por padrão, o rastreamento de eventos usa memória não paginável para buffers. Use apenas com -start.
Não use esse parâmetro quando o provedor for um driver que pode gerar mensagens de rastreamento em um IRQL maior que DISPATCH_LEVEL.
Esse parâmetro não é suportado no Windows 2000.
-Seq MaxFileSize
Especifica o log seqüencial (no final do arquivo, pare de gravar eventos) para o arquivo de log de rastreamento de eventos (.etl). Use apenas com -start.
MaxFileSize especifica o tamanho máximo do arquivo em MB. Sem um valor MaxFileSize , esse parâmetro é ignorado.
O log sequencial é o padrão, mas você pode usar esse parâmetro para definir o tamanho máximo do arquivo ou usar -prealloc. Sem esse parâmetro, não há limite de tamanho de arquivo.
-Cir MaxFileSize
Especifica o log circular (no final do arquivo, registre novas mensagens sobre as mensagens mais antigas) no arquivo de log de rastreamento de eventos (.etl). Use apenas com -start.
MaxFileSize especifica o tamanho máximo do arquivo em MB. Sem um valor MaxFileSize , esse parâmetro é ignorado.
O padrão é o log sequencial sem limite de tamanho de arquivo.
-prealoc
Reserva espaço para o arquivo de log de rastreamento de eventos (.etl) antes de alocá-lo. Use apenas com -start.
Esse parâmetro requer -seq ou -cir com MaxFileSize. Não é válido com -newfile.
Flag representa um valor de sinalizador definido no provedor de rastreamento, em formato decimal ou hexadecimal. O valor padrão é 0. Os valores de 0x01000000 a 0xFF000000 são reservados para uso futuro.
O significado dos sinalizadores é definido independentemente por cada provedor de rastreamento. Normalmente, os sinalizadores representam níveis de relatórios cada vez mais detalhados.
Em um comando -start , o valor flags se aplica a todos os provedores de rastreamento na sessão de rastreamento. Para definir sinalizadores diferentes para cada provedor de rastreamento, use um comando -enable separado para cada provedor de rastreamento.
| Subparâmetros de -guid | Descrição |
|---|---|
-bandeira Bandeira |
|
|
-nível Nível |
Especifica o nível de rastreamento para os provedores na sessão de rastreamento. O nível determina quais eventos o provedor de rastreamento gera. Nível representa um valor de nível no formato decimal ou hexadecimal. O valor padrão é 0. O significado do valor do nível é definido independentemente por cada provedor de rastreamento. Normalmente, o nível de rastreamento representa a gravidade do evento (informações, aviso ou erro). Em um comando -start , o valor level se aplica a todos os provedores de rastreamento na sessão de rastreamento. Para definir níveis diferentes para cada provedor de rastreamento, use um comando -enable separado para cada provedor de rastreamento. |
| -b Tamanho do Buffer | Especifica o tamanho, em KB, de cada buffer alocado para a sessão de rastreamento. Use apenas com -start.
O valor padrão é determinado pelo número de processadores, pela quantidade de memória física e pelo sistema operacional em uso. |
| -min Número de Buffers | Especifica o número de buffers inicialmente alocados para armazenar mensagens de rastreamento. Use apenas com -start.
O valor padrão é determinado pelo número de processadores, pela quantidade de memória física e pelo sistema operacional em uso. |
| -max NumberOfBuffers | Quando usado com -start, -max 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, pela quantidade de memória física e pelo sistema operacional em uso.
Quando usado com -update, -max altera o número máximo de buffers alocados para a sessão de rastreamento. |
| -ft Tempo de descarga | Quando usado com -start, -ft especifica com que frequência, em segundos, os buffers de mensagens de rastreamento são liberados. Quando usado com -update, -ft altera o tempo de liberação para o tempo especificado.
O tempo mínimo de descarga é de 1 segundo. O valor padrão é 0 (sem liberação forçada). Essa liberação forçada é adicional às liberações que ocorrem automaticamente sempre que um buffer de mensagem de rastreamento está cheio e quando uma sessão de rastreamento é interrompida. Veja também: -flush. |
| -idade AgeLimit | Quando usado com -start, -age especifica por quanto tempo (em minutos) os buffers de rastreamento não utilizados são mantidos antes de serem liberados. Quando usado com -update, -age altera o limite de idade para o valor especificado.
Limite de idade especifica por quanto tempo (em minutos) os buffers de rastreamento não utilizados são mantidos antes de serem liberados. O padrão é de 15 minutos. Esse parâmetro é válido somente no Windows 2000. |
| -Paginada | Usa memória paginável para os buffers de mensagens de rastreamento. Por padrão, o rastreamento de eventos usa memória não paginável para buffers. Use apenas com -start.
Não use esse parâmetro quando o provedor for um driver que pode gerar mensagens de rastreamento em um IRQL maior que DISPATCH\_LEVEL. Esse parâmetro não é suportado no Windows 2000. |
| -seq MaxFileSize | Especifica o log seqüencial (no final do arquivo, pare de gravar eventos) para o arquivo de log de rastreamento de eventos (.etl). Use apenas com -start.
MaxFileSize especifica o tamanho máximo do arquivo em MB. Sem um valor MaxFileSize , esse parâmetro é ignorado. O log sequencial é o padrão, mas você pode usar esse parâmetro para definir o tamanho máximo do arquivo ou usar -prealloc. Sem esse parâmetro, não há limite de tamanho de arquivo. |
| -cir MaxFileSize | Especifica o log circular (no final do arquivo, registre novas mensagens sobre as mensagens mais antigas) no arquivo de log de rastreamento de eventos (.etl). Use apenas com -start.
MaxFileSize especifica o tamanho máximo do arquivo em MB. Sem um valor MaxFileSize , esse parâmetro é ignorado. O padrão é o log sequencial sem limite de tamanho de arquivo. |
| -prealoc | Reserva espaço para o arquivo de log de rastreamento de eventos (.etl) antes de alocá-lo. Use apenas com -start.
Esse parâmetro requer -seq ou -cir com MaxFileSize. Não é válido com -newfile. O sistema cria o arquivo de log de rastreamento de eventos (.etl) com um tamanho igual ao valor MaxFileSize especificado usando os parâmetros -seq ou -cir. Quando você interrompe a sessão, o arquivo de log é reduzido ao tamanho de seu conteúdo. |
| -novoarquivo MaxFileSize | Cria um novo arquivo de log de rastreamento de eventos (.etl) sempre que o arquivo existente atinge MaxFileSize. Use apenas com -start.
MaxFileSize especifica o tamanho máximo de cada arquivo de log em MB. Sem um valor MaxFileSize , esse parâmetro é ignorado. Ao usar -newfile, você também deve usar o parâmetro -f LogFile e o valor de LogFile deve ser um nome que inclua os caracteres %d para indicar um padrão decimal - por exemplo, trace%d.etl. Caso contrário, o comando falhará com ERROR\_INVALID\_NAME. O Windows incrementa o valor decimal no nome do arquivo sempre que cria um novo arquivo. Esse parâmetro não é válido com a pré-alocação (-prealloc logging (-cir), com a sessão do NT Kernel Logger ou para sessões de rastreamento privadas. Não há suporte no Windows 2000. |
| -acrescentar | Acrescenta as mensagens de rastreamento a um arquivo de log de rastreamento de eventos (.etl) existente. O padrão é criar um novo arquivo. Use apenas com -start.
Este parâmetro é válido apenas em arquivos sequenciais e somente quando -f é usado e -rt não é usado. Não há suporte no Windows 2000. |
| -kd | Redireciona as mensagens de rastreamento para KD ou Windbg, o que estiver anexado. Esse parâmetro também define o tamanho do buffer de rastreamento como 3 KB, o tamanho máximo do buffer para o depurador e ignora todos os parâmetros -b no comando. Use apenas com -start. |
Comentários
Um comando traceview sem parâmetros abre a janela TraceView.
Você pode usar o comando TraceView -start para iniciar uma sessão de rastreamento do Agente Global. Para fazer isso, use o seguinte formato de comando. Ao contrário de outros comandos, a palavra "GlobalLogger" neste formato de comando diferencia maiúsculas de minúsculas.
traceview -start GlobalLogger [parameters]