Partager via


Activer le suivi des diagnostics pour MS DTC sur un ordinateur Windows 10

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

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

Important

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 les informations de Registre Windows pour les utilisateurs avancés.

Types d’installations de suivi

  • 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 communications

    Le suivi des erreurs du gestionnaire de communications (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.

Note

Le suivi des erreurs du gestionnaire de transactions et le suivi des erreurs du gestionnaire de communications sont des processus indépendants. Vous pouvez activer indépendamment le suivi des erreurs 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 MMC (Component Services Microsoft Management Console) pour activer le suivi du gestionnaire de transactions. Pour ce faire, 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, développez Ordinateurs, Développez Mon ordinateur, développez Distributed Transaction Manager, 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
        • Tracer toutes les transactions
        • Tracer les transactions abandonnées
        • Trace des transactions de longue durée

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 étendu. 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 les 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 trace se trouve sur le nœud local, dans une clé de Registre nommée Tracing sous la clé de Registre MS DTC. La clé de Registre inclut le Tracing 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 où la sortie de suivi est envoyée.

Note

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 l’Éditeur de Registre pour configurer la fonctionnalité de suivi.

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

  1. Sélectionnez Démarrer>toutes les exécutions d’accessoires> de programmes>, tapez regedit, puis sélectionnez OK.

  2. Recherchez, puis 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 DWORD (32 bits) Valeur.

  4. Tapez le nom de la source souhaitée, puis appuyez sur Entrée. Pour plus d’informations sur les noms de sources, consultez le tableau de 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 De données 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 Effectue le suivi du service et du démarrage du fichier .exe
TRACE_GATEWAY Source de passerelle
TRACE_UI Trace l’interface utilisateur
TRACE_CONTACT Effectue le suivi du pool de contacts et des contacts
TRACE_UTIL Effectue le suivi des routines de l’utilitaire appelées à partir de plusieurs emplacements
TRACE_CLUSTER Trace le code spécifique au cluster (utilitaire)
TRACE_RESOURCE Trace le code spécifique aux ressources du cluster
TRACE_TIP Source de suivi du protocole INTERNET transactionnel (TIP)
TRACE_XA Source de suivi du gestionnaire de transactions XA (XATM)
TRACE_LOG Suivi du journal
TRACE_MTXOCI Source de traçage 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 du proxy MSDTC
TRACE_KTMRM Suivi de l’intégration à Kernel Transaction Manager
TRACE_VSSBACKUP Suivi de 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

Note

Les valeurs supérieures 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 d’intérêt 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. S’il s’agit d’une valeur 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 du 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 dans lequel 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) est 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 n’est pas nulle, la sortie est activée. Par défaut, cette Output clé de Registre est désactivée. Lorsque vous modifiez la configuration de 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 de service MS DTC est recyclé.

Vous pouvez également créer un fichier .reg, puis utiliser l’Éditeur de Registre pour importer le fichier. Pour ce faire, 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>toutes les exécutions d’accessoires> 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 Éditeur du Registre s’affiche.

  5. Cliquez sur OK.

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

Effet de performances

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

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 requises pour diagnostiquer un problème. Le suivi peut affecter les performances de l’ordinateur. Tout d’abord, vous devez trouver le problème, et vous devez le résoudre. Ensuite, désactivez immédiatement la fonctionnalité de suivi.

Configuration des clusters

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 du cluster ignore les entrées de Registre dans le Registre partagé, car les entrées de Registre n’existent pas dans le registre d’ordinateurs locaux.