ProcDump v11.0

Por Mark Russinovich e Andrew Richards

Publicado: 03/11/2022

Baixar o ProcDump (714 KB)

Baixar o ProcDump para Linux (GitHub)

^{Criado com ZoomIt}

Introdução

O ProcDump é um utilitário de linha de comando cuja principal finalidade é monitorar um aplicativo para picos de CPU e gerar despejos de memória durante um pico que um administrador ou desenvolvedor pode usar para determinar a causa do pico. O ProcDump também inclui monitoramento de janela suspensa (usando a mesma definição de janela suspensa que o Windows e o Gerenciador de Tarefas usam), monitoramento de exceções não tratadas e pode gerar despejos com base nos valores dos contadores de desempenho do sistema. Ele também pode servir como um utilitário de despejo de processo geral que você pode inserir em outros scripts.

Usar o ProcDump

Capturar o Uso:

procdump.exe [-mm] [-ma] [-mt] [-mp] [-mc <Mask>] [-md <Callback_DLL>] [-mk]
            [-n <Count>]
            [-s <Seconds>]
            [-c|-cl <CPU_Usage> [-u]]
            [-m|-ml <Commit_Usage>]
            [-p|-pl <Counter> <Threshold>]
            [-h]
            [-e [1] [-g] [-b] [-ld] [-ud] [-ct] [-et]]
            [-l]
            [-t]
            [-f  <Include_Filter>, ...]
            [-fx <Exclude_Filter>, ...]
            [-dc <Comment>]
            [-o]
            [-r [1..5] [-a]]
            [-at <Timeout>]
            [-wer]
            [-64]
            {
                {{[-w] <Process_Name> | <Service_Name> | <PID>} [<Dump_File> | <Dump_Folder>]}
            |
                {-x <Dump_Folder> <Image_File> [Argument, ...]}
            }

Instalar o Uso:

procdump.exe -i [Dump_Folder]
            [-mm] [-ma] [-mt] [-mp] [-mc <Mask>] [-md <Callback_DLL>] [-mk]
            [-r]
            [-at <Timeout>]
            [-k]
            [-wer]

Desinstalar o Uso:

procdump.exe -u

Tipos de Despejo:

Condições:

Contrato de Licença:

Use a opção de linha de comando -accepteula para aceitar automaticamente o contrato de licença da Sysinternals.

Encerramento Automatizado:

-cancel <Target Process PID>

Usar essa opção ou definir um evento com o nome ProcDump-<PID> é o mesmo que digitar Ctrl+C para encerrar o ProcDump. O encerramento garante que o processo seja retomado se uma captura estiver ativa. O cancelamento se aplica a TODAS as instâncias do ProcDump que monitoram o processo.

Nome do arquivo:

Nome do arquivo de despejo padrão: PROCESSNAME_YYMMDD_HHMMSS.dmp

Há suporte para os seguintes substituições:

Exemplos

• Grave um mini despejo de um processo chamado “notepad” (somente uma correspondência pode existir):

  C:\>procdump notepad
  

• Grave um despejo Full de um processo com PID “4572”:

  C:\>procdump -ma 4572
  

• Grave um despejo Mini e, em seguida, um despejo completo de um processo com PID “4572”:

  C:\>procdump -mm -ma 4572
  

• Grave três despejos Mini de cinco segundos de um processo chamado “notepad”:

  C:\>procdump -n 3 -s 5 notepad
  

• Grave até três despejos Mini de um processo chamado “consume” quando exceder 20% do uso da CPU por cinco segundos:

  C:\>procdump -n 3 -s 5 -c 20 consume
  

• Grave um despejo Mini para um processo chamado “hang.exe” quando uma de suas janelas não responder por mais de cinco segundos:

  C:\>procdump -h hang.exe
  

• Grave um despejo Mini e Kernel para um processo chamado “hang.exe” quando uma de suas janelas não responder por mais de cinco segundos:

  C:\>procdump -ma -mk -h hang.exe
  

• Grave um despejo Mini de um processo chamado “outlook” quando o uso total da CPU do sistema exceder 20% por dez segundos:

  C:\>procdump outlook -s 10 -p "\Processor(_Total)\% Processor Time" 20
  

• Grave um despejo Full de um processo chamado “outlook” quando a contagem de identificadores do Outlook exceder 10.000:

  C:\>procdump -ma outlook -p "\Process(Outlook)\Handle Count" 10000
  

