Habilitación del seguimiento de diagnóstico para MS DTC en un equipo Windows 10

  • Artículo

En este artículo se describe cómo habilitar el seguimiento de diagnóstico para el Coordinador de transacciones distribuidas de Microsoft (MS DTC) en un equipo Windows 10.

Versión original del producto: Windows 10
Número de KB original: 926099

Importante

Este artículo contiene información sobre cómo modificar el Registro. Asegúrese de hacer una copia de seguridad del Registro antes de modificarlo. Asegúrese de saber cómo recuperar el registro en caso de producirse algún problema. Para obtener más información sobre cómo realizar copias de seguridad, restaurar y modificar el Registro, vea Información del Registro de Windows para usuarios avanzados.

Tipos de instalaciones de seguimiento

  • Seguimiento del administrador de transacciones

    El seguimiento del administrador de transacciones (TM) realiza un seguimiento de los cambios en el estado de la transacción. Lo genera el administrador de transacciones de MS DTC. La salida está en formato binario y se debe dar formato a la salida. El administrador de transacciones forma parte del servicio MS DTC.

  • Seguimiento de errores del administrador de comunicaciones

    El seguimiento de errores del administrador de comunicaciones (CM) realiza un seguimiento de cualquier proceso que cargue el archivo Msdtcprx.dll y que use la interfaz de llamada a procedimiento remoto (RPC) de MS DTC para comunicarse con otros procesos relacionados con MS DTC. La salida está en formato de texto. El error 0x8004d00a es un error típico para el que el seguimiento de errores del administrador de comunicaciones puede ser útil.

Nota:

El seguimiento del administrador de transacciones y el seguimiento de errores del administrador de comunicaciones son procesos independientes. Puede habilitar de forma independiente el seguimiento del administrador de transacciones y el seguimiento de errores del administrador de comunicaciones. O bien, puede deshabilitarlos de forma independiente.

Habilitación del seguimiento del administrador de transacciones

Puede usar el complemento Component Services Microsoft Management Console (MMC) para habilitar el seguimiento del administrador de transacciones. Para ello, siga estos pasos:

  1. Seleccione Inicio, Todos los programas, Accesorios y, a continuación, Ejecutar.

  2. Escriba comexp.msc y, a continuación, seleccione Aceptar.

  3. Expanda Servicios de componentes, equipos, mi equipo, administrador de transacciones distribuidas, haga clic con el botón derecho en Local DTCy, a continuación, seleccione Propiedades.

  4. Seleccione la pestaña Seguimiento .

  5. En la pestaña Seguimiento , puede modificar las siguientes opciones de seguimiento de TM:

    • Salida de seguimiento
      • Transacciones de seguimiento
        • Seguimiento de todas las transacciones
        • Seguimiento de transacciones anuladas
        • Transacciones de Long-Lived de seguimiento

Al cambiar la configuración de seguimiento de TM, el servicio MS DTC detecta los cambios. Sin embargo, no es necesario reciclar el proceso. Por ejemplo, al cambiar las transacciones de las que se realiza el seguimiento o la ubicación del archivo de seguimiento, el servicio MS DTC detecta el cambio en el Registro. No es necesario reiniciar el servicio MS DTC.

Nuevo sistema de seguimiento de MS DTC en Windows

En Windows, MS DTC tiene un sistema de seguimiento nuevo y extenso. El nuevo sistema tiene los siguientes objetivos de diseño:

  • Solo se requiere una sola línea de código para agregar un seguimiento con formato.
  • Los seres humanos pueden leer el seguimiento en equipos de producción sin una red.
  • Las opciones de salida son flexibles.
  • El seguimiento es rápido.
  • No es necesario reiniciar el equipo para cambiar las opciones.

Además, en Windows 10 y Windows Server Technical Preview, el nombre del archivo de registro de seguimiento incluye el nombre del proceso que invocó el registro de seguimiento. Esto se controla mediante la clave del Registro de salida.

Configuración del seguimiento

Advertencia

Es posible que se produzcan problemas graves si modifica el Registro de forma incorrecta mediante el Editor del Registro u otro método. Estos problemas pueden requerir la reinstalación del sistema operativo. Microsoft no puede garantizar que estos problemas se puedan solucionar. Modifique el Registro bajo su propia responsabilidad.

