> ## 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. # Rastreamento (xbtrace.exe) > Rastreamento (xbtrace.exe) Use esta ferramenta para iniciar e interromper o rastreamento detalhado em um console. > [!NOTE] > > A ferramenta de linha de comando xbtrace.exe não dá mais suporte à captura do tráfego da XBOX Services API (XSAPI). Para títulos do Microsoft Game Development Kit (GDK), use o Fiddler para capturar as chamadas de rede do XBOX Live. Em seguida, use o XBOX Live Trace Analyzer para analisar o rastreamento do Fiddler. Para obter mais informações, veja [Trace Analyzer para revisar chamadas de serviço](https://docs.xbox.com/pt-BR/tools/tools-services/live-trace-analyzer.md). Essa ferramenta fornece os subcomandos e funções a seguir. | Comando | Descrição | | - | - | | [xbtrace start netcap](#xbtrace_start_netcap) | Inicia uma captura de rastreamento de rede | | [xbtrace stop](#xbtrace_stop) | Interrompe e salva um rastreamento | | [xbtrace log](#xbtrace_log) | Coleta um log durante uma sessão de rastreamento de eventos no console remoto | ## Iniciar uma captura de rastreamento de rede | Coluna 1 | | - | | \*\*xbtrace \*\**start* *tracetype* \[/X\[:]*address\[+\]*] | | Opção | Descrição | | - | - | | *start* | Inicia uma captura de rastreamento de rede. Se um rastreamento já estiver em andamento, o **xbtrace** exibirá uma mensagem informando isso e continuará capturando os dados do rastreamento. | | *tracetype* | O tipo de rastreamento a ser iniciado. Os seguintes tipos de rastreamento estão disponíveis. **advancedmp** - Captura multijogador avançada. Use esse tipo de rastreamento para obter rastreamentos multijogador avançados que contêm as informações necessárias para depurar problemas em sessões multijogador. As sessões de rastreamento multijogador avançadas coletam automaticamente um log do estado da rede quando **start** e **stop** são executados. Quando **stop** é chamado, todos os arquivos de rastreamento e logs de estado da rede são copiados para o PC de desenvolvimento em um diretório de sessão de rastreamento. Logs adicionais do estado da rede podem ser coletados durante as sessões de rastreamento multijogador avançadas usando o comando **log netstate**. Para capturar o estado atual de uma sessão multijogador, siga estas etapas. 1. Use **xbTrace start advancedmp** para iniciar um rastreamento. 2. Use **log netstate** para obter um instantâneo da sessão atual em vários pontos de interesse. 3. Use **xbtrace stop** para interromper o rastreamento. **netcap** - Captura de pacotes de rede. | | /X\[:]*address\[+\]* | - Use esta opção para especificar o nome do host ou o endereço (mostrado como **Tools IP** no console) de um console de destino sem alterar o console padrão. Para obter detalhes sobre como definir um nome de host para um console, veja [Definir um nome de host para o endereço IP do console](https://docs.xbox.com/pt-BR/home/setup-install/dev-kit-settings/setting-a-hostname.md). - Se você não usar esta opção, será usado o console padrão (definido anteriormente por [Conexão (xbconnect.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md)). - Use a string *accesskey* para fornecer acesso ao console somente às pessoas que têm a chave de acesso. - Defina a chave de acesso usando o comando **xbconfig** **accesskey=your-key** e, em seguida, reinicie o console para que a chave de acesso entre em vigor. - Para acessar um console configurado com uma chave de acesso, inclua um sinal de adição (+) e a chave de acesso após o endereço IP ou o nome do host do console. - Se uma chave de acesso for fornecida quando o console padrão for definido por [xbconnect](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md), a chave de acesso será armazenada como parte do endereço do console padrão. - Para obter mais informações sobre chaves de acesso, veja [xbconfig accesskey](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconfig.md). | ## Interromper e salvar uma captura de rastreamento de rede | Coluna 1 | | - | | **xbtrace** \[*stop* \[etlfile] ] \[/X\[:]*address\[+\]*] | | Opção | Descrição | | - | - | | *stop* \[etlfile] | Interrompe e salva o rastreamento de rede em execução no momento. **etlfile** é um nome de arquivo opcional (com um caminho opcional) para os dados de rastreamento salvos. Se você não especificar um nome de arquivo, os dados capturados serão salvos em um arquivo chamado xbtrace.etl no diretório atual. Se você especificar um nome de arquivo sem um caminho, o arquivo será salvo com o nome especificado no diretório atual. Se o arquivo especificado já existir, o **xbtrace** exibirá uma mensagem informando isso e continuará capturando os dados do rastreamento. No momento, não há opção para forçar a substituição do arquivo. | | /X\[:]*address\[+\]* | - Use esta opção para especificar o nome do host ou o endereço (mostrado como **Tools IP** no console) de um console de destino sem alterar o console padrão. Para obter detalhes sobre como definir um nome de host para um console, veja [Definir um nome de host para o endereço IP do console](https://docs.xbox.com/pt-BR/home/setup-install/dev-kit-settings/setting-a-hostname.md). - Se você não usar esta opção, será usado o console padrão (definido anteriormente por [Conexão (xbconnect.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md)). - Use a string *accesskey* para fornecer acesso ao console somente às pessoas que têm a chave de acesso. - Defina a chave de acesso usando o comando **xbconfig** **accesskey=your-key** e, em seguida, reinicie o console para que a chave de acesso entre em vigor. - Para acessar um console configurado com uma chave de acesso, inclua um sinal de adição (+) e a chave de acesso após o endereço IP ou o nome do host do console. - Se uma chave de acesso for fornecida quando o console padrão for definido por [xbconnect](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md), a chave de acesso será armazenada como parte do endereço do console padrão. - Para obter mais informações sobre chaves de acesso, veja [xbconfig accesskey](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconfig.md). | ## Coletar um log durante uma sessão de rastreamento de eventos no console remoto | Coluna 1 | | - | | \*\*xbtrace \*\**log* *logtype* \[/X\[:]*address\[+\]*] | | Opção | Descrição | | - | - | | *log* | Coleta um log durante uma sessão de rastreamento de eventos no console remoto. | | *logtype* | O tipo de log a ser coletado. O seguinte tipo de log está disponível. **netstate** - Estado da rede Os arquivos de rastreamento resultantes são colocados no PC de desenvolvimento em um diretório cujo nome inclui "xbtrace" e um carimbo de data/hora. | | /X\[:]*address\[+\]* | - Use esta opção para especificar o nome do host ou o endereço (mostrado como **Tools IP** no console) de um console de destino sem alterar o console padrão. Para obter detalhes sobre como definir um nome de host para um console, veja [Definir um nome de host para o endereço IP do console](https://docs.xbox.com/pt-BR/home/setup-install/dev-kit-settings/setting-a-hostname.md). - Se você não usar esta opção, será usado o console padrão (definido anteriormente por [Conexão (xbconnect.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md)). - Use a string *accesskey* para fornecer acesso ao console somente às pessoas que têm a chave de acesso. - Defina a chave de acesso usando o comando **xbconfig** **accesskey=your-key** e, em seguida, reinicie o console para que a chave de acesso entre em vigor. - Para acessar um console configurado com uma chave de acesso, inclua um sinal de adição (+) e a chave de acesso após o endereço IP ou o nome do host do console. - Se uma chave de acesso for fornecida quando o console padrão for definido por [xbconnect](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md), a chave de acesso será armazenada como parte do endereço do console padrão. - Para obter mais informações sobre chaves de acesso, veja [xbconfig accesskey](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconfig.md). | ## Exemplo ``` xbtrace start netcap xbtrace start advancedmp xbtrace stop xbtrace stop c:\netcaptemp\netcap.etl xbtrace stop c:\advancedmptemp xbtrace log netstate ``` ## Veja também [Ferramentas de linha de comando](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md) [Erros de transporte do XTF](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors.md) [Conexão (xbconnect.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md) ## Related topics - [Página Networking](https://docs.xbox.com/pt-BR/tools/tools-console/devhome/devhome-networking.md) - [Página XBOX Live do Dev Home](https://docs.xbox.com/pt-BR/tools/tools-console/devhome/devhome-live.md) - [Ferramentas de linha de comando para desenvolvimento em console](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md) - [Ferramentas de linha de comando](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/index.md) - [Rastreamento de eventos (wdtrace.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/console_commandlinetools/wdtrace.md)