Delen via

Diagnostische tracering inschakelen voor MS DTC op een Windows 10-computer

In dit artikel wordt beschreven hoe u diagnostische tracering inschakelt voor de Microsoft Distributed Transaction Coordinator (MS DTC) op een Windows 10-computer.

Oorspronkelijke productversie: Windows 10
Oorspronkelijk KB-nummer: 926099

Belangrijk

Dit artikel bevat informatie over het wijzigen van het register. Zorg ervoor dat u een back-up van het register maakt voordat u deze wijzigt. Zorg dat u weet hoe u het register wilt herstellen als er een probleem optreedt. Zie Windows-registergegevens voor geavanceerde gebruikers voor meer informatie over het maken van back-ups, herstellen en wijzigen van het register.

Soorten traceringsfaciliteiten

  • Tracering van transactiebeheerder

    Bij tracering van Transaction Manager (TM) worden wijzigingen in de transactiestatus bijgehouden. Het wordt gegenereerd door de MS DTC-transactiemanager. De uitvoer heeft een binaire indeling en de uitvoer moet worden opgemaakt. De transactiebeheerder maakt deel uit van de MS DTC-service.

  • Fouttracering in Communication Manager

    Communicatiebeheer (CM)-fouttracering houdt elk proces bij waarmee het Msdtcprx.dll-bestand wordt geladen en die gebruikmaakt van de RPC-interface (Remote Procedure Call) van MS DTC om te communiceren met andere MS DTC-gerelateerde processen. De uitvoer heeft een tekstindeling. De 0x8004d00a fout is een veelvoorkomende fout waarvoor het traceren van communicatiebeheerfouten nuttig kan zijn.

Notitie

Het traceren van transactiebeheer en het traceren van communicatiebeheer zijn onafhankelijke processen. U kunt het traceren van transactiebeheer en fouttracering van communicatiebeheer onafhankelijk inschakelen. U kunt ze ook onafhankelijk uitschakelen.

Transaction Manager-tracering inschakelen

U kunt de MMC-module (Component Services Microsoft Management Console) gebruiken om transaction manager-tracering in te schakelen. Hiervoor volgt u deze stappen:

  1. Selecteer Start, selecteer Alle programma's, selecteer Accessoires, en selecteer vervolgens Uitvoeren.

  2. Typ comexp.msc en selecteer VERVOLGENS OK.

  3. Vouw Component Services uit, vouw Computers uit, vouw Mijn computer uit, vouw Gedistribueerde transactiebeheer uit, klik met de rechtermuisknop op Lokale DTC en selecteer vervolgens Eigenschappen.

  4. Selecteer het tabblad Tracering .

  5. Op het tabblad Tracering kunt u de volgende TM-traceringsopties wijzigen:

    • Traceringsuitvoer
      • Transacties traceren
        • Alle transacties traceren
        • Afgebroken transacties traceren
        • Langlevende transacties traceren

Wanneer u de TM-traceringsconfiguratie wijzigt, detecteert de MS DTC-service de wijzigingen. U hoeft het proces echter niet te recyclen. Wanneer u bijvoorbeeld de transacties wijzigt die worden getraceerd of de locatie van het traceringsbestand, detecteert de MS DTC-service de wijziging in het register. U hoeft de MS DTC-service niet opnieuw op te starten.

Nieuw MS DTC-traceringssysteem in Windows

In Windows heeft MS DTC een nieuw en uitgebreid traceringssysteem. Het nieuwe systeem heeft de volgende ontwerpdoelen:

  • Er is slechts één regel code vereist om een opgemaakte trace toe te voegen.
  • De tracering kan worden gelezen door mensen op productiecomputers zonder een netwerk.
  • Uitvoeropties zijn flexibel.
  • De tracering is snel.
  • U hoeft de computer niet opnieuw op te starten om de opties te wijzigen.

Daarnaast bevat de traceringslogboekbestandsnaam in Windows 10 en Windows Server Technical Preview de naam van het proces dat het traceringslogboek heeft aangeroepen. Dit wordt beheerd door de uitvoerregistersleutel.

Tracering configureren

Waarschuwing

Er kunnen zich ernstige problemen voordoen als u het register met de Register-editor of met een andere methode foutief wijzigt. Wellicht moet u door deze problemen het besturingssysteem opnieuw installeren. Microsoft kan niet garanderen dat deze problemen kunnen worden opgelost. Het wijzigen van het register is op eigen risico.

