VSPerfReport

  • Artigo

Ferramenta de linha de comando VSPerfReport é usada para criar relatórios usando Visual Studio Ferramentas de criação de perfil profiling arquivos de dados. O formato de relatório padrão é um arquivo. csv.

VSPerfReport usa a seguinte sintaxe:

VSPerfReport [/U] vspfilename [/options]

Observe que filename deve ser um. vsp de válido ou o arquivo de .vsps.

A ferramenta de linha de comando VSPerfReport também é usada para comparar arquivos. vsp ou .vsps. Para gerar um relatório de diferença ("diff"), use a seguinte sintaxe:

VSPerfReport [/U] /diff vspfilename1 vspfilename2 [/options]

vspfilename1 and vspfilename2devem ser arquivos. vsp ou .vsps válidos.

Arquivos de símbolos

Para exibir informações de símbolo, como nomes de função e números de linha, VSPerfReport requer acesso ao símbolo (.Arquivos PDB) perfilado componentes e arquivos de símbolos do Windows. Para obter mais informações, consulte Como: Especifique locais de arquivo de símbolo na linha de comando.

Opções de relatório geral

A tabela a seguir descreve o relatório geral de opções de formatação e as opções de selecionar os dados a serem relatados.

Opções

Descrição

U

O relatório de saída e console de saída redirecionado são gravados como Unicode. Devem ser a primeira opção especificada.

Summary:types

Cria um ou mais tipos de relatórios.

  • All-todos os tipos de relatório são gerados.

  • CallerCallee-relações pai/filho entre funções.

  • Function-funções chamadas.

  • CallTree-a hierarquia das funções chamadas.

  • Counter-valores de contador de todas as marcas com o desempenho do Windows.

  • Ip-instruções perfiladas.

  • Life-o tempo de vida de objetos alocados (disponíveis quando coletou dados de alocação).

  • Linedados de perfil de linha de código de origem.

  • Header-relatório contém informações de cabeçalho do arquivo.

  • Marktodas as marcas.

  • Module-módulos perfilados.

  • Process-processos perfilados.

  • Thread-segmentos perfilados.

  • Type-alocado tipos.

  • Contention-contenções de recurso.

  • RuleWarnings-problemas de regra de desempenho

  • ETW -todos os eventos de rastreamento de eventos para Windows (ETW) coletados no perfil executar. O arquivo de dados. etl deve ser em seu local original ou no diretório que contém o arquivo. vsp ou .vsps.

Xml

relatório de saída em formato XML.

CallTrace

Cria uma lista das entradas e saídas da função, eventos ETW, e marcas.

ClearPackedSymbols

Remove símbolos anteriormente incorporados um arquivo de dados do profiler. Execute este comando antes de executar o PackSymbols uma segunda vez.

SymbolPath:path

Especifica um ou mais caminhos de pesquisa ou servidores de símbolos que contêm símbolos para o arquivo de dados do profiler.

DebugSymPath

Lista os locais que são pesquisados para símbolos e eles são encontrados. Essa opção é útil para resolver problemas de resolução de símbolo.

PackSymbols

Salva os símbolos no arquivo de dados (. vsp) de criação de perfil para que os arquivos de símbolo (. PDB) não são necessários para análise.

Output:caminho|nome do arquivo

Especifica um local alternativo para os arquivos de relatório gerado. Por padrão, os relatórios são criados no diretório atual.

SummaryFile

Analisar e salvar as informações de analisados em um arquivo de resumo de .vsps.

PrintMarks

Mostre os nomes e os carimbos de hora para todas as marcas no arquivo de relatório especificado.

?

Exibe informações de uso.

NoLogo

Oculta as informações de versão quando o relatório está sendo executado.

UserRulesDirectory

Especifica o diretório contendo definido pelo usuário regras de desempenho [ainda não implementadas].

Opções de filtro

A tabela a seguir descreve as opções para filtrar os dados disponíveis.

Opções

Descrição

JustMyCode[:[caller][,callee]]

Mostrar somente as chamadas de função de aplicativo do usuário; Oculte chamadas do sistema.

  • Nenhum parâmetro - ocultar todas as funções do sistema.

  • caller-Mostrar um nível de funções do sistema que chamam funções do aplicativo.

  • callee-Mostrar um nível de funções do sistema que são chamadas de funções de usuário do aplicativo.

StartTime:value

Mostrar apenas os dados coletados após valor (em milissegundos).

EndTime:value

Mostrar apenas os dados coletados antes do valor (em milissegundos).

FilterFile:VSPFFile

Especifica o local de um arquivo de filtro que foi gerado a partir da janela do relatório de desempenho de Visual Studio.

MsFilter:starttime, duração

Mostrar apenas os dados de starttime até o comprimento de duration (em milissegundos.)

Process:pid

Mostre apenas os dados do processo especificado.

Thread:threadid

Mostre apenas os dados do segmento especificado.

Thread:threadid, processid

Mostre apenas os dados do segmento especificado associado ao processo especificado.

Opções de relatório de diferença

A tabela a seguir descreve as opções para comparar arquivos de relatório.

Opções

Descrição

Diff vspfile1 vspfile2

Compare dois arquivos (. vsp ou .vsps) arquivos de relatório. Opções de resumo serão ignoradas usando a opção de comparação.

Diff:value

Abaixo desse valor de limite será desconsiderada a diferença entre dois valores. Além disso, novos dados com valores sob esse limite não serão mostrados.

DiffTable:tablename

Use esta tabela específica para comparar arquivos. O padrão é a tabela de funções.

DiffColumn:columnname

Use valores de comparar essa coluna específica. O padrão é a coluna de porcentagem de amostras exclusivas.

QueryDiffTables

Lista as tabelas válidas e as colunas para os dois arquivos de relatório fornecidos.

Consulte também

Outros recursos

Exibições de relatório de ferramentas de criação de perfil