Abilitare la traccia diagnostica per MS DTC in un computer Windows 10

  • Articolo

Questo articolo illustra come abilitare la traccia diagnostica per Microsoft Distributed Transaction Coordinator (MS DTC) in un computer Windows 10.

Versione originale del prodotto: Windows 10
Numero KB originale: 926099

Importante

In questo articolo sono contenute informazioni relative alla modifica del Registro di sistema. Prima di modificare il Registro di sistema, assicurarsi di eseguirne una copia di backup e di sapere come ripristinarlo in caso di problemi. Per altre informazioni su come eseguire il backup, ripristinare e modificare il Registro di sistema, vedere Informazioni sul Registro di sistema di Windows per gli utenti esperti.

Tipi di strutture di traccia

  • Traccia di Gestione transazioni

    La traccia di Gestione transazioni (TM) tiene traccia delle modifiche dello stato delle transazioni. Viene generato dal gestore transazioni MS DTC. L'output è in formato binario e l'output deve essere formattato. Gestione transazioni fa parte del servizio MS DTC.

  • Traccia degli errori di Gestione comunicazioni

    La traccia degli errori di Gestione comunicazioni tiene traccia di qualsiasi processo che carica il file Msdtcprx.dll e che usa l'interfaccia RPC (Remote Procedure Call) di MS DTC per comunicare con altri processi correlati a MS DTC. L'output è in formato testo. L'errore 0x8004d00a è un errore tipico per il quale la traccia degli errori di Gestione comunicazioni può essere utile.

Nota

La traccia di Gestione transazioni e la traccia degli errori di Gestione comunicazioni sono processi indipendenti. È possibile abilitare in modo indipendente la traccia di Gestione transazioni e la traccia degli errori di Gestione comunicazioni. In alternativa, è possibile disabilitarli in modo indipendente.

Abilitare la traccia di Gestione transazioni

È possibile usare lo snap-in Microsoft Management Console (MMC) di Servizi componenti per abilitare la traccia di Gestione transazioni. A tal fine, attenersi alla seguente procedura:

  1. Selezionare Start, Tutti i programmi, Accessori e quindi Esegui.

  2. Digitare comexp.msc e quindi selezionare OK.

  3. Espandere Servizi componenti, Computer, Computer personale, Gestione transazioni distribuite, fare clic con il pulsante destro del mouse su DTC locale e quindi scegliere Proprietà.

  4. Selezionare la scheda Traccia .

  5. Nella scheda Traccia è possibile modificare le opzioni di traccia TM seguenti:

    • Output di traccia
      • Transazioni di traccia
        • Traccia tutte le transazioni
        • Traccia transazioni interrotte
        • Traccia transazioni Long-Lived

Quando si modifica la configurazione di traccia TM, il servizio MS DTC rileva le modifiche. Tuttavia, non è necessario riciclare il processo. Ad esempio, quando si modificano le transazioni tracciate o il percorso del file di traccia, il servizio MS DTC rileva la modifica nel Registro di sistema. Non è necessario riavviare il servizio MS DTC.

Nuovo sistema di traccia MS DTC in Windows

In Windows, MS DTC dispone di un sistema di traccia nuovo ed esteso. Il nuovo sistema ha gli obiettivi di progettazione seguenti:

  • Per aggiungere una traccia formattata è necessaria una sola riga di codice.
  • La traccia è leggibile dagli utenti nei computer di produzione senza una rete.
  • Le opzioni di output sono flessibili.
  • La traccia è veloce.
  • Non è necessario riavviare il computer per modificare le opzioni.

Inoltre, in Windows 10 e Windows Server Technical Preview, il nome del file di log di traccia include il nome del processo che ha richiamato il log di traccia. Questa operazione è controllata dalla chiave del Registro di sistema Output.

Configurare la traccia

Avviso

L'errata modifica del Registro di sistema tramite l'editor o un altro metodo può causare seri problemi. che potrebbero richiedere la reinstallazione del sistema operativo. Microsoft non è in grado di garantire la soluzione di tali problemi. La modifica del Registro di sistema è a rischio e pericolo dell'utente.

