> ## 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. # xbWatson > xbWatson xbWatson est un outil qui vous permet d'utiliser votre PC de développement pour surveiller la sortie de débogage à l'échelle du système et les événements système critiques provenant d'une console XBOX. xbWatson dispose d'un éditeur de règles qui permet de personnaliser la sortie et les actions, ainsi que de surveiller et de contrôler les processus. Vous pouvez également collecter des vidages mémoire de type heap, triage et mini. Vue d'ensemble des fonctionnalités : * Collecter la sortie de débogage à l'échelle du système et les événements système critiques * Utiliser l'éditeur de règles pour filtrer et personnaliser la sortie * Séparer les flux de sortie dans plusieurs onglets de sortie * Enregistrer et distribuer vos règles et paramètres personnalisés * Bénéficier d'une surveillance et de contrôles détaillés des processus * Créer et gérer des vidages mémoire de type triage, heap et mini xbWatson fonctionne par session : son cycle de vie dépend d'une connexion à une console spécifique. Vous ne pouvez pas déconnecter une session existante pour la reconnecter à une autre console. Vous pouvez toutefois ouvrir plusieurs instances de xbWatson, chacune connectée à une console différente. xbWatson est collaboratif : il n'y a pas de connexions exclusives ni de verrouillage accidentel des consoles. Plusieurs instances peuvent cibler la même console et fonctionnent bien ensemble, même depuis des ordinateurs ou des développeurs différents. ## Sommaire * [Ouverture de xbWatson](#ID4EBB) * [Fonctionnalités](#ID4ETB) * [Vidages mémoire](#ID4ETC) * [Game Memory](#game_memory) ## Ouverture de xbWatson xbWatson peut être ouvert depuis une invite de commandes GDK, depuis [XBOX Manager](https://docs.xbox.com/fr/tools/tools-console/xbom/xbom.md) ou en recherchant xbWatson dans le menu Démarrer. xbWatson se connecte à votre console par défaut, sauf si vous la remplacez en fournissant l'adresse IP ou le nom d'hôte d'une console de test sur la ligne de commande. Ouverture de xbWatson depuis la ligne de commande, avec la console par défaut : ```text theme={null} C:\Program Files (x86)\Microsoft GDK\bin>xbwatson.exe ``` Ouverture de xbWatson en remplaçant l'adresse IP ou le nom d'hôte : ```text theme={null} C:\Program Files (x86)\Microsoft GDK\bin>xbwatson.exe /x:consoleIP ``` Ouverture de xbWatson depuis [XBOX Manager](https://docs.xbox.com/fr/tools/tools-console/xbom/xbom.md) via le Tools Launcher, qui sélectionne la console par défaut : ![xbWatson](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_launcher.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=c4e6659e51a910b853fce42deb9ad89a) Ouverture de xbWatson depuis [XBOX Manager](https://docs.xbox.com/fr/tools/tools-console/xbom/xbom.md) en cliquant avec le bouton droit sur une console et en sélectionnant Launch xbWatson, ce qui utilise la console sélectionnée : ![xbWatson](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_xbom.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=73b6b415bac18f2225c5008d54d1605d) ### Remplacement de la configuration Au démarrage, xbWatson charge un fichier de configuration par défaut nommé defaultconfig.txt, situé dans %localappdata%\Microsoft\XBOX One Development Kit\xbWatson\3.0. Ce fichier enregistre l'état des onglets de sortie, leur configuration, les règles et les règles appliquées. Ce fichier peut être partagé avec d'autres utilisateurs du GDK afin qu'ils puissent ouvrir rapidement une session xbWatson avec des paramètres personnalisés. Vous pouvez charger une configuration partagée de l'une des façons suivantes : * En remplaçant le fichier local defaultconfig.txt. * Depuis Windows, en faisant glisser un fichier sharedconfig.txt sur xbWatson.exe. * En ouvrant xbWatson.exe avec un commutateur de ligne de commande pointant vers le fichier de configuration enregistré (par exemple, xbwatson.exe E:\MyConfig\sharedconfig.txt) Pour connaître l'emplacement du fichier de configuration actuellement chargé, consultez l'onglet Log du Dashboard pour voir ce qui est chargé : `Loading configuration 'C:\Users\UserName\AppData\Local\Microsoft\XBOX One Development Kit\xbWatson\3.0\defaultConfig.txt'.` ## Fonctionnalités xbWatson dispose de fonctionnalités qui permettent d'afficher et de configurer la sortie dans la fenêtre de sortie principale, d'appliquer des règles de sortie via l'éditeur et le menu, de filtrer le type de sortie via le menu des flux de données et de gérer, dans le Dashboard, des fonctionnalités avancées relatives aux diagnostics du journal, à la liste des processus de Game OS ainsi qu'à la génération et à la gestion des vidages de pile. ### Fenêtre de sortie principale La fenêtre de sortie principale se compose de la barre de titre, des onglets de sortie, du Rule Editor et du Dashboard, comme illustré dans la figure 1. **Figure 1. xbWatson** ![xbWatson](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_connected.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=e34e40cdc10e0d86630f7ad4f2dddd45) ### Barre de titre Lorsque xbWatson est connecté à une console, la barre de titre est verte et affiche les détails de la connexion, comme illustré dans la figure 2. **Figure 2. Barre de titre (connecté)** ![Barre de titre](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_titlebar.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=b0dcab289f41df95697f75eb3d84b7b4) Si xbWatson ne parvient pas à se connecter, ou si les services du kit de développement ne sont pas disponibles, la barre de titre est rouge ou jaune. Dans ce cas, consultez l'onglet Log du Dashboard pour obtenir des informations supplémentaires sur l'erreur. Ce problème est souvent dû à une adresse IP ou à un nom d'hôte de kit de développement non valide. Vérifiez que l'adresse IP et le nom d'hôte de votre kit de développement sont valides pour que xbWatson puisse s'y connecter correctement. ### Onglets de sortie Au démarrage, il existe un onglet de sortie par défaut. Vous pouvez créer d'autres onglets de sortie en cliquant sur le signe plus (+) à droite du dernier onglet. Vous pouvez supprimer un onglet de sortie en cliquant sur le x situé à droite de cet onglet. Vous pouvez renommer l'onglet en cliquant sur son nom (Output). Lorsque la console émet une sortie de débogage, le voyant d'activité de cet onglet clignote. Vous pouvez copier des données de la fenêtre de sortie en mettant en surbrillance ou en sélectionnant du texte et en utilisant les commandes de copie standard de Windows pour les transférer vers et depuis le Presse-papiers. Dans chaque onglet de sortie, vous disposez des menus d'options suivants pour configurer cet onglet. #### Menu Add/Remove Rules Utilisez le menu Add/Remove Rules pour activer ou désactiver une règle pour l'onglet de sortie actuel, comme illustré dans la figure 3. Pour plus d'informations sur la création de règles, consultez la section Rule Editor plus loin dans cette rubrique. **Figure 3. Menu Add/Remove Rules** ![Menu Add/Remove Rules](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_applyrules.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=d512e8d129a6f1bda7fdf02358d1e3b0) #### Menu Data feeds Utilisez le menu Data feeds pour configurer les flux de sortie affichés par l'onglet de sortie actuel, comme illustré dans la figure 4. **Figure 4. Menu Data feeds** ![Menu Data feeds](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_datafeeds.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=062d7fb7088ac20276ce3e8bd81366ed) Vous pouvez activer ou désactiver les flux de sortie en cochant ou en décochant les cases situées à côté du nom de chaque flux. Les options individuelles d'un flux peuvent être configurées en cliquant sur l'icône d'engrenage à droite du nom du flux, comme illustré dans la figure 5. **Figure 5. Contrôle des flux** ![Contrôle des flux](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_feedcontrol.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=d24cd66fbe724b07962ae47ca31ab2c7) Les flux de données disponibles sont présentés dans le tableau suivant. | Flux de données | Description | | - | - | | Output debug string | Sortie de débogage du système d'exploitation de recovery et de Game OS. | | Process feed | Sortie des modifications de processus de Game OS. | | Process debug feed | Sortie des événements de débogage d'un processus sélectionné. La sortie est disponible après la surveillance d'un processus depuis le dashboard Game OS. | | Console event feed | Sortie d'une liste organisée d'événements Windows et de télémétrie (actuellement axée sur l'inscription et l'activation des applications). | | Game memory feed | Sortie indiquant la quantité de mémoire de titre et d'outils actuellement utilisée et disponible sur la console. | ### Rule Editor Le Rule Editor se trouve sur le côté droit de la fenêtre de sortie principale, comme illustré dans la figure 6. **Figure 6. Rule Editor** ![Rule Editor](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_ruleeditor.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=53e171afd9072bd07f41b05f908b33cd) Pour créer une règle 1. Cliquez sur **New** dans le volet gauche. Une nouvelle règle vide est créée. 2. Nommez la règle. 3. Ajoutez une nouvelle condition. * Correspondance avec l'expression régulière : saisissez une chaîne regex à évaluer. 4. Ajoutez une action (à effectuer lorsque la condition est satisfaite) : * **Change color** : ouvre un sélecteur de couleur pour modifier le texte correspondant. * **Acquire stack dump** : déclenche le type de vidage de pile sélectionné. * **Include text** : affiche uniquement le texte. * **Exclude text** : n'affiche pas le texte. * **Disable this rule** : arrête l'exécution de cette règle. C'est utile pour récupérer un vidage de pile une seule fois lors d'une exécution de test automatisée. * **Set trigger to break** : suspend le processus et le prépare à l'attachement d'un débogueur. * **Invasively attach** : attache xbWatson au processus en tant que débogueur. * **Remove invasive attach** : retire xbWatson en tant que débogueur. * **Flash window** : fait clignoter l'icône de xbWatson dans la barre des tâches. * **Show banner message** : affiche un message de bannière en haut de la fenêtre de sortie et fait passer au rouge le voyant d'activité de cet onglet pour attirer votre attention. * **Clear banner message** : supprime le message de bannière en haut de la fenêtre de sortie. * **Enable other rule** : active la règle spécifiée pour cet onglet de sortie. * **Disable other rule** : désactive la règle spécifiée pour cet onglet de sortie. 5. Enregistrez la règle. Avant que la règle ne soit active, vous devez l'appliquer à un onglet de sortie. Pour ce faire, cliquez sur **Apply rules** dans le Rule Editor, ou fermez le Rule Editor et appliquez la règle via le menu **Apply rules** directement dans l'onglet de sortie. > [!NOTE] > > Faites attention au bouton **toggle multi-select** lorsque vous appliquez des règles depuis le Rule Editor. Seules les règles actuellement sélectionnées sont appliquées. ### Dashboard Cliquez sur la flèche vers le haut en bas de la fenêtre de sortie principale pour ouvrir le Dashboard, comme illustré dans la figure 7. Lorsque le Dashboard est réduit, des voyants d'état du Dashboard apparaissent dans le coin inférieur gauche de la fenêtre. Ces voyants d'état correspondent aux éléments du Dashboard. Ils clignotent ou changent de couleur pour indiquer un flux de données ou un changement d'état. **Figure 7. Dashboard** ![Dashboard](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_dashboard.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=7a7a5aa54626efcdb21552aa47d04321) #### Log Le journal contient des informations sur xbWatson lui-même et sur la connexion de xbWatson au kit de développement. Vous pouvez y voir le fichier de configuration chargé au démarrage, l'adresse IP ou la chaîne de connexion enregistrée contactée, ainsi que d'autres informations de débogage sur xbWatson. Cet élément du Dashboard devient rouge en cas de problème de connexion au kit de développement. #### Game OS Lorsqu'aucun titre n'est en cours d'exécution sur le kit de développement, cet élément du Dashboard s'affiche en jaune et indique que les données des processus ne sont pas disponibles. Sans titre en cours d'exécution, vous pouvez voir un ensemble minimal de données sur les paramètres du kit de développement. Lorsqu'un titre est en cours d'exécution, vous pouvez voir des données étendues similaires à celles du Gestionnaire des tâches de Windows. La couleur de la ligne indique l'état comme suit, et comme illustré dans la figure 8. * Vert : une modification des données du processus s'est produite au cours des cinq dernières secondes. * Rouge : le processus s'est terminé. * Orange : le processus est suspendu, y compris en débogage (arrêt). * Bleu : un débogueur est attaché, y compris xbWatson en attachement invasif. La sélection d'une ligne vous permet d'activer les options situées sous la liste des processus. **Figure 8. Liste des processus de Game OS** ![Liste des processus de Game OS](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_processlist.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=3a730de125f2ad3e4ab5be6e5ce3bf98) * Terminate : cliquer sur un processus actif, puis sur le bouton Terminate, met fin au processus. * Break (debug) : suspend le processus et le prépare à l'attachement d'un débogueur. * Resume : supprime l'arrêt de débogage et reprend l'exécution du processus. * Monitor : attache xbWatson en tant que débogueur invasif. Un seul débogueur invasif peut être attaché à un processus à la fois ; connecter xbWatson de cette manière empêche donc Visual Studio de se connecter au processus. Plusieurs instances de xbWatson partagent cet attachement. Le détachement est automatique si toutes les instances de xbWatson sont fermées. Une fois cette option activée, le flux de données Process debug (disponible depuis l'interface de configuration des flux de sortie) commence à recevoir des données. La chaîne de débogage de sortie passe par le flux de débogage du processus une fois celui-ci attaché. * Detach : retire xbWatson en tant que débogueur invasif. #### Vidages mémoire Utilisez le menu Memory Dump pour générer un vidage mémoire ou accéder aux vidages de blocage de mise en veille (quiesce). Des vidages mémoire de type heap, mini ou triage peuvent être créés pour le titre en cours d'exécution sur la console. Les vidages générés sont stockés localement sur la console et peuvent être téléchargés à l'aide du bouton **Download** situé sous le tableau **Manual Memory Dumps**. Le bouton **Generate** n'est disponible que si un titre est en cours d'exécution et peut générer des vidages mémoire de cette manière. xbWatson cible le jeu en cours d'exécution (ID de processus) qui correspond à un nom d'image de jeu inscrit sur la console. Le panneau Memory Dump ne permet de gérer les vidages mémoire que lorsque le titre est en cours d'exécution. Les opérations de génération et de téléchargement font clignoter le voyant d'activité du Dashboard pour signaler une activité. Les vidages de blocage de mise en veille sont créés automatiquement si un délai d'expiration de suspension se produit et qu'aucun débogueur n'est attaché. Ces vidages sont utiles pour déterminer pourquoi le gestionnaire de suspension de votre titre ne s'est pas terminé dans le délai imparti. Le voyant du Dashboard clignote pour signaler qu'un vidage de blocage de mise en veille est disponible. Les vidages de blocage disponibles sont répertoriés dans le tableau **Quiesce Memory Dumps**. Utilisez le bouton **Download** situé sous le tableau pour copier un vidage de blocage de mise en veille sur votre PC de développement. Consultez [Débogage des transitions entre les états du cycle de vie du jeu](https://docs.xbox.com/fr/tools/tools-console/visualstudio/debugging-with-visualstudio.md) pour une description complète des fonctionnalités fournies par le Microsoft Game Development Kit (GDK) pour déboguer les gestionnaires de suspension et de reprise nécessaires à la [prise en charge du cycle de vie du jeu](https://docs.xbox.com/fr/build/console-features/console-workflows/xbox-game-life-cycle.md). **Figure 9. Vidages mémoire et vidages de blocage de mise en veille** ![Vidages de pile](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_crashdump.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=f98a3922549577ee26a8704b46487d57) #### Game memory Présente une vue similaire à celle du Gestionnaire des tâches de l'état de la console à laquelle xbWatson est connecté. Le dashboard Game Memory est actuellement axé sur la consommation de mémoire du titre et des outils. D'autres statistiques, comme celles du processeur ou des E/S de fichiers, seront ajoutées dans de futures versions. ![Le dashboard Game Memory dans xbWatson](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xbwatson_system_monitor.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=d04b22f345d028baa16df1a7014e9a12) Consultez [XBOX System Monitor](https://docs.xbox.com/fr/tools/tools-console/visualstudio/xbox-system-monitor.md) pour une description des graphiques fournis dans ce dashboard. ## Voir aussi [Développement de jeux sur console XBOX (environnement et outils)](https://docs.xbox.com/fr/tools/tools-console/gc-tools-console-toc.md) [Récupération des vidages sur incident](https://docs.xbox.com/fr/build/console-features/debugging-diagnostics/retrieving-crash-dumps.md) ## Related topics - [Moniteur de sortie de débogage xbWatson pour XBOX](https://docs.xbox.com/fr/tools/tools-console/xbWatson/index.md) - [Outils de développement pour console XBOX (GDK)](https://docs.xbox.com/fr/tools/tools-console/index.md) - [XBOX Manager](https://docs.xbox.com/fr/tools/tools-console/xbom/xbom.md) - [Glossaire GDK des termes et acronymes](https://docs.xbox.com/fr/home/glossary.md) - [XBOX System Monitor](https://docs.xbox.com/fr/tools/tools-console/visualstudio/xbox-system-monitor.md)