> ## 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.

# Xbox One 网络捕获

> 使用 xbtrace 在 XBOX 开发套件上启动和停止网络数据包捕获，然后在 Microsoft Message Analyzer 或 Network Monitor 中分析 ETL 捕获。

本主题帮助你了解如何在 XBOX 开发套件上使用网络数据包捕获。在调试 Microsoft 游戏开发工具包 (GDK) 游戏时，你可能想分析进出 XBOX 开发套件的网络流量。[Fiddler](https://docs.xbox.com/zh-CN/build/console-features/networking/tools/fiddler-setup-networking.md) 是一款流行的工具，可用于监控 HTTP、HTTPS 和 WebSocket 流量。但 Fiddler 无法捕获其他类型的网络流量。要捕获 XBOX 开发套件与外界之间 *所有* 网络数据包流量的追踪信息，可以先使用本主题所述的网络追踪捕获功能，然后使用强大的工具分析这些流量。

捕获的内容处于“电缆上”状态。这包括 HTTPS 流量的 TLS (Transport Layer Security) 加密以及你在套接字上使用的任何加密。这使得无法直接分析任何加密内容。但请记住，任何意外流量、数据包的大小或频率，以及意外通信流的端点，往往就足以发现网络代码中的问题。要调试网络问题并不总是需要检查数据包内容。

如果你想在调试时查看消息内容，可临时禁用你想检查内容的那类流量的加密。

网络捕获还可以用于识别任何意外未被加密和保护的流量。

## 捕获网络数据包

要启用和停用网络流量捕获，请使用 [Trace (xbtrace.exe) (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbtrace.md) 工具。

### 启动网络捕获

要启动网络捕获，请使用 `xbtrace start netcap` 命令。这会在默认主机上启动网络捕获。

要在非默认主机上启动追踪，请使用 `/X:` 参数。

### 停止网络捕获

要停止网络捕获，请使用 `xbtrace stop`。默认情况下，捕获会保存为当前目录下的 *xbtrace.etl*。要保存到不同的位置或文件名，请在 `stop` 之后提供路径与文件名。例如，`xbtrace stop c:\temp\sample.etl` 会将追踪文件保存为 *c:\temp\sample.etl*。如果你指定了已存在的文件名，`xbtrace` 会给出提示信息，追踪会继续运行。

> [!NOTE]
>
> 指定已存在的文件名时，不会丢失主机上的追踪数据。当前无法覆盖已存在的追踪文件。你必须删除现有文件，或者为新追踪指定另一个文件名。

要在非默认主机上停止捕获，请使用 `/X` 参数指定主机地址。

## 使用网络捕获数据

以下工具可以打开原始网络捕获文件。请根据你的偏好选择一款工具。

* 使用 [Microsoft Message Analyzer (MMA)](https://github.com/riverar/messageanalyzer-archive) 打开 etl 网络捕获并查看网络事件。可以直接在 MMA 中分析捕获文件。你也可以使用 MMA 将捕获的数据包数据保存为 PCAP 文件，然后在 Fiddler 或 Wireshark 等其他工具中打开进行分析。

  > [!NOTE]
  >
  > Microsoft Message Analyzer 已归档且不再维护。

* 使用 [Network Monitor (netmon)](https://www.microsoft.com/download/details.aspx?id=4865) 打开网络捕获 etl 文件并查看数据包。要充分解析所有网络事件，请在 *Tools* > *Options* > *Parser Profiles* 下设置 *'Windows Parser Profile'*。然后可以直接在 netmon 中分析捕获的原始网络事件。

## 另请参阅

[Trace (xbtrace.exe) (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbtrace.md)

[Microsoft Message Analyzer 操作指南](https://msdn.microsoft.com/library/jj649776.aspx)


## Related topics

- [用于监视和调试 GDK 网络流量的工具](https://docs.xbox.com/zh-CN/build/console-features/networking/tools/tools-networking-toc.md)
- [XBOX 开发套件上的网络压力测试](https://docs.xbox.com/zh-CN/build/console-features/networking/tools/netstress-networking.md)
- [网络](https://docs.xbox.com/zh-CN/build/console-features/networking/gc-networking-toc.md)
- [工具](https://docs.xbox.com/zh-CN/build/console-features/networking/tools/index.md)
- [使用 XBOX 多人游戏分析工具检查和修改网络流量](https://docs.xbox.com/zh-CN/tools/tools-services/live-xbox-multiplayer-analysis-tool.md)