> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 追蹤 (xbtrace.exe)

> 追蹤 (xbtrace.exe)

使用此工具在主機上啟動與停止詳細追蹤。

> [!NOTE]
>
> xbtrace.exe 命令列工具不再支援擷取 XBOX Services API (XSAPI) 流量。對於 Microsoft Game Development Kit (GDK) 遊戲，請使用 Fiddler 擷取 XBOX Live 網路呼叫，然後使用 XBOX Live Trace Analyzer 分析 Fiddler 追蹤。如需詳細資訊，請參閱[用於檢閱服務呼叫的 Trace Analyzer](https://docs.xbox.com/zh-TW/tools/tools-services/live-trace-analyzer.md)。

此工具提供下列子命令與功能。

| 命令 | 描述 |
| - | - |
| [xbtrace start netcap](#xbtrace_start_netcap) | 開始網路追蹤擷取 |
| [xbtrace stop](#xbtrace_stop) | 停止並儲存追蹤 |
| [xbtrace log](#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 位址設定主機名稱](https://docs.xbox.com/zh-TW/home/setup-install/dev-kit-settings/setting-a-hostname.md)。 - 如果您不使用此選項，則會使用預設主機 (先前由[連線 (xbconnect.exe)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconnect.md) 設定)。 - 使用 *accesskey* 字串，只為擁有存取金鑰的人員提供主機存取權。 - 使用 **xbconfig** **accesskey=your-key** 命令設定存取金鑰，然後重新啟動主機，讓存取金鑰生效。 - 若要存取已設定存取金鑰的主機，請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。 - 如果在使用 [xbconnect](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconnect.md) 設定預設主機時提供了存取金鑰，該存取金鑰會儲存為預設主機位址的一部分。 - 如需存取金鑰的詳細資訊，請參閱 [xbconfig accesskey](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconfig.md)。 |

## 停止並儲存網路追蹤擷取

| 欄 1 |
| - |
| **xbtrace** \[*stop* \[etlfile] ] \[/X\[:]*address\[+\<accesskey>]*] |

| 選項 | 描述 |
| - | - |
| *stop* \[etlfile] | 停止並儲存目前執行中的網路追蹤。**etlfile** 是所儲存追蹤資料的選擇性檔案名稱 (可選擇性包含路徑)。如果您未指定檔案名稱，擷取的資料會儲存在目前目錄中名為 xbtrace.etl 的檔案。如果您指定不含路徑的檔案名稱，檔案會以指定的名稱儲存在目前目錄中。如果您指定的檔案已存在，**xbtrace** 會顯示相關訊息，並繼續擷取追蹤資料。目前沒有強制覆寫檔案的選項。 |
| /X\[:]*address\[+\<accesskey>]* | - 使用此選項可指定目標主機的主機名稱或位址 (在主機上顯示為 **Tools IP**)，而不需變更預設主機。如需為主機設定主機名稱的詳細資訊，請參閱[為主機 IP 位址設定主機名稱](https://docs.xbox.com/zh-TW/home/setup-install/dev-kit-settings/setting-a-hostname.md)。 - 如果您不使用此選項，則會使用預設主機 (先前由[連線 (xbconnect.exe)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconnect.md) 設定)。 - 使用 *accesskey* 字串，只為擁有存取金鑰的人員提供主機存取權。 - 使用 **xbconfig** **accesskey=your-key** 命令設定存取金鑰，然後重新啟動主機，讓存取金鑰生效。 - 若要存取已設定存取金鑰的主機，請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。 - 如果在使用 [xbconnect](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconnect.md) 設定預設主機時提供了存取金鑰，該存取金鑰會儲存為預設主機位址的一部分。 - 如需存取金鑰的詳細資訊，請參閱 [xbconfig accesskey](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconfig.md)。 |

## 在遠端主機上的事件追蹤工作階段期間收集記錄

| 欄 1 |
| - |
| \*\*xbtrace \*\**log* *logtype* \[/X\[:]*address\[+\<accesskey>]*] |

| 選項 | 描述 |
| - | - |
| *log* | 在遠端主機上的事件追蹤工作階段期間收集記錄。 |
| *logtype* | 要收集的記錄類型。可用的記錄類型如下。 **netstate**：網路狀態 產生的追蹤檔案會放在開發 PC 上名稱包含 "xbtrace" 與時間戳記的目錄中。 |
| /X\[:]*address\[+\<accesskey>]* | - 使用此選項可指定目標主機的主機名稱或位址 (在主機上顯示為 **Tools IP**)，而不需變更預設主機。如需為主機設定主機名稱的詳細資訊，請參閱[為主機 IP 位址設定主機名稱](https://docs.xbox.com/zh-TW/home/setup-install/dev-kit-settings/setting-a-hostname.md)。 - 如果您不使用此選項，則會使用預設主機 (先前由[連線 (xbconnect.exe)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconnect.md) 設定)。 - 使用 *accesskey* 字串，只為擁有存取金鑰的人員提供主機存取權。 - 使用 **xbconfig** **accesskey=your-key** 命令設定存取金鑰，然後重新啟動主機，讓存取金鑰生效。 - 若要存取已設定存取金鑰的主機，請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。 - 如果在使用 [xbconnect](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconnect.md) 設定預設主機時提供了存取金鑰，該存取金鑰會儲存為預設主機位址的一部分。 - 如需存取金鑰的詳細資訊，請參閱 [xbconfig accesskey](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconfig.md)。 |

## 範例

```
xbtrace start netcap
xbtrace start advancedmp
xbtrace stop
xbtrace stop c:\netcaptemp\netcap.etl
xbtrace stop c:\advancedmptemp
xbtrace log netstate  
```

## 另請參閱

[命令列工具](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/commandlinetools.md)

[XTF 傳輸錯誤](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors.md)

[連線 (xbconnect.exe)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconnect.md)


## Related topics

- [網路頁面](https://docs.xbox.com/zh-TW/tools/tools-console/devhome/devhome-networking.md)
- [Dev Home 的 XBOX Live 頁面](https://docs.xbox.com/zh-TW/tools/tools-console/devhome/devhome-live.md)
- [主機開發的命令列工具](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/commandlinetools.md)
- [命令列工具](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/index.md)
- [事件追蹤 (wdtrace.exe)](https://docs.xbox.com/zh-TW/tools/tools-console/console_commandlinetools/wdtrace.md)