ProcDump v11.0

作成者: Mark Russinovich、Andrew Richards

公開日: 2022 年 11 月 3 日

ProcDump をダウンロード (714 KB)

ProcDump for Linux のダウンロード (GitHub)
ProcDump for Mac をダウンロードする (GitHub)

^{ZoomIt を使用して作成}

はじめに

ProcDump はコマンド ライン ユーティリティであり、その主な目的は、アプリケーションで CPU スパイクを監視し、スパイク中にクラッシュ ダンプを生成することで、管理者または開発者がそれらを使用してスパイクの原因を特定できようにすることです。 ProcDump には、(Windows とタスク マネージャーで使用されるウィンドウ ハングの定義と同じ定義を使用した) ハングしたウィンドウの監視と、未処理の例外の監視も含まれていて、システム パフォーマンス カウンターの値に基づいてダンプを生成できます。 他のスクリプトに埋め込むことができる一般的なプロセス ダンプ ユーティリティとしても機能します。

ProcDump の使用

キャプチャの使用方法:

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, ...]}
            }

インストールの使用方法:

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

アンインストールの使用方法:

procdump.exe -u

ダンプの種類:

条件:

使用許諾契約書:

-accepteula コマンド ライン オプションを使用して、Sysinternals 使用許諾契約書に自動的に同意します。

自動終了:

-cancel <Target Process PID>

このオプションを使用すること、または名前 ProcDump-<PID> を使用してイベントを設定することは、Ctrl+C キーを押して ProcDump を正常に終了することと同じです。 正常に終了すると、キャプチャがアクティブである場合にプロセスが再開されます。 取り消しは、プロセスを監視しているすべての ProcDump インスタンスに適用されます。

ファイル名:

既定のダンプ ファイル名: PROCESSNAME_YYMMDD_HHMMSS.dmp

次の代替名がサポートされています。

例

• 'notepad' という名前のプロセスの Mini ダンプを書き込みます (一致するものは 1 つだけ存在できます)。

  C:\>procdump notepad
  

• PID '4572' のプロセスの Full ダンプを書き込みます。

  C:\>procdump -ma 4572
  

• 最初に PID '4572' のプロセスの Mini ダンプを書き込み、次に Full ダンプを書き込みます。

  C:\>procdump -mm -ma 4572
  

• 'notepad' という名前のプロセスの 3 つの Mini ダンプを 5 秒間隔で書き込みます。

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

• CPU 使用率が 5 秒間にわたって 20% を超えた場合に、'consume' という名前のプロセスの Mini ダンプを最大で 3 つ書き込みます。

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

• そのウィンドウの 1 つが 5 秒以上にわたって応答しない場合に、'hang.exe' という名前のプロセスの Mini ダンプを書き込みます。

  C:\>procdump -h hang.exe
  

• そのウィンドウの 1 つが 5 秒以上にわたって応答しない場合に、'hang.exe' という名前のプロセスの Full ダンプと Kernel ダンプを書き込みます。

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

• システムの合計 CPU 使用率が 10 秒間にわたって 20% を超えた場合に、'outlook' という名前のプロセスの Mini ダンプを書き込みます。

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

• Outlook のハンドル数が 10,000 を超えた場合に、'outlook' という名前のプロセスの Full ダンプを書き込みます。

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

• ハンドル数が 10,000 を超えた場合に、'svchost' PID 1234、インスタンス #87 の Full ダンプを書き込みます。

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

  注: 複数のインスタンス カウンター
  カウンターのインスタンスが複数ある場合は、名前またはインスタンス番号を含める必要があります。

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

  古い OS では、\Process カウンターの PID を追加する必要があります。

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

  ヒント: カウンターを表示するには、パフォーマンス モニターを使用します (特に大文字と小文字の区別に関して)。
  ヒント:\Process(*) ベースのカウンターの場合は、PowerShell を使用して PID をその #NNN にマップします。

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

• 2 回目の例外の Full ダンプを書き込みます。

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

• 1 回目または 2 回目の例外の Full ダンプを書き込みます。

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

• デバッグ文字列メッセージの Full ダンプを書き込みます。

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

• w3wp.exe の 1 回目または 2 回目の例外のそれぞれの Full ダンプを最大で 10 個書き込みます。

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

• 例外のコード/名前/メッセージに 'NotFound' が含まれている場合に、Full ダンプを最大で 10 個書き込みます。

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

• デバッグ文字列メッセージに 'NotFound' が含まれている場合に、Full ダンプを最大で 10 個書き込みます。

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

• 'notepad' という名前のプロセスを待機します (さらに、例外があるかどうかを監視します)。

  C:\>procdump -e -w notepad
  

• 'notepad' という名前のプロセスを起動します (さらに、例外があるかどうかを監視します)。

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

• ストア "アプリケーション" の起動に登録し、そのアクティブ化を試みます。 アクティブ化されると、新しい ProcDump インスタンスが起動します。

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

• ストア "パッケージ" の起動に登録します。 (手動で) アクティブ化されると、新しい ProcDump インスタンスが起動します。

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

• 未処理の例外がある場合に、Microsoft Exchange Information Store の MiniPlus ダンプを書き込みます。

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

• ダンプを書き込まずに、w3wp.exe の例外コード/名前を表示します。

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

• Windows 7/8.0: リフレクションを使用して、5 つの連続するトリガーに対する停止を減らします。

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

• Windows 8.1 以降: PSS を使用して、5 つの同時トリガーに対する停止を減らします。

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

• (AeDebug) 事後デバッガーとして ProcDump をインストールします。

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

  ..または..

  C:\Dumps>procdump -ma -i
  

• (AeDebug) 事後デバッガーとして ProcDump をアンインストールします。

  C:\>procdump -u
  

コマンド ラインの例の一覧を表示します (例は上記のとおりです)。

C:\>procdump -? -e

関連リンク

• Windows 内部マニュアル Mark Russinovich と David Solomon の共著による Windows 内部解説書の決定版。更新情報や正誤表が掲載される公式ページです。
• Windows Sysinternals 管理者リファレンス Mark Russinovich と Aaron Margosis の共著による、Sysinternals ユーティリティ公式ガイド。すべてのツールの説明、機能解説、トラブルシューティング時の使い方、実践的な使用状況の例が示されています。

ProcDump をダウンロード (714 KB)

ProcDump for Linux のダウンロード (GitHub)
ProcDump for Mac をダウンロードする (GitHub)

実行場所:

• クライアント: Windows 8.1以降。
• サーバー: Windows Server 2012 およびそれ以降。

詳細情報

• デフラグ ツール: #9 - ProcDump デフラグ ツールのこのエピソードでは、ツールがキャプチャする内容と、予期される停止期間について説明します
• デフラグ ツール: #10 - ProcDump - トリガー このエピソードでは、特定の 1 回目と 2 回目の例外でのトリガー オプションについて説明します
• デフラグ ツール: #11 - ProcDump - Windows 8 とプロセス モニター このエピソードでは、最新のアプリケーション サポートとプロセス モニター ログのサポートについて説明します