De traceringsconfiguratie bevindt zich op het lokale knooppunt, in een registersleutel met de naam Tracing onder de MS DTC-registersleutel. De Tracing registersleutel bevat tracering van verbindingsbeheer. Eerder hebt u de TraceCMErr registersleutel gebruikt om tracering van verbindingsbeheer te configureren. De Tracing registersleutel bevat de volgende twee subsleutels:

  • Sources: Met deze subsleutel wordt het type tracering geconfigureerd.
  • Output: Met deze subsleutel wordt geconfigureerd waar de traceringsuitvoer wordt verzonden.

Notitie

Zorg ervoor dat het proces toegang heeft tot de Tracing registersleutel. De Windows-configuratie maakt deze sleutel standaard niet en verleent geen machtigingen voor deze sleutel. U kunt registereditor gebruiken om traceringsfunctionaliteit te configureren.

Volg deze stappen om registervermeldingen voor traceringsfunctionaliteit te maken:

  1. Selecteer Start >All Programs>Accessories>Run, typ regedit en selecteer VERVOLGENS OK.

  2. Zoek en selecteer vervolgens een van de volgende subsleutels:

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

  3. Selecteer Nieuw in het menu Bewerken en selecteer vervolgens het gegevenstype van de vermelding. Selecteer bijvoorbeeld DWORD -waarde (32-bits).

  4. Typ de naam van de gewenste bron en druk op Enter. Zie de tabel in de sectie Bronnen configureren voor meer informatie over de bronnamen.

  5. Klik met de rechtermuisknop op de nieuwe registervermelding, selecteer Wijzigen, typ de gewenste waarde in het vak Waardegegevens en selecteer VERVOLGENS OK.

  6. Klik in het menu Bestand op Afsluiten.

Bronnen configureren

De Sources registersleutel bevat een set DWORD-registerwaarden die worden vermeld in de volgende tabel.

Name Beschrijving
TRACE_MISC Traceringen die niet kunnen worden gecategoriseerd in de andere categorieën
TRACE_CM Traceringen in verbindingsbeheer
TRACE_TRACE De traceringsinfrastructuur zelf
TRACE_SVC Traceert de service en .exe het opstarten van het bestand
TRACE_GATEWAY Gatewaybron
TRACE_UI Traceert de gebruikersinterface
TRACE_CONTACT De groep contactpersonen en contactpersonen traceert
TRACE_UTIL Traceert hulpprogrammaroutines die worden aangeroepen vanaf meerdere locaties
TRACE_CLUSTER Traceert de clusterspecifieke (hulpprogramma)-code
TRACE_RESOURCE Traceert de resourcespecifieke code van het cluster
TRACE_TIP Tip-traceringsbron (Transaction Internet Protocol)
TRACE_XA XATM-traceringsbron (XA Transaction Manager)
TRACE_LOG Logboektracering
TRACE_MTXOCI Traceringsbron van MTS/OCI-laag (Mtxoci.dll)
TRACE_ETWTRACE Traceringsbron voor Windows (ETW)
TRACE_PROXY Traceringen die worden gegenereerd in de MSDTC-proxy-DLL
TRACE_KTMRM Tracering voor integratie met Kernel Transaction Manager
TRACE_VSSBACKUP Tracering voor integratie met het back-up- en herstelmechanisme van Microsoft Visual SourceSafe
TRACE_PERFMON Tracering met ondersteuning voor prestatiemeteritems

De DWORD-waarde moet een getal tussen 0 en 255 zijn. De DWORD-waarde geeft het traceringsniveau aan dat plaatsvindt. De volgende tabel bevat mogelijke DWORD-waarden.

Weergegeven als Beschrijving
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

Notitie

Hogere waarden bevatten automatisch lagere waarden. Wanneer u het TRACE_INFO niveau inschakelt, wordt het TRACE_ERROR niveau daarom ook ingeschakeld. Zeer weinig bronnen gebruiken tracering die hoger is dan het TRACE_VERBOSE niveau.

Traceringsuitvoer configureren

Waarschuwing

Er kunnen zich ernstige problemen voordoen als u het register met de Register-editor of met een andere methode foutief wijzigt. Wellicht moet u door deze problemen het besturingssysteem opnieuw installeren. Microsoft kan niet garanderen dat deze problemen kunnen worden opgelost. Het wijzigen van het register is op eigen risico.

