VSPerfReport

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

VSPerfReport use a seguinte sintaxe:

VSPerfReport [/U] vspfilename [/options]

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

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

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

vspfilename1 and vspfilename2 deve ser arquivos válidos de .vsp ou de .vsps.

Arquivos de símbolo

Para exibir informações do símbolo como nomes de função e números de linha, VSPerfReport requer acesso aos arquivos do símbolo .PDB () dos componentes analisados e arquivos do símbolo do windows.Para obter mais informações, consulte Como especificar locais de arquivo de símbolo a partir da linha de comando.

Opções gerais do relatório

A tabela a seguir descreve as opções gerais de formatação do relatório e as opções que selecionam os dados a serem relatados.

Opções	Descrição
U	A saída do relatório e a saída redirecionada de console são gravadas como Unicode.Deve ser a primeira opção especificada.
Summary:[types]	Cria um ou mais tipos de relatórios. All - todos os tipos de relatórios são gerados. as relações pai/filho deCallerCallee - entre funções. Function - funções chamadas. CallTree - hierarquia de funções chamadas. Counter - todas as marcas junto com os valores de contador de desempenho do windows. Ip - instruções de perfil. Life - tempo de vida de objetos atribuídos (disponíveis quando os dados de alocação são coletados.) linha do código fonte dados deLine do perfil. Header - o relatório contém informações de cabeçalho de arquivo. Mark todo marcas. Module - módulos analisados. Process - processos analisados. Thread - threads analisados. Type tipos atribuídos. Contention - disputas de recursos. RuleWarnings - problemas de regra de desempenho ETW - todos os eventos de Rastreamento de Eventos do Windows (ETW) coletados em analisar executado.O arquivo de dados de .etl deve estar em seu local original ou no diretório que contém o arquivo de .vsp ou de .vsps.
Xml	Relatório de saída em formato XML.
CallTrace	Cria uma lista de entrada e de saída da função, de eventos do ETW, e de marcas.
ClearPackedSymbols	Remove os símbolos inseridas anteriormente de um arquivo de dados do profiler.Executar este comando antes de executar PackSymbols uma segunda vez.
SymbolPath:path	Especifica um ou mais caminhos de busca ou servidores de símbolo que contêm símbolos do arquivo de dados do profiler.
DebugSymPath	Lista os locais que são pesquisados por símbolos e se são encontradas.Essa opção é útil resolver problemas de resolução de símbolo.
PackSymbols	Salva símbolos no arquivo de dados de perfil .vsp () de modo que os arquivos do símbolo (.pdb) não sejam necessários para análise.
Output:path|filename	Especifica um local alternativo para os arquivos de relatório gerados.Por padrão, os relatórios são criados no diretório atual.
SummaryFile	Analisar e salvar as informações analisado em um arquivo de resumo de .vsps.
PrintMarks	Mostrar os nomes e os carimbos de data/hora para todas as marcas no arquivo de relatório especificado.
?	Exibe informações de uso.
NoLogo	Oculta a informações de versão de linha quando o relatório está sendo executado.
UserRulesDirectory	Especifica o diretório que contém as regras definidas pelo usuário de desempenho [] ainda não implementadas.

Opções de filtro

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

Opções	Descrição
JustMyCode[:[caller][,callee]]	Apenas chamadas de função de aplicativo do usuário de apresentação; chamadas do sistema de ocultar automaticamente. Nenhum parâmetro - ocultar todas as funções do sistema. caller - mostrar um nível de funções de sistema que chamam as funções de aplicativo. callee - mostrar um nível de funções de sistema que são chamadas por funções de aplicativo do usuário.
StartTime:[value]	Apenas dados de apresentação coletados depois do valor (em milissegundos).
EndTime:[value]	Apenas dados de apresentação coletados antes do valor (em milissegundos).
FilterFile:VSPFFile	Especifica o local de um arquivo de filtro que foi gerado da janela de relatório de desempenho do Visual Studio.
MsFilter:[starttime,duration]	Mostrar apenas dados de starttime até o comprimento de duration (em milissegundos).
Process:[pid]	Mostrar apenas dados de processo especificado.
Thread:[threadid]	Mostrar apenas dados do thread especificado.
Thread:[threadid,processid]	Mostrar apenas dados especificado do thread 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	Compara dois arquivos dos arquivos de relatório (.vsp ou .vsps).As opções de resumo serão ignoradas usando a opção de diff.
Diff:[value]	Abaixo desse valor de limite a diferença entre dois valores será desconsiderada.Além disso, os novos dados por valores nesse limite não serão exibidos.
DiffTable:[tablename]	Use esta tabela específica para comparar arquivos.O padrão é a tabela de funções.
DiffColumn:[columnname]	Use essa coluna específica se comparam valores.O padrão é a coluna de porcentagem dos exemplos da tentativa.
QueryDiffTables	Listar as tabelas e as colunas válidas 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