iniciar
Exibe as opções de início do logger.
xperf [-start [LoggerName] [ProfileFileName!ProfileName|SessionName]|-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] -flush [LoggerName] -save ProfileFileName!ProfileName|SessionName merged.etl -setprofint [<n>] [cached] -seteresourcesample <n1> <n2> <n3> -setspinlocksample <n1> <n2> <n3> -pooltag <P1>+<P2>+<P3>+<P4> -on (GUID|KnownProviderName)[:Flags[:Level[<:0xnnnnnnnn|’stack|[,]sid[,]tsid’]]]
Parâmetros
| Comando | Descrição |
|---|---|
-start [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
Inicia uma sessão de log para LoggerName, inicia agentes no perfil ProfileName definidos no arquivo ProfileFileName ou inicia o agente SessionName definido no arquivo ProfileFileName. |
-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
Atualiza uma sessão de log para LoggerName, atualiza agentes no perfil ProfileName definidos no arquivo ProfileFileName ou atualiza o agente SessionName definido no arquivo ProfileFileName. |
-flush LoggerName |
Libera uma sessão de log para LoggerName. Esse parâmetro é necessário para salvar um rastreamento de modo buffer (consulte o parâmetro -buffering abaixo). Para salvar um rastreamento de modo de buffer, você deve emitir o parâmetro -flush. |
-capturestate LoggerName Flags |
Captura o estado para sessão de log não kernel de provedores especificados em Flags. O formato de provedor aceito é o mesmo que para -on. Se os sinalizadores e o nível forem especificados, eles serão habilitados durante a captura do estado. Isso é chamado para o rastreamento iniciado com a opção –buffering. Ele deve ser seguido por –stop para parar o rastreamento. |
-on Flags|Groups |
Para sessões de log do kernel, a sequência de sinalizadores e grupos do kernel a serem ativados, separados por sinais de adição (+). Para sessões de log de usuário, a sequência de provedores a serem habilitados, separados por sinais de adição (+). O formato de provedor aceito é |
-f filename |
Registra eventos no arquivo especificado. O padrão é \Kernel.etl para rastreamentos de kernel e \User.etl para rastreamentos de usuário. |
-buffersize Size |
Define o tamanho do buffer de rastreamento como Tamanho em KB. Os valores possíveis são 4 a 1.024. O padrão é 64. |
-minbuffers n |
Define o número mínimo de buffers de rastreamento como n. O padrão é 64. |
-maxbuffers n |
Define o número máximo de buffers de rastreamento como n. O padrão é 320. |
-maxfile Size |
Define o tamanho máximo do arquivo como Tamanho em MB. |
-flushtimer n |
Define o temporizador de liberação como n segundos. |
-boottrace Flags|Groups|off |
Configura o Rastreamento de Eventos para o agente do Windows para rastrear a inicialização. Defina os sinalizadores como "desativados" para desativar o rastreamento de inicialização. Todo o controle de log também pode ser usado com isso. Use em conjunto com -f para registrar em um arquivo diferente de \Perf.etl. |
-realtime |
Permite rastreamento em tempo real. |
-buffering |
Habilita o rastreamento do modo de buffer. Para economizar, use -flush. A opção -stop não salva o rastreamento. |
-filemode Mode |
Define o modo de arquivo. O padrão é "Sequencial". Modos possíveis: "Sequential", "Circular", "Append" e "NewFile". |
-clocktype ClockType |
Define o tipo de relógio. O padrão é "PerfCounter". Tipos possíveis: "Cycle", "PerfCounter" e "SystemTime". |
-stackwalk flags|@file |
Habilita a caminhada de pilha para os eventos especificados como |
-pids pid [...] |
Aplica os sinalizadores a processos Ao especificar vários pids, separe-os com um espaço, como em |
-pidnewprocess <command-line> |
Aplica sinalizadores a um novo processo que o Xperf iniciará com <command-line>. Usado em conjunto com agentes privados. |
-waitfornewprocess |
Aguarda um novo processo criado usando |
-heap |
Habilita o rastreamento de heap em processos especificados por Pids e PidNewProcess. |
-critsec |
Habilita o rastreamento de seção crítica em processos especificados por Pids e PidNewProcess. |
-setprofint [<n>] [cached] |
Define o intervalo de perfil amostrado como |
-save ProfileFileName!ProfileName|SessionName merged.etl |
Libera os agentes no perfil ProfileName definido no arquivo ProfileFileName e mescla os arquivos ETL para merged.etl; ou libera o agente SessionName definido no arquivo ProfileFileName e mescla o arquivo ETL para Merged.etl. |
-seteresourcesample <n1><n2><n3> |
Define a amostragem de recursos ERESOURCE, em que a taxa de amostragem de liberação n1 é maior ou igual a 1.000, a taxa de amostragem de contenção n2 é maior ou igual a 1 e o número de tempos limite excessivos n3 é maior ou igual a 1. A taxa de amostragem de contenção é a taxa na qual os eventos de spinlock são adquiridos quando ocorrem colisões. Por exemplo, se esse valor for 100, um evento de spinlock será adquirido para cada cem colisões de Spin Lock. |
-setspinlocksample <n1><n2><n3> |
Define o limite de rotação do spinlock como |
-pooltag <P1>+<P2>+<P3>+<P4> |
Define os filtros de marcação de pool (Pn) separados por sinais de adição (+) ou ponto-e-vírgula (;). Use um ponto de interrogação (?) para um curinga com um único caractere ou um asterisco (*) para um curinga de vários caracteres. No máximo quatro filtros podem ser especificados. |
Comentários
Vários agentes podem ser iniciados usando várias opções de início, cada uma seguida pelas opções a serem aplicadas a esse agente. Se LoggerName ou -start LoggerName for omitido, o agente do kernel estará implícito. Apenas uma única instância do agente do kernel pode existir a qualquer momento. Se um dos agentes falhar ao iniciar, todos os agentes que já foram iniciados serão interrompidos.