Activer le suivi de diagnostic pour MS DTC sur un ordinateur Windows 10

  • Article

Cet article explique comment activer le suivi des diagnostics pour Microsoft Distributed Transaction Coordinator (MS DTC) sur un ordinateur Windows 10.

Version d’origine du produit : Windows 10
Numéro de la base de connaissances d’origine : 926099

Importante

Cet article contient des informations sur la modification du Registre. Avant de modifier le Registre, pensez à le sauvegarder et assurez-vous que vous savez le restaurer en cas de problème. Pour plus d’informations sur la sauvegarde, la restauration et la modification du Registre, consultez Informations du Registre Windows pour les utilisateurs avancés.

Types d’installations de traçage

  • Suivi du gestionnaire de transactions

    Le suivi du gestionnaire de transactions (TM) suit les modifications de l’état des transactions. Il est généré par le gestionnaire de transactions MS DTC. La sortie est au format binaire et la sortie doit être mise en forme. Le gestionnaire de transactions fait partie du service MS DTC.

  • Suivi des erreurs du gestionnaire de communication

    Le suivi des erreurs du gestionnaire de communication (CM) suit tout processus qui charge le fichier Msdtcprx.dll et qui utilise l’interface d’appel de procédure distante (RPC) de MS DTC pour communiquer avec d’autres processus liés à MS DTC. La sortie est au format texte. L’erreur 0x8004d00a est une erreur classique pour laquelle le suivi des erreurs du gestionnaire de communication peut être utile.

Remarque

Le suivi du gestionnaire de transactions et le suivi des erreurs du gestionnaire de communication sont des processus indépendants. Vous pouvez activer indépendamment le suivi du gestionnaire de transactions et le suivi des erreurs du gestionnaire de communications. Vous pouvez également les désactiver indépendamment.

Activer le suivi du gestionnaire de transactions

Vous pouvez utiliser le composant logiciel enfichable Microsoft Management Console (MMC) services de composants pour activer le suivi du gestionnaire de transactions. Pour cela, procédez comme suit :

  1. Sélectionnez Démarrer, Tous les programmes, Accessoires, puis Exécuter.

  2. Tapez comexp.msc, puis sélectionnez OK.

  3. Développez Services de composants, Ordinateurs, Poste de travail, Gestionnaire de transactions distribuées, cliquez avec le bouton droit sur DTC local, puis sélectionnez Propriétés.

  4. Sélectionnez l’onglet Suivi .

  5. Sous l’onglet Suivi , vous pouvez modifier les options de suivi TM suivantes :

    • Sortie de trace
      • Transactions de suivi
        • Suivre toutes les transactions
        • Trace des transactions abandonnées
        • Trace Long-Lived Transactions

Lorsque vous modifiez la configuration du suivi TM, le service MS DTC détecte les modifications. Toutefois, vous n’avez pas besoin de recycler le processus. Par exemple, lorsque vous modifiez les transactions qui sont tracées ou l’emplacement du fichier de trace, le service MS DTC détecte la modification dans le Registre. Vous n’avez pas besoin de redémarrer le service MS DTC.

Nouveau système de suivi MS DTC dans Windows

Dans Windows, MS DTC dispose d’un nouveau système de suivi complet. Le nouveau système a les objectifs de conception suivants :

  • Une seule ligne de code est nécessaire pour ajouter une trace mise en forme.
  • La trace est lisible par les humains sur des ordinateurs de production sans réseau.
  • Les options de sortie sont flexibles.
  • La trace est rapide.
  • Vous n’avez pas besoin de redémarrer l’ordinateur pour modifier les options.

En outre, dans Windows 10 et Windows Server Technical Preview, le nom du fichier journal de suivi inclut le nom du processus qui a appelé le journal de suivi. Cela est contrôlé par la clé de Registre de sortie.

Configurer le suivi

Avertissement

De graves problèmes peuvent se produire si vous vous trompez en modifiant le Registre à l’aide de l’Éditeur du Registre ou toute autre méthode. Vous risquez même de devoir réinstaller le système d’exploitation. Microsoft ne peut pas garantir que ces problèmes peuvent être résolus. Vous assumez l’ensemble des risques liés à la modification du Registre.

La configuration de la trace se trouve sur le nœud local, dans une clé de Registre nommée Tracing sous la clé de Registre MS DTC. La Tracing clé de Registre inclut le suivi du gestionnaire de connexions. Auparavant, vous utilisiez la clé de Registre pour configurer le TraceCMErr suivi du gestionnaire de connexions. La Tracing clé de Registre contient les deux sous-clés suivantes :

  • Sources: cette sous-clé configure le type de suivi.
  • Output: cette sous-clé configure l’emplacement d’envoi de la sortie de suivi.

