xbtrace.exe 命令列工具不再支援擷取 XBOX Services API (XSAPI) 流量。對於 Microsoft Game Development Kit (GDK) 遊戲,請使用 Fiddler 擷取 XBOX Live 網路呼叫,然後使用 XBOX Live Trace Analyzer 分析 Fiddler 追蹤。如需詳細資訊,請參閱用於檢閱服務呼叫的 Trace Analyzer。
| 命令 | 描述 |
|---|---|
| xbtrace start netcap | 開始網路追蹤擷取 |
| xbtrace stop | 停止並儲存追蹤 |
| xbtrace log | 在遠端主機上的事件追蹤工作階段期間收集記錄 |
開始網路追蹤擷取
| 欄 1 |
|---|
| **xbtrace **start tracetype [/X[:]address[+<accesskey>]] |
| 選項 | 描述 |
|---|---|
| start | 開始網路追蹤擷取。如果已有追蹤正在進行,xbtrace 會顯示相關訊息,並繼續擷取追蹤資料。 |
| tracetype | 要開始的追蹤類型。可用的追蹤類型如下。 advancedmp:進階多人遊戲擷取。 使用此類型的追蹤擷取進階多人遊戲追蹤,其中包含偵錯多人遊戲工作階段問題所需的資訊。進階多人遊戲追蹤工作階段會在執行 start 與 stop 時自動收集網路狀態記錄。呼叫 stop 時,所有追蹤檔案與網路狀態記錄都會複製到開發 PC 上的追蹤工作階段目錄中。在進階多人遊戲追蹤工作階段期間,可以使用 log netstate 命令收集其他網路狀態記錄。若要擷取多人遊戲工作階段的目前狀態,請使用下列步驟。 1. 使用 xbTrace start advancedmp 開始追蹤。 2. 使用 log netstate 在各個關注點擷取目前工作階段的快照。 3. 使用 xbtrace stop 停止追蹤。 netcap:網路封包擷取。 |
| /X[:]address[+<accesskey>] | - 使用此選項可指定目標主機的主機名稱或位址 (在主機上顯示為 Tools IP),而不需變更預設主機。如需為主機設定主機名稱的詳細資訊,請參閱為主機 IP 位址設定主機名稱。 - 如果您不使用此選項,則會使用預設主機 (先前由連線 (xbconnect.exe) 設定)。 - 使用 accesskey 字串,只為擁有存取金鑰的人員提供主機存取權。 - 使用 xbconfig accesskey=your-key 命令設定存取金鑰,然後重新啟動主機,讓存取金鑰生效。 - 若要存取已設定存取金鑰的主機,請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。 - 如果在使用 xbconnect 設定預設主機時提供了存取金鑰,該存取金鑰會儲存為預設主機位址的一部分。 - 如需存取金鑰的詳細資訊,請參閱 xbconfig accesskey。 |
停止並儲存網路追蹤擷取
| 欄 1 |
|---|
| xbtrace [stop [etlfile] ] [/X[:]address[+<accesskey>]] |
| 選項 | 描述 |
|---|---|
| stop [etlfile] | 停止並儲存目前執行中的網路追蹤。etlfile 是所儲存追蹤資料的選擇性檔案名稱 (可選擇性包含路徑)。如果您未指定檔案名稱,擷取的資料會儲存在目前目錄中名為 xbtrace.etl 的檔案。如果您指定不含路徑的檔案名稱,檔案會以指定的名稱儲存在目前目錄中。如果您指定的檔案已存在,xbtrace 會顯示相關訊息,並繼續擷取追蹤資料。目前沒有強制覆寫檔案的選項。 |
| /X[:]address[+<accesskey>] | - 使用此選項可指定目標主機的主機名稱或位址 (在主機上顯示為 Tools IP),而不需變更預設主機。如需為主機設定主機名稱的詳細資訊,請參閱為主機 IP 位址設定主機名稱。 - 如果您不使用此選項,則會使用預設主機 (先前由連線 (xbconnect.exe) 設定)。 - 使用 accesskey 字串,只為擁有存取金鑰的人員提供主機存取權。 - 使用 xbconfig accesskey=your-key 命令設定存取金鑰,然後重新啟動主機,讓存取金鑰生效。 - 若要存取已設定存取金鑰的主機,請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。 - 如果在使用 xbconnect 設定預設主機時提供了存取金鑰,該存取金鑰會儲存為預設主機位址的一部分。 - 如需存取金鑰的詳細資訊,請參閱 xbconfig accesskey。 |
在遠端主機上的事件追蹤工作階段期間收集記錄
| 欄 1 |
|---|
| **xbtrace **log logtype [/X[:]address[+<accesskey>]] |
| 選項 | 描述 |
|---|---|
| log | 在遠端主機上的事件追蹤工作階段期間收集記錄。 |
| logtype | 要收集的記錄類型。可用的記錄類型如下。 netstate:網路狀態 產生的追蹤檔案會放在開發 PC 上名稱包含 “xbtrace” 與時間戳記的目錄中。 |
| /X[:]address[+<accesskey>] | - 使用此選項可指定目標主機的主機名稱或位址 (在主機上顯示為 Tools IP),而不需變更預設主機。如需為主機設定主機名稱的詳細資訊,請參閱為主機 IP 位址設定主機名稱。 - 如果您不使用此選項,則會使用預設主機 (先前由連線 (xbconnect.exe) 設定)。 - 使用 accesskey 字串,只為擁有存取金鑰的人員提供主機存取權。 - 使用 xbconfig accesskey=your-key 命令設定存取金鑰,然後重新啟動主機,讓存取金鑰生效。 - 若要存取已設定存取金鑰的主機,請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。 - 如果在使用 xbconnect 設定預設主機時提供了存取金鑰,該存取金鑰會儲存為預設主機位址的一部分。 - 如需存取金鑰的詳細資訊,請參閱 xbconfig accesskey。 |
範例
xbtrace start netcap
xbtrace start advancedmp
xbtrace stop
xbtrace stop c:\netcaptemp\netcap.etl
xbtrace stop c:\advancedmptemp
xbtrace log netstate