La configurazione della traccia si trova nel nodo locale, in una chiave del Registro di sistema denominata Tracing nella chiave del Registro di sistema MS DTC. La Tracing chiave del Registro di sistema include la traccia della gestione connessione. In precedenza, è stata usata la chiave del Registro di sistema per configurare la TraceCMErr traccia della gestione connessione. La Tracing chiave del Registro di sistema contiene le due sottochiavi seguenti:

  • Sources: questa sottochiava configura il tipo di traccia.
  • Output: questa sottochiavi configura la posizione in cui viene inviato l'output di traccia.

Nota

Assicurarsi che il processo possa accedere alla chiave del Tracing Registro di sistema. Per impostazione predefinita, la configurazione di Windows non crea questa chiave e non concede le autorizzazioni per questa chiave. È possibile usare Editor del Registro di sistema per configurare la funzionalità di traccia.

Per creare voci del Registro di sistema delle funzionalità di traccia, seguire questa procedura:

  1. Selezionare StartAll Programs Accessories Run (Avvia >tutti i programmi>accessori>run), digitare regedit e quindi selezionare OK.

  2. Individuare e quindi selezionare una delle sotto chiavi seguenti:

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

  3. Nel menu Modifica selezionare Nuovo e quindi selezionare il tipo di dati della voce. Ad esempio, selezionare Valore DWORD (32 bit).

  4. Digitare il nome dell'origine desiderata e quindi premere INVIO. Per altre informazioni sui nomi di origine, vedere la tabella nella sezione Configurare le origini .

  5. Fare clic con il pulsante destro del mouse sulla nuova voce del Registro di sistema, scegliere Modifica, digitare il valore desiderato nella casella Dati valore e quindi selezionare OK.

  6. Nel menu File, selezionare Esci.

Configurare le origini

La Sources chiave del Registro di sistema contiene un set di valori del Registro di sistema DWORD elencati nella tabella seguente.

Nome Descrizione
TRACE_MISC Tracce che non possono essere categorizzate nelle altre categorie
TRACE_CM Tracce nella gestione connessione
TRACE_TRACE L'infrastruttura di traccia stessa
TRACE_SVC Traccia l'avvio del servizio e del file .exe
TRACE_GATEWAY Origine gateway
TRACE_UI Traccia l'interfaccia utente
TRACE_CONTACT Traccia il pool di contatti e i contatti
TRACE_UTIL Traccia le routine di utilità chiamate da più posizioni
TRACE_CLUSTER Traccia il codice specifico del cluster (utilità)
TRACE_RESOURCE Traccia il codice specifico della risorsa del cluster
TRACE_TIP Origine di traccia TIP (Transaction Internet Protocol)
TRACE_XA Origine di traccia XA Transaction Manager (XATM)
TRACE_LOG Traccia dei log
TRACE_MTXOCI Origine di traccia del livello MTS/OCI (Mtxoci.dll)
TRACE_ETWTRACE Origine di traccia di Event Tracing for Windows (ETW)
TRACE_PROXY Tracce generate nella DLL proxy MSDTC
TRACE_KTMRM Traccia per l'integrazione con Kernel Transaction Manager
TRACE_VSSBACKUP Traccia per l'integrazione con il meccanismo di backup e ripristino di Microsoft Visual SourceSafe
TRACE_PERFMON Traccia con supporto per i contatori delle prestazioni

Il valore DWORD deve essere un numero compreso tra 0 e 255. Il valore DWORD indica il livello di traccia che si verifica. Nella tabella seguente sono elencati i possibili valori DWORD.

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

Nota

I valori superiori includono automaticamente valori inferiori. Pertanto, quando si abilita il TRACE_INFO livello, viene abilitato anche il TRACE_ERROR livello . Pochissime origini usano qualsiasi traccia superiore al TRACE_VERBOSE livello.

Configurare l'output di traccia

Avviso

L'errata modifica del Registro di sistema tramite l'editor o un altro metodo può causare seri problemi. che potrebbero richiedere la reinstallazione del sistema operativo. Microsoft non è in grado di garantire la soluzione di tali problemi. La modifica del Registro di sistema è a rischio e pericolo dell'utente.

