SPTAggregate

SPTAggregate é uma ferramenta de linha de comando para SPGO (Otimização Guiada por Perfil por Amostragem). Use-o para combinar um ou mais arquivos ETL (log de rastreamento de eventos) que xperf coleta em um único arquivo SPT (rastreamento de perfil de amostra). Opcionalmente, você pode filtrar dados por nome binário ou processo e excluir eventos de kernel. Depois de criar o arquivo SPT, use SPDConvert para importá-lo em um arquivo SPD (Banco de Dados de Perfil de Exemplo) para fluxos de trabalho de otimização.

Os arquivos ETL (Log de Rastreamento de Eventos) contêm eventos brutos de desempenho do hardware que xperf registra. SPTAggregate converte esses arquivos ETL em formato SPT, que empacota os eventos de exemplo para importação em um arquivo SPD (Banco de Dados de Perfil de Exemplo) pelo SPDConvert.

Sintaxe

SPTAggregate [opções] /etletlfilessptfile

Parâmetros

Opções
Especifique as seguintes opções para SPTAggregate:

  • /Processo:<Processos> Filtrar eventos por nome do processo. Especifique um ou mais nomes de processo como uma lista separada por vírgulas.
    Exemplo: /process:myapp.exe
  • /Binário:<Binários> Filtrar eventos por nome binário. Especifique um ou mais nomes binários como uma lista separada por vírgulas.
    Exemplo: /binary:mylib.dll,myapp.exe
  • /nokernel Excluir eventos do kernel do sistema operacional.
  • /Ajuda Exibir informações de ajuda.

etlfiles
Uma lista separada por vírgulas de arquivos ETL (Log de Rastreamento de Eventos) a serem processados. Coletar arquivos ETL usando xperf.

sptfile
O arquivo SPT de saída que será criado.

Observações

Note

Execute essa ferramenta em um prompt de comando do desenvolvedor Visual Studio.

Use SPTAggregate para converter um ou mais arquivos ETL coletados por xperf um arquivo SPT. O /etl sinalizador é necessário e deve preceder a lista de arquivos ETL. Você pode importar o arquivo SPT resultante para um arquivo SPD usando SPDConvert.

SPTAggregate usa xperf, que deve estar no seu PATH e configurado com as alterações de perfcore.ini, conforme descrito em Configurar perfcore.ini.

Quando SPTAggregate executa xperf, ele usa parâmetros como: xperf -a spt -genSPT outputfile.spt -binary application.exe,support.dll,companion.dll, em que -a spt especifica a geração de um relatório de exemplo de análise de rastreamento de perfil, -genSPT especifica o arquivo SPT de saída, e -binary concentra a análise nos binários especificados.

Para obter mais informações sobre as xperf opções, consulte a documentação Referência da Linha de Comando do Xperf.

Example

Este exemplo converte um único arquivo ETL em um arquivo SPT:

SPTAggregate /etl filename.etl filename.spt

Este exemplo filtra eventos para um processo específico:

SPTAggregate /process:filename.exe /etl filename.etl filename.spt

Este exemplo agrega dois arquivos ETL e exclui eventos de kernel:

SPTAggregate /nokernel /etl run1.etl,run2.etl filename.spt

Consulte também

Tutorial: usar a SPGO (Otimização Guiada por Perfil de Amostra) para melhorar o desempenho
Otimizações guiadas por perfil
SPDConvert
SPDDump
SPTDump