• Grave um despejo Full do PID 1234 de “svchost”, Instância 87, quando a contagem de identificadores exceder 10.000:

  C:\>procdump -ma 1234 -p "\Process(svchost#87)\Handle Count" 10000
  

  Observação: Vários Contadores de Instância
  Se houver várias instâncias do contador, você precisará incluir o Nome e/ou o Número da instância.

  \Processor(NNN)\% Processor Time
  \Thermal Zone Information(<name>)\Temperature
  \Process(<name>[#NNN])\<counter>
  

  Os sistemas operacionais mais antigos exigem que você acrescente o PID para contadores \Process.

  \Process(<name>[_PID])\<counter>
  

  Dica: use o Monitor de Desempenho para exibir os contadores (diferenciação de maiúsculas e minúsculas).
  Dica: para contadores baseados em \Process(*), use o PowerShell para mapear um PID para seu #NNN.

  Get-Counter -Counter "\Process(*)\ID Process"
  

• Grave um despejo Full para uma exceção de segunda chance:

  C:\>procdump -ma -e w3wp.exe
  

• Grave um despejo Full para uma exceção de primeira e segunda chance:

  C:\>procdump -ma -e 1 w3wp.exe
  

• Grave um despejo Full para uma mensagem de cadeia de caracteres de depuração:

  C:\>procdump -ma -l w3wp.exe
  

• Grave até dez despejos Full de cada exceção de primeira ou segunda chance de w3wp.exe:

  C:\>procdump -ma -n 10 -e 1 w3wp.exe
  

• Grave até dez despejos Full se o código/nome/msg de uma exceção contiver “NotFound”:

  C:\>procdump -ma -n 10 -e 1 -f NotFound w3wp.exe
  

• Grave até dez despejos Full se uma mensagem de cadeia de caracteres de depuração contiver “NotFound”:

  C:\>procdump -ma -n 10 -l -f NotFound w3wp.exe
  

• Aguarde um processo chamado “notepad” (e monitore-o em busca de exceções):

  C:\>procdump -e -w notepad
  

• Inicie um processo chamado “notepad” (e monitore-o em busca de exceções):

  C:\>procdump -e -x c:\dumps notepad
  

• Registre-se para iniciar e tente ativar um “aplicativo” da Store. Uma nova instância do ProcDump será iniciada quando for ativada:

  C:\>procdump -e -x c:\dumps Microsoft.BingMaps_8wekyb3d8bbwe!AppexMaps
  

• Registre-se para iniciar um “pacote” da Store. Uma nova instância do ProcDump será iniciada quando for ativada (manualmente):

  C:\>procdump -e -x c:\dumps Microsoft.BingMaps_1.2.0.136_x64__8wekyb3d8bbwe
  

• Grave um despejo MiniPlus do Microsoft Exchange Information Store quando ele tiver uma exceção sem tratamento:

  C:\>procdump -mp -e store.exe
  

• Exibir sem gravar um despejo, os códigos/nomes de exceção de w3wp.exe:

  C:\>procdump -e 1 -f "" w3wp.exe
  

• Windows 7/8.0; use a Reflexão para reduzir a interrupção de cinco gatilhos consecutivos:

  C:\>procdump -r -ma -n 5 -s 15 wmplayer.exe
  

• Windows 8.1+; use o PSS para reduzir a interrupção de cinco gatilhos simultâneos:

  C:\>procdump -r 5 -ma -n 5 -s 15 wmplayer.exe
  

• Instale o ProcDump como o depurador postmortem (AeDebug):

  C:\>procdump -ma -i c:\dumps
  

  ..ou..

  C:\Dumps>procdump -ma -i
  

• Desinstale o ProcDump como o depurador postmortem (AeDebug):

  C:\>procdump -u
  

Veja uma lista de linhas de comando de exemplo (os exemplos são listados acima):

C:\>procdump -? -e

Links Relacionados

• Livro sobre os Componentes Internos do Windows A página oficial de atualizações e erratas do livro definitivo sobre os componentes internos do Windows, de Mark Russinovich e David Solomon.
• Referência do Administrador do Windows Sysinternals O guia oficial dos utilitários Sysinternals, por Mark Russinovich e Aaron Margosis, incluindo descrições de todas as ferramentas, seus recursos, como usá-las para solucionar problemas e exemplos de casos de seu uso no mundo real.

Baixar o ProcDump (714 KB)

Baixar o ProcDump para Linux (GitHub)

É executado em:

• Cliente: Windows 8.1 e superior.
• Servidor: Windows Server 2012 e superior.

Saiba mais

• Ferramentas de Desfragmentação: #9 – ProcDump Este episódio de Ferramentas de Desfragmentação aborda o que a ferramenta captura e as durações de interrupção esperadas
• Ferramentas de Desfragmentação: #10 – ProcDump – Gatilhos Este episódio aborda as opções de gatilho em particular exceções de primeira e segunda chance
• Ferramentas de desfragmentação: #11 – ProcDump – Windows 8 e Monitor de Processo Este episódio aborda o suporte a aplicativos modernos e o suporte ao registro em log do Monitor de Processo