De Output registersleutel bevat een set waarden die bepalen waar traceringsuitvoer wordt verzonden. Deze waarden zijn als volgt:

  • De TraceFilePath waarde (REG_SZ) is de hoofdmap waarin traceringsbestanden moeten worden opgeslagen. Tracering wordt geschreven naar een bestand in een map met de naam msdtc-X.log. In deze mapnaam vertegenwoordigt X de decimale PID van het proces waarmee het bestand wordt gemaakt. Zorg ervoor dat alle interessante processen toegang hebben tot de geconfigureerde map. Anders gaan traceringsgegevens verloren. Als deze waarde niet is ingesteld, worden traceringen niet naar een bestand verzonden.

  • De ImageNameInTraceFileNameEnabled waarde (REG_DWORD) bepaalt of de naam van het traceringslogboekbestand dat wordt gegenereerd, de bestandsnaam van de afbeelding bevat van het proces dat het traceringslogboek heeft aangeroepen. Als dit is ingesteld op een waarde die niet nul is, wordt de bestandsnaam van het installatiekopieënbestand van het proces opgenomen in het traceringslogboekbestand dat wordt gegenereerd. Als deze waarde is ingesteld op nul, wordt de bestandsnaam van het installatiekopieënbestand van het proces niet opgenomen in het traceringslogboekbestand dat wordt gegenereerd. De waarde is standaard ingesteld op nul (0). Hier volgt een voorbeeld van een traceringsbestand waarin het logboekbestand dat wordt gegenereerd, het proces bevat:
    MSDTC-msdtc.exe-3552.log of MSDTC-svchost.exe - 3556.log

  • De MemoryBufferSize waarde (REG_DWORD) is de grootte van de kringbuffer waarin traceringsberichten worden opgeslagen. Als deze waarde is ingesteld op 0, wordt geheugentracering uitgeschakeld. Deze waarde is standaard 10 MB. Mogelijk moet u deze waarde verhogen als u uitgebreide tracering inschakelt.

  • De DebugOutEnabled waarde (REG_DWORD) schakelt uitvoer naar het foutopsporingsprogramma in of uit. Als de waarde niet nul is, wordt de uitvoer ingeschakeld. Deze Output registersleutel is standaard uitgeschakeld. Wanneer u de configuratie voor fouttracering van verbindingsbeheer wijzigt, worden de wijzigingen van kracht wanneer een proces dat het Msdtcprx.dll bestand laadt, wordt gerecycled. De wijzigingen in de configuratie voor fouttracering van verbindingsbeheer worden bijvoorbeeld van kracht wanneer het MS DTC-serviceproces wordt gerecycled.

U kunt ook een .reg-bestand maken en vervolgens de Register-editor gebruiken om het bestand te importeren. Hiervoor volgt u deze stappen:

  1. Maak een nieuw .reg-bestand met het volgende codevoorbeeld:

    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. Selecteer Start>All Programs>Accessories>Run, typ regedit en klik op OK.

  3. Selecteer Importeren in het menu Bestand.

  4. Zoek het bestand dat u in stap 1 hebt gemaakt en selecteer Vervolgens Openen. Het dialoogvenster Registereditor wordt weergegeven.

  5. Selecteer OK.

  6. Klik in het menu Bestand op Afsluiten.

Prestatie-effect

Traceringsfunctionaliteit is standaard uitgeschakeld in Windows. Daarom bestaat er geen prestatie-effect op een reguliere installatie.

Schakel traceringsfunctionaliteit niet in op productiecomputers, tenzij een Microsoft Customer Support Professional aangeeft dat de traceringsgegevens vereist zijn om een probleem vast te stellen. Tracering kan van invloed zijn op de computerprestaties. Eerst moet u het probleem vinden en moet u het oplossen. Schakel vervolgens onmiddellijk de traceringsfunctionaliteit uit.

Clusterconfiguratie

Voor clusterinstallaties moet u ervoor zorgen dat alle registervermeldingen op alle knooppunten deze registervermeldingen bevatten. Voor elk knooppunt dat niet over deze registervermeldingen beschikt, negeert de clustercode de registervermeldingen in het gedeelde register omdat de registervermeldingen niet bestaan in het register van de lokale computer.