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

# Suivi (xbtrace.exe)

> Suivi (xbtrace.exe)

Utilisez cet outil pour démarrer et arrêter le suivi détaillé sur une console.

<Note>
  L'outil en ligne de commande xbtrace.exe ne prend plus en charge la capture du trafic de l'API des services XBOX (XSAPI). Pour les titres du Microsoft Game Development Kit (GDK), utilisez Fiddler pour capturer les appels réseau XBOX Live, puis utilisez XBOX Live Trace Analyzer pour analyser la trace Fiddler. Pour plus de renseignements, consultez [Trace Analyzer pour examiner les appels de service](/fr-CA/tools/tools-services/live-trace-analyzer).
</Note>

Cet outil fournit les sous-commandes et fonctions suivantes.

| Commande | Description |
| - | - |
| [xbtrace start netcap](#xbtrace_start_netcap) | Démarre une capture de trace réseau |
| [xbtrace stop](#xbtrace_stop) | Arrête et enregistre une trace |
| [xbtrace log](#xbtrace_log) | Collecte un journal pendant une session de suivi d'événements sur la console distante |

<a id="xbtrace_start_netcap" />

## Démarrer une capture de trace réseau

| Colonne 1 |
| - |
| \*\*xbtrace \*\**start* *tracetype* \[/X\[:]*address\[+\<accesskey>]*] |

| Option | Description |
| - | - |
| *start* | Démarre une capture de trace réseau. Si une trace est déjà en cours, <b>xbtrace</b> affiche un message l'indiquant et continue de capturer les données de trace. |
| *tracetype* | Type de trace à démarrer. Les types de traces suivants sont disponibles.<br /><br />**advancedmp** : capture multijoueur avancée.<br /> Utilisez ce type de trace pour effectuer des traces multijoueurs avancées contenant les informations nécessaires au débogage des problèmes dans les sessions multijoueurs. Les sessions de trace multijoueur avancées collectent automatiquement un journal d'état du réseau lors de l'exécution de **start** et de **stop**. Lorsque **stop** est appelé, tous les fichiers de trace et journaux d'état du réseau sont copiés sur le PC de développement dans un répertoire de session de trace. Des journaux d'état du réseau supplémentaires peuvent être collectés pendant les sessions de trace multijoueur avancées à l'aide de la commande **log netstate**. Pour capturer l'état actuel d'une session multijoueur, procédez comme suit. <br />  1. Utilisez **xbTrace start advancedmp** pour démarrer une trace.<br />  2. Utilisez **log netstate** pour prendre un instantané de la session actuelle à différents moments importants.<br />  3. Utilisez **xbtrace stop** pour arrêter la trace.<br /><br />**netcap** : capture des paquets réseau. |
| /X\[:]<i>address\[+\<accesskey>]</i> | - Utilisez cette option pour spécifier le nom d'hôte ou l'adresse (affichée en tant que **Tools IP** sur la console) d'une console cible sans modifier la console par défaut. Pour plus de renseignements sur la définition d'un nom d'hôte pour une console, consultez [Définir un nom d'hôte pour l'adresse IP de la console](/fr-CA/home/setup-install/dev-kit-settings/setting-a-hostname).<br />- Si vous n'utilisez pas cette option, la console par défaut (définie précédemment à l'aide de [Connexion (xbconnect.exe)](/fr-CA/tools/tools-console/commandlinetools/xbconnect)) est utilisée.<br />- Utilisez la chaîne *accesskey* pour limiter l'accès à la console aux seules personnes qui disposent de la clé d'accès.<br />- Définissez la clé d'accès à l'aide de la commande **xbconfig** **accesskey=your-key**, puis redémarrez votre console pour que la clé d'accès prenne effet.<br />- Pour accéder à une console configurée avec une clé d'accès, ajoutez un signe plus (+) suivi de la clé d'accès après l'adresse IP ou le nom d'hôte de la console.<br />- Si une clé d'accès est fournie lors de la définition de la console par défaut avec [xbconnect](/fr-CA/tools/tools-console/commandlinetools/xbconnect), la clé d'accès est stockée dans l'adresse de la console par défaut.<br />- Pour plus de renseignements sur les clés d'accès, consultez [xbconfig accesskey](/fr-CA/tools/tools-console/commandlinetools/xbconfig). |

<a id="xbtrace_stop" />

## Arrêter et enregistrer une capture de trace réseau

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

| Option | Description |
| - | - |
| *stop* \[etlfile] | Arrête et enregistre la trace réseau en cours d'exécution. **etlfile** est un nom de fichier facultatif (avec un chemin facultatif) pour les données de trace enregistrées. Si vous ne spécifiez pas de nom de fichier, les données capturées sont enregistrées dans un fichier nommé xbtrace.etl dans le répertoire actif. Si vous spécifiez un nom de fichier sans chemin, le fichier est enregistré sous le nom spécifié dans le répertoire actif. Si le fichier spécifié existe déjà, **xbtrace** affiche un message l'indiquant et continue de capturer les données de trace. Il n'existe actuellement aucune option permettant de forcer le remplacement du fichier. |
| /X\[:]<i>address\[+\<accesskey>]</i> | - Utilisez cette option pour spécifier le nom d'hôte ou l'adresse (affichée en tant que **Tools IP** sur la console) d'une console cible sans modifier la console par défaut. Pour plus de renseignements sur la définition d'un nom d'hôte pour une console, consultez [Définir un nom d'hôte pour l'adresse IP de la console](/fr-CA/home/setup-install/dev-kit-settings/setting-a-hostname).<br />- Si vous n'utilisez pas cette option, la console par défaut (définie précédemment à l'aide de [Connexion (xbconnect.exe)](/fr-CA/tools/tools-console/commandlinetools/xbconnect)) est utilisée.<br />- Utilisez la chaîne *accesskey* pour limiter l'accès à la console aux seules personnes qui disposent de la clé d'accès.<br />- Définissez la clé d'accès à l'aide de la commande **xbconfig** **accesskey=your-key**, puis redémarrez votre console pour que la clé d'accès prenne effet.<br />- Pour accéder à une console configurée avec une clé d'accès, ajoutez un signe plus (+) suivi de la clé d'accès après l'adresse IP ou le nom d'hôte de la console.<br />- Si une clé d'accès est fournie lors de la définition de la console par défaut avec [xbconnect](/fr-CA/tools/tools-console/commandlinetools/xbconnect), la clé d'accès est stockée dans l'adresse de la console par défaut.<br />- Pour plus de renseignements sur les clés d'accès, consultez [xbconfig accesskey](/fr-CA/tools/tools-console/commandlinetools/xbconfig). |

<a id="xbtrace_log" />

## Collecter un journal pendant une session de suivi d'événements sur la console distante

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

| Option | Description |
| - | - |
| *log* | Collecte un journal pendant une session de suivi d'événements sur la console distante. |
| *logtype* | Type de journal à collecter. Le type de journal suivant est disponible.<br /><br />**netstate** : état du réseau<br /><br />Les fichiers de trace obtenus sont placés sur le PC de développement dans un répertoire dont le nom comprend "xbtrace" et un horodatage. |
| /X\[:]<i>address\[+\<accesskey>]</i> | - Utilisez cette option pour spécifier le nom d'hôte ou l'adresse (affichée en tant que **Tools IP** sur la console) d'une console cible sans modifier la console par défaut. Pour plus de renseignements sur la définition d'un nom d'hôte pour une console, consultez [Définir un nom d'hôte pour l'adresse IP de la console](/fr-CA/home/setup-install/dev-kit-settings/setting-a-hostname).<br />- Si vous n'utilisez pas cette option, la console par défaut (définie précédemment à l'aide de [Connexion (xbconnect.exe)](/fr-CA/tools/tools-console/commandlinetools/xbconnect)) est utilisée.<br />- Utilisez la chaîne *accesskey* pour limiter l'accès à la console aux seules personnes qui disposent de la clé d'accès.<br />- Définissez la clé d'accès à l'aide de la commande **xbconfig** **accesskey=your-key**, puis redémarrez votre console pour que la clé d'accès prenne effet.<br />- Pour accéder à une console configurée avec une clé d'accès, ajoutez un signe plus (+) suivi de la clé d'accès après l'adresse IP ou le nom d'hôte de la console.<br />- Si une clé d'accès est fournie lors de la définition de la console par défaut avec [xbconnect](/fr-CA/tools/tools-console/commandlinetools/xbconnect), la clé d'accès est stockée dans l'adresse de la console par défaut.<br />- Pour plus de renseignements sur les clés d'accès, consultez [xbconfig accesskey](/fr-CA/tools/tools-console/commandlinetools/xbconfig). |

<a id="remarks" />

## Exemple

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

<a id="ID4E3BAC" />

## Voir aussi

[Outils en ligne de commande](/fr-CA/tools/tools-console/commandlinetools/commandlinetools)

[Erreurs de transport XTF](/fr-CA/tools/tools-console/commandlinetools/xtf-transport-errors)

[Connexion (xbconnect.exe)](/fr-CA/tools/tools-console/commandlinetools/xbconnect)


## Related topics

- [Page Networking](/fr-CA/tools/tools-console/devhome/devhome-networking.md)
- [Page XBOX Live de Dev Home](/fr-CA/tools/tools-console/devhome/devhome-live.md)
- [Outils en ligne de commande pour le développement sur console](/fr-CA/tools/tools-console/commandlinetools/commandlinetools.md)
- [Outils en ligne de commande](/fr-CA/tools/tools-console/commandlinetools/index.md)
- [Suivi d'événements (wdtrace.exe)](/fr-CA/tools/tools-console/console_commandlinetools/wdtrace.md)