La configuración de seguimiento se encuentra en el nodo local, en una clave del Registro que se denomina Tracing en la clave del Registro MS DTC. La Tracing clave del Registro incluye el seguimiento del administrador de conexiones. Anteriormente, usó la clave del Registro para configurar el TraceCMErr seguimiento del administrador de conexiones. La Tracing clave del Registro contiene las dos subclaves siguientes:

  • Sources: esta subclase configura el tipo de seguimiento.
  • Output: esta subclase configura dónde se envía la salida de seguimiento.

Nota:

Asegúrese de que el proceso puede acceder a la clave del Tracing Registro. De forma predeterminada, la configuración de Windows no crea esta clave y no concede permisos a esta clave. Puede usar registry Editor para configurar la funcionalidad de seguimiento.

Para crear entradas del Registro de funcionalidad de seguimiento, siga estos pasos:

  1. Seleccione Iniciar>todos los accesorios de programas>>Ejecutar, escriba regedit y, a continuación, seleccione Aceptar.

  2. Busque y seleccione una de las siguientes subclaves:

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

  3. En el menú Editar , seleccione Nuevo y, a continuación, seleccione el tipo de datos de la entrada. Por ejemplo, seleccione Valor DWORD (32 bits).

  4. Escriba el nombre del origen deseado y, a continuación, presione ENTRAR. Para obtener más información sobre los nombres de origen, vea la tabla de la sección Configurar orígenes .

  5. Haga clic con el botón derecho en la nueva entrada del Registro, seleccione Modificar, escriba el valor que desee en el cuadro Datos de valor y, a continuación, seleccione Aceptar.

  6. En el menú Archivo, seleccione Abrir.

Configuración de orígenes

La Sources clave del Registro contiene un conjunto de valores del Registro DWORD que se enumeran en la tabla siguiente.

Nombre Descripción
TRACE_MISC Seguimientos que no se pueden clasificar en las otras categorías
TRACE_CM Seguimientos en el administrador de conexiones
TRACE_TRACE La propia infraestructura de seguimiento
TRACE_SVC Servicio de seguimiento y inicio de archivo de .exe
TRACE_GATEWAY Origen de puerta de enlace
TRACE_UI Realiza un seguimiento de la interfaz de usuario
TRACE_CONTACT Realiza un seguimiento del grupo de contactos y los contactos
TRACE_UTIL Realiza un seguimiento de las rutinas de la utilidad a las que se llama desde varias ubicaciones
TRACE_CLUSTER Realiza un seguimiento del código específico del clúster (utilidad)
TRACE_RESOURCE Realiza un seguimiento del código específico del recurso del clúster.
TRACE_TIP Origen de seguimiento del protocolo de Internet de transacción (TIP)
TRACE_XA Origen de seguimiento del Administrador de transacciones XA (XATM)
TRACE_LOG Seguimiento de registros
TRACE_MTXOCI Origen de seguimiento de capa MTS/OCI (Mtxoci.dll)
TRACE_ETWTRACE Origen de seguimiento de seguimiento de eventos para Windows (ETW)
TRACE_PROXY Seguimientos generados en el archivo DLL del proxy MSDTC
TRACE_KTMRM Seguimiento para la integración con el Administrador de transacciones del kernel
TRACE_VSSBACKUP Seguimiento para la integración con el mecanismo de copia de seguridad y restauración de Microsoft Visual SourceSafe
TRACE_PERFMON Seguimiento con compatibilidad con contadores de rendimiento

El valor DWORD debe ser un número comprendido entre 0 y 255. El valor DWORD indica el nivel de seguimiento que se produce. En la tabla siguiente se enumeran los posibles valores DWORD.

Valor Descripción
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

Nota:

Los valores más altos incluyen automáticamente valores inferiores. Por lo tanto, al habilitar el TRACE_INFO nivel, el TRACE_ERROR nivel también está habilitado. Muy pocos orígenes usan cualquier seguimiento que sea superior al TRACE_VERBOSE nivel.

Configuración de la salida de seguimiento

Advertencia

