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.
| Comando | Descrição |
|---|---|
| xbtrace start netcap | Inicia uma captura de rastreamento de rede |
| xbtrace stop | Interrompe e salva um rastreamento |
| 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[+<accesskey>]] |
| 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[+<accesskey>] | - 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. - Se você não usar esta opção, será usado o console padrão (definido anteriormente por Conexão (xbconnect.exe)). - 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, 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. |
Interromper e salvar uma captura de rastreamento de rede
| Coluna 1 |
|---|
| xbtrace [stop [etlfile] ] [/X[:]address[+<accesskey>]] |
| 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[+<accesskey>] | - 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. - Se você não usar esta opção, será usado o console padrão (definido anteriormente por Conexão (xbconnect.exe)). - 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, 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. |
Coletar um log durante uma sessão de rastreamento de eventos no console remoto
| Coluna 1 |
|---|
| **xbtrace **log logtype [/X[:]address[+<accesskey>]] |
| 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[+<accesskey>] | - 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. - Se você não usar esta opção, será usado o console padrão (definido anteriormente por Conexão (xbconnect.exe)). - 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, 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. |
Exemplo
xbtrace start netcap
xbtrace start advancedmp
xbtrace stop
xbtrace stop c:\netcaptemp\netcap.etl
xbtrace stop c:\advancedmptemp
xbtrace log netstate