pktmon start
パケット キャプチャとイベント コレクションを開始します。
構文
pktmon start [--capture [--counters-only] [--comp <selector>] [--type <type>] [--pkt-size <bytes>] [--flags <mask>]]
[--trace --provider <name> [--keywords <k>] [--level <n>] ...]
[--file-name <name>] [--file-size <size>] [--log-mode <mode>]
パケット キャプチャ パラメーター
パケット キャプチャとパケット カウンターを有効にするには、-c または --capture を使用し、オプションで次のオプション パラメーターを指定します。
| パラメーター | 説明 |
|---|---|
| -o, --counters-only | パケット カウンターのみを収集します。 パケット ログがありません。 |
| --comp | パケットをキャプチャするコンポーネントを選択します。 すべてのコンポーネント (all)、NIC のみ (nic)、またはコンポーネント ID の一覧を指定できます。 既定値は all です。 |
| --type | キャプチャするパケットを選択します。 all、flow、または drop を指定できます。 既定値は [すべて] です。 |
| --pkt-size <バイト> | 各パケットからログに記録するバイト数。 常にパケット全体をログに記録する場合は、これを 0 に設定します。 既定値は 128 バイトです。 |
| --flags <mask> | パケット キャプチャ中にログに記録される情報を制御する 16 進数のビット マスク。 既定値は 0x012 です。 パケット キャプチャ フラグは次のとおりです。 |
パケット キャプチャ フラグ
--flags パラメーター (上記を参照) には、以下のフラグが適用されます。
| フラグ | 説明 |
|---|---|
| 0x001 | 内部パケット モニター エラー。 |
| 0x002 | コンポーネント、カウンター、およびフィルターに関する情報。 この情報は、ログ ファイルの末尾に追加されます。 |
| 0x004 | NET_BUFFER_LIST グループの最初のパケットの送信元と送信先の情報。 |
| 0x008 | NDIS_NET_BUFFER_LIST_INFO 列挙からパケット メタデータを選択します。 |
| 0x010 | [--Pkt-size] パラメーターで指定したサイズに切り詰められた RAW パケット。 |
イベント コレクション パラメーター
イベント コレクションを有効にするには、-t または--trace を使用し、オプションで次のパラメーターを指定します。
| パラメーター | 説明 |
|---|---|
| -p, --provider <名前> | イベントプロバイダーの名前または GUID。 プロバイダーが複数の場合は、このパラメーターを複数回使用します。 |
| -k, --keywords <k> | 対応するプロバイダーについてログに記録するイベントを制御する 16 進数のビット マスク。 既定値は 0xFFFFFFFF です。 |
| -l, --level <n> | 対応するプロバイダーに関するログ記録レベル。 既定値は 4 (情報レベル) です。 |
ログ パラメーター
ログには、次のパラメーターを使用します。
| パラメーター | 説明 |
|---|---|
| -f, --file-name <名前> | ログ ファイル名。 既定値は PktMon.etl です。 |
| -s, --file-size <サイズ> | ログ ファイルの最大サイズ (MB)。 既定値は 512 MB です。 |
| -m, --log-mode | ログ モードを設定します (下記を参照)。 既定値は circular です。 |
ログ モード
-m または --log mode パラメーターには、次のモードが適用されます (上記を参照)。
| モード | 説明 |
|---|---|
| circular | ログがいっぱいになると、新しいイベントによって最も古いイベントが上書きされます。 |
| multi-file | ログがいっぱいになるたびに、新しいログファイルが作成されます。 ログ ファイルには連番が付けられます (PktMon1.etl、PktMon2.etl など)。キャプチャされるイベントの数に制限はありません。 |
| real-time | イベントとパケットをリアルタイムで画面に表示します。 ログ ファイルは作成されません。 監視を停止するには、Ctrl + C キーを使用します。 |
| memory | circular と同じですが、ログ全体がメモリに格納されます。 pktmon が停止したときにファイルに書き込まれます。 メモリ バッファー サイズは [--file-size] パラメーターで指定されます。 |
例
例 1: パケット キャプチャ
C:\Test> pktmon start --capture
例 2: パケット カウンターのみ
C:\Test> pktmon start --capture --counters-only
例 3: イベント ログ
C:\Test> pktmon start --trace -p Microsoft-Windows-TCPIP -p Microsoft-Windows-NDIS
例 4: イベント ログを使用するパケット キャプチャ
C:\Test> pktmon start --capture --trace -p Microsoft-Windows-TCPIP -k 0xFF -l 4