Es posible que se produzcan problemas graves si modifica el Registro de forma incorrecta mediante el Editor del Registro u otro método. Estos problemas pueden requerir la reinstalación del sistema operativo. Microsoft no puede garantizar que estos problemas se puedan solucionar. Modifique el Registro bajo su propia responsabilidad.

La Output clave del Registro contiene un conjunto de valores que controlan dónde se envía la salida de seguimiento. Estos valores son los siguientes:

  • El TraceFilePath valor (REG_SZ) es la carpeta raíz en la que se deben almacenar los archivos de seguimiento. El seguimiento se escribe en un archivo de una carpeta denominada msdtc-X.log. En este nombre de carpeta, X representa el PID decimal del proceso que crea el archivo. Asegúrese de que todos los procesos de interés pueden acceder a la carpeta configurada. De lo contrario, se perderá la información de seguimiento. Si no se establece este valor, los seguimientos no se envían a un archivo.

  • El ImageNameInTraceFileNameEnabled valor (REG_DWORD) determina si el nombre del archivo de registro de seguimiento generado incluye el nombre del archivo de imagen del proceso que invocó el registro de seguimiento. Si se establece en un valor distinto de cero, el nombre del archivo de imagen del proceso se incluirá en el archivo de registro de seguimiento que se genera. Si este valor se establece en cero, el nombre del archivo de imagen del proceso no se incluirá en el archivo de registro de seguimiento generado. De forma predeterminada, el valor se establece en cero (0). A continuación se muestra un ejemplo de un nombre de archivo de seguimiento en el que el archivo de registro generado contiene el proceso:
    MSDTC-msdtc.exe-3552.log o MSDTC-svchost.exe: 3556.log

  • El MemoryBufferSize valor (REG_DWORD) es el tamaño del búfer circular en el que se almacenan los mensajes de seguimiento. Si este valor se establece en 0, se deshabilita el seguimiento de memoria. De forma predeterminada, este valor es de 10 MB. Es posible que tenga que aumentar este valor si habilita el seguimiento detallado.

  • El DebugOutEnabled valor (REG_DWORD) habilita o deshabilita la salida en el depurador. Si el valor es distinto de cero, la salida está habilitada. De forma predeterminada, esta Output clave del Registro está deshabilitada. Al cambiar la configuración de seguimiento de errores del administrador de conexiones, los cambios surten efecto cuando se recicla un proceso que carga el archivo Msdtcprx.dll . Por ejemplo, los cambios en la configuración de seguimiento de errores del administrador de conexiones surten efecto cuando se recicla el proceso del servicio MS DTC.

Como alternativa, puede crear un archivo .reg y, a continuación, puede usar Editor del Registro para importar el archivo. Para ello, siga estos pasos:

  1. Cree un nuevo archivo .reg que contenga el ejemplo de código siguiente:

    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. Seleccione Iniciar>todos los accesorios de programas>>Ejecutar, escriba regedit y, a continuación, haga clic en Aceptar.

  3. En el menú Archivo , seleccione Importar.

  4. Busque el archivo que creó en el paso 1 y, a continuación, seleccione Abrir. Aparece el cuadro de diálogo Editor del Registro.

  5. Seleccione Aceptar.

  6. En el menú Archivo, seleccione Abrir.

Efecto de rendimiento

De forma predeterminada, la funcionalidad de seguimiento está deshabilitada en Windows. Por lo tanto, no existe ningún efecto de rendimiento en una instalación regular.

No habilite la funcionalidad de seguimiento en equipos de producción a menos que un profesional de soporte al cliente de Microsoft indique que la información de seguimiento es necesaria para diagnosticar un problema. El seguimiento puede afectar al rendimiento del equipo. En primer lugar, debe encontrar el problema y debe resolverlo. A continuación, deshabilite inmediatamente la funcionalidad de seguimiento.

Configuración del clúster

En el caso de las instalaciones de clúster, asegúrese de que todas las entradas del Registro de todos los nodos contienen estas entradas del Registro. Para cualquier nodo que no tenga estas entradas del Registro, el código del clúster omite las entradas del Registro en el registro compartido porque las entradas del Registro no existen en el registro del equipo local.