Condividi tramite


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

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, il ripristino e la modifica del Registro di sistema, vedere Informazioni del Registro di sistema di Windows per utenti avanzati.

Tipi di strutture di traccia

  • Traccia di Gestione transazioni

    La traccia di Gestione transazioni 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. Il gestore delle transazioni fa parte del servizio MS DTC.

  • Traccia degli errori di Gestione comunicazioni

    La traccia degli errori di Gestione comunicazioni (CM) tiene traccia di qualsiasi processo che carica il file Msdtcprx.dll e che utilizza 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.

Note

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 tale scopo, effettuare i passaggi seguenti:

  1. Fare clic su Start, scegliere Tutti i programmi, fare clic su Accessori e quindi su Esegui.

  2. Digitare comexp.msc e quindi selezionare OK.

  3. Espandere Servizi componenti, espandere Computer, Computer, 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
        • Tracciare transazioni di lunga durata

Quando si modifica la configurazione della 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 ha un sistema di traccia nuovo e completo. Il nuovo sistema ha gli obiettivi di progettazione seguenti:

  • Per aggiungere una traccia formattata è necessaria una sola riga di codice.
  • La traccia è leggibile dagli esseri umani 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. Questo controllo è controllato dalla chiave del Registro di sistema di 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 sotto la 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 chiavi secondarie seguenti:

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

Note

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 a questa chiave. È possibile usare l'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 Start All Programs Accessories Run (Avvia>tutti i programmi>accessori>), digitare regedit e quindi selezionare OK.

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

    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC\Tracing\Sources
    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC\Tracing\Output
  3. Scegliere Nuovo dal menu Modifica 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 scegliere 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 classificate nelle altre categorie
TRACE_CM Tracce della gestione connessione
TRACE_TRACE Infrastruttura di traccia
TRACE_SVC Tracce dell'avvio di servizi e file con estensione exe
TRACE_GATEWAY Origine gateway
TRACE_UI Traccia l'interfaccia utente
TRACE_CONTACT Tracce di pool di contatti e contatti
TRACE_UTIL Tracce delle routine dell'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 della gestione transazioni XA (XATM)
TRACE_LOG Traccia dei log
TRACE_MTXOCI Origine di traccia MTS/OCI (Mtxoci.dll)
TRACE_ETWTRACE Origine traccia eventi per 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 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

I valori più alti 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 dove viene inviato l'output di traccia. I valori sono i seguenti:

  • Il TraceFilePath valore (REG_SZ) è la cartella radice in cui archiviare 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 è 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 nel 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 traccia degli errori della gestione connessione, le modifiche diventano effettive quando un processo che carica il file Msdtcprx.dll viene riciclato. Ad esempio, le modifiche apportate alla configurazione di traccia degli errori della gestione connessione diventano effettive quando il processo del servizio MS DTC viene riciclato.

In alternativa, è possibile creare un file .reg e quindi usare l'editor del Registro di sistema per importare il file. A tale scopo, effettuare i passaggi seguenti:

  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 Avvia>tutti i programmi>Accessori>Run, digitare regedit e quindi fare clic su 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 Editor registro di sistema.

  5. Seleziona 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 professionista 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 del 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.