Remarque

Assurez-vous que le processus peut accéder à la clé de Tracing Registre. Par défaut, la configuration Windows ne crée pas cette clé et n’accorde pas d’autorisations à cette clé. Vous pouvez utiliser la Rédacteur du Registre pour configurer la fonctionnalité de suivi.

Pour créer des entrées de Registre de fonctionnalité de suivi, procédez comme suit :

  1. Sélectionnez Démarrer>l’exécution de tous lesaccessoires> de programmes>, tapez regedit, puis sélectionnez OK.

  2. Recherchez et sélectionnez l’une des sous-clés suivantes :

    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC\Tracing\Sources
    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC\Tracing\Output

  3. Dans le menu Modifier , sélectionnez Nouveau, puis sélectionnez le type de données de l’entrée. Par exemple, sélectionnez Valeur DWORD (32 bits).

  4. Tapez le nom de la source souhaitée, puis appuyez sur Entrée. Pour plus d’informations sur les noms des sources, consultez le tableau dans la section Configurer les sources .

  5. Cliquez avec le bouton droit sur la nouvelle entrée de Registre, sélectionnez Modifier, tapez la valeur souhaitée dans la zone Données de la valeur , puis sélectionnez OK.

  6. Dans le menu Fichier, sélectionnez Quitter.

Configurer des sources

La Sources clé de Registre contient un ensemble de valeurs de Registre DWORD répertoriées dans le tableau suivant.

Nom Description
TRACE_MISC Traces qui ne peuvent pas être classées dans les autres catégories
TRACE_CM Traces dans le gestionnaire de connexions
TRACE_TRACE L’infrastructure de suivi elle-même
TRACE_SVC Démarrage du service et .exe traces
TRACE_GATEWAY Source de la passerelle
TRACE_UI Trace l’interface utilisateur
TRACE_CONTACT Trace le pool de contacts et les contacts
TRACE_UTIL Traces des routines utilitaires appelées à partir de plusieurs emplacements
TRACE_CLUSTER Trace le code (utilitaire) spécifique au cluster
TRACE_RESOURCE Trace le code spécifique à la ressource du cluster
TRACE_TIP Source de suivi tip (Transaction Internet Protocol)
TRACE_XA Source de suivi XATM (XA Transaction Manager)
TRACE_LOG Suivi des journaux
TRACE_MTXOCI Source de traçage de couche MTS/OCI (Mtxoci.dll)
TRACE_ETWTRACE Source de suivi d’événements pour Windows (ETW)
TRACE_PROXY Traces générées dans la DLL de proxy MSDTC
TRACE_KTMRM Suivi pour l’intégration à Kernel Transaction Manager
TRACE_VSSBACKUP Suivi pour l’intégration avec le mécanisme de sauvegarde et de restauration Microsoft Visual SourceSafe
TRACE_PERFMON Suivi avec prise en charge des compteurs de performances

La valeur DWORD doit être un nombre compris entre 0 et 255. La valeur DWORD indique le niveau de suivi qui se produit. Le tableau suivant répertorie les valeurs DWORD possibles.

Valeur Description
0 const BYTE TRACE_OFF
1 const BYTE TRACE_ERROR
2 const BYTE TRACE_WARNING
3 const BYTE TRACE_INFO
4 const BYTE TRACE_VERBOSE
5 const BYTE TRACE_VERY_VERBOSE
6 const BYTE TRACE_INOUT
0xF0 const BYTE TRACE_OBSCURE
0xff const BYTE TRACE_EVERYTHING

Remarque

Les valeurs plus élevées incluent automatiquement des valeurs inférieures. Par conséquent, lorsque vous activez le TRACE_INFO niveau, le TRACE_ERROR niveau est également activé. Très peu de sources utilisent un suivi supérieur au TRACE_VERBOSE niveau.

Configurer la sortie de trace

Avertissement

De graves problèmes peuvent se produire si vous vous trompez en modifiant le Registre à l’aide de l’Éditeur du Registre ou toute autre méthode. Vous risquez même de devoir réinstaller le système d’exploitation. Microsoft ne peut pas garantir que ces problèmes peuvent être résolus. Vous assumez l’ensemble des risques liés à la modification du Registre.

