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.
| Commande | Description |
|---|---|
| xbtrace start netcap | Démarre une capture de trace réseau |
| xbtrace stop | Arrête et enregistre une trace |
| xbtrace log | Collecte un journal pendant une session de suivi d’événements sur la console distante |
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, xbtrace 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. advancedmp : capture multijoueur avancée. 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. 1. Utilisez xbTrace start advancedmp pour démarrer une trace. 2. Utilisez log netstate pour prendre un instantané de la session actuelle à différents moments importants. 3. Utilisez xbtrace stop pour arrêter la trace. netcap : capture des paquets réseau. |
| /X[:]address[+<accesskey>] | - 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. - Si vous n’utilisez pas cette option, la console par défaut (définie précédemment à l’aide de Connexion (xbconnect.exe)) est utilisée. - Utilisez la chaîne accesskey pour limiter l’accès à la console aux seules personnes qui disposent de la clé d’accès. - 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. - 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. - Si une clé d’accès est fournie lors de la définition de la console par défaut avec xbconnect, la clé d’accès est stockée dans l’adresse de la console par défaut. - Pour plus de renseignements sur les clés d’accès, consultez xbconfig accesskey. |
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[:]address[+<accesskey>] | - 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. - Si vous n’utilisez pas cette option, la console par défaut (définie précédemment à l’aide de Connexion (xbconnect.exe)) est utilisée. - Utilisez la chaîne accesskey pour limiter l’accès à la console aux seules personnes qui disposent de la clé d’accès. - 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. - 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. - Si une clé d’accès est fournie lors de la définition de la console par défaut avec xbconnect, la clé d’accès est stockée dans l’adresse de la console par défaut. - Pour plus de renseignements sur les clés d’accès, consultez xbconfig accesskey. |
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. netstate : état du réseau 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[:]address[+<accesskey>] | - 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. - Si vous n’utilisez pas cette option, la console par défaut (définie précédemment à l’aide de Connexion (xbconnect.exe)) est utilisée. - Utilisez la chaîne accesskey pour limiter l’accès à la console aux seules personnes qui disposent de la clé d’accès. - 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. - 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. - Si une clé d’accès est fournie lors de la définition de la console par défaut avec xbconnect, la clé d’accès est stockée dans l’adresse de la console par défaut. - Pour plus de renseignements sur les clés d’accès, consultez xbconfig accesskey. |
Exemple
xbtrace start netcap
xbtrace start advancedmp
xbtrace stop
xbtrace stop c:\netcaptemp\netcap.etl
xbtrace stop c:\advancedmptemp
xbtrace log netstate