La Output chiave del Registro di sistema contiene un set di valori che controllano la posizione in cui viene inviato l'output di traccia. Questi valori sono i seguenti:

  • Il TraceFilePath valore (REG_SZ) è la cartella radice in cui devono essere archiviati i file di traccia. La traccia viene scritta in un file in una cartella denominata msdtc-X.log. In questo nome di cartella X rappresenta il PID decimale del processo che crea il file. Assicurarsi che tutti i processi di interesse possano accedere alla cartella configurata. In caso contrario, le informazioni di traccia andranno perse. Se questo valore non è impostato, le tracce non vengono inviate a un file.

  • Il ImageNameInTraceFileNameEnabled valore (REG_DWORD) determina se il nome del file di log di traccia generato include il nome del file di immagine del processo che ha richiamato il log di traccia. Se questo valore è impostato su un valore diverso da zero, il nome del file di immagine del processo verrà incluso nel file di log di traccia generato. Se questo valore è impostato su zero, il nome del file di immagine del processo non verrà incluso nel file di log di traccia generato. Per impostazione predefinita, il valore è impostato su zero (0). Di seguito è riportato un esempio di nome di file di traccia in cui il file di log generato contiene il processo:
    MSDTC-msdtc.exe-3552.log o MSDTC-svchost.exe - 3556.log

  • Il MemoryBufferSize valore (REG_DWORD) è la dimensione del buffer circolare in cui vengono archiviati i messaggi di traccia. Se questo valore è impostato su 0, la traccia della memoria è disabilitata. Per impostazione predefinita, questo valore è 10 MB. Potrebbe essere necessario aumentare questo valore se si abilita la traccia dettagliata.

  • Il DebugOutEnabled valore (REG_DWORD) abilita o disabilita l'output per il debugger. Se il valore è diverso da zero, l'output è abilitato. Per impostazione predefinita, questa Output chiave del Registro di sistema è disabilitata. Quando si modifica la configurazione di analisi degli errori di Gestione connessione, le modifiche diventano effettive quando viene riciclato un processo che carica il file Msdtcprx.dll . Ad esempio, le modifiche apportate alla configurazione di traccia degli errori di Gestione connessione diventano effettive quando il processo del servizio MS DTC viene riciclato.

In alternativa, è possibile creare un file .reg e quindi usare Editor del Registro di sistema per importare il file. A tal fine, attenersi alla seguente procedura:

  1. Creare un nuovo file .reg contenente l'esempio di codice seguente:

    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. Selezionare Avviatutti i programmiAccessoriRun, digitare regedit e quindi fare clic su OK.SelectStart> All Programs >Accessories> Run, type regedit, and then click OK.

  3. Scegliere Importa dal menu File.

  4. Individuare il file creato nel passaggio 1 e quindi selezionare Apri. Verrà visualizzata la finestra di dialogo Registro di sistema Editor.

  5. Selezionare OK.

  6. Nel menu File, selezionare Esci.

Effetto prestazioni

Per impostazione predefinita, la funzionalità di traccia è disabilitata in Windows. Pertanto, non esiste alcun effetto sulle prestazioni in un'installazione regolare.

Non abilitare la funzionalità di traccia nei computer di produzione a meno che un tecnico del supporto tecnico Microsoft non indichi che le informazioni di traccia sono necessarie per diagnosticare un problema. La traccia può influire sulle prestazioni del computer. Prima di tutto è necessario trovare il problema ed è necessario risolverlo. Disabilitare quindi immediatamente la funzionalità di traccia.

Configurazione del cluster

Per le installazioni di cluster, assicurarsi che tutte le voci del Registro di sistema in tutti i nodi contengano queste voci del Registro di sistema. Per qualsiasi nodo che non dispone di queste voci del Registro di sistema, il codice del cluster ignora le voci del Registro di sistema nel Registro di sistema condiviso perché le voci del Registro di sistema non esistono nel Registro di sistema del computer locale.