La Output clé de Registre contient un ensemble de valeurs qui contrôlent l’emplacement d’envoi de la sortie de trace. Ces valeurs sont les suivantes :

  • La TraceFilePath valeur (REG_SZ) est le dossier racine dans lequel les fichiers de trace doivent être stockés. Le suivi est écrit dans un fichier dans un dossier nommé msdtc-X.log. Dans ce nom de dossier, X représente le PID décimal du processus qui crée le fichier. Assurez-vous que tous les processus qui vous intéressent peuvent accéder au dossier configuré. Sinon, les informations de trace seront perdues. Si cette valeur n’est pas définie, les traces ne sont pas envoyées à un fichier.

  • La ImageNameInTraceFileNameEnabled valeur (REG_DWORD) détermine si le nom du fichier journal de suivi généré inclut le nom du fichier image du processus qui a appelé le journal de suivi. Si cette valeur est différente de zéro, le nom du fichier image du processus est inclus dans le fichier journal de suivi généré. Si cette valeur est définie sur zéro, le nom de fichier image du processus n’est pas inclus dans le fichier journal de suivi généré. Par défaut, la valeur est définie sur zéro (0). Voici un exemple de nom de fichier de trace où le fichier journal généré contient le processus :
    MSDTC-msdtc.exe-3552.log ou MSDTC-svchost.exe - 3556.log

  • La MemoryBufferSize valeur (REG_DWORD) correspond à la taille de la mémoire tampon circulaire dans laquelle les messages de trace sont stockés. Si cette valeur est définie sur 0, le suivi de la mémoire est désactivé. Par défaut, cette valeur est de 10 Mo. Vous devrez peut-être augmenter cette valeur si vous activez le suivi détaillé.

  • La DebugOutEnabled valeur (REG_DWORD) active ou désactive la sortie vers le débogueur. Si la valeur est différente de zéro, la sortie est activée. Par défaut, cette Output clé de Registre est désactivée. Lorsque vous modifiez la configuration du suivi des erreurs du gestionnaire de connexions, les modifications prennent effet lorsqu’un processus qui charge le fichier Msdtcprx.dll est recyclé. Par exemple, les modifications apportées à la configuration du suivi des erreurs du gestionnaire de connexions prennent effet lorsque le processus du service MS DTC est recyclé.

Vous pouvez également créer un fichier .reg, puis utiliser le registre Rédacteur pour importer le fichier. Pour cela, procédez comme suit :

  1. Créez un fichier .reg qui contient l’exemple de code suivant :

    Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC\Tracing]
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC\Tracing\Output]
"DebugOutEnabled"=dword:00000000
"TraceFilePath"=""
"MemoryBufferSize"=dword:0000000a
"ImageNameInTraceFileNameEnabled"=dword:00000001
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC\Tracing\Sources]
"TRACE_MISC"=dword:00000000
"TRACE_CM"=dword:00000000
"TRACE_TRACE"=dword:00000000
"TRACE_SVC"=dword:00000000
"TRACE_GATEWAY"=dword:00000000
"TRACE_UI"=dword:00000000
"TRACE_CONTACT"=dword:00000000
"TRACE_UTIL"=dword:00000000
"TRACE_CLUSTER"=dword:00000000
"TRACE_RESOURCE"=dword:00000000
"TRACE_TIP"=dword:00000000
"TRACE_XA"=dword:00000000
"TRACE_LOG"=dword:00000000
"TRACE_MTXOCI"=dword:00000000
"TRACE_ETWTRACE"=dword:00000000
"TRACE_PROXY"=dword:00000000
"TRACE_KTMRM"=dword:00000000
"TRACE_VSSBACKUP"=dword:00000000

  2. Sélectionnez Démarrer>l’exécution de tous lesaccessoires> de programmes>, tapez regedit, puis cliquez sur OK.

  3. Dans le menu Fichier , sélectionnez Importer.

  4. Recherchez le fichier que vous avez créé à l’étape 1, puis sélectionnez Ouvrir. La boîte de dialogue Rédacteur du Registre s’affiche.

  5. Sélectionnez OK.

  6. Dans le menu Fichier, sélectionnez Quitter.

Effet sur les performances

Par défaut, la fonctionnalité de suivi est désactivée dans Windows. Par conséquent, aucun effet sur les performances n’existe sur une installation normale.

N’activez pas la fonctionnalité de suivi sur les ordinateurs de production, sauf si un professionnel du support technique Microsoft indique que les informations de suivi sont nécessaires pour diagnostiquer un problème. Le suivi peut affecter les performances de l’ordinateur. Vous devez d’abord trouver le problème, et vous devez le résoudre. Ensuite, désactivez immédiatement la fonctionnalité de suivi.

Configuration du cluster

Pour les installations de cluster, assurez-vous que toutes les entrées de Registre sur tous les nœuds contiennent ces entrées de Registre. Pour tout nœud qui n’a pas ces entrées de Registre, le code de cluster ignore les entrées de Registre dans le registre partagé, car les entrées de Registre n’existent pas dans le registre de l’ordinateur local.