Seguimiento del diagnóstico

Los rastros son la publicación de mensajes concretos que se generan durante la ejecución de la aplicación. Cuando se utiliza traza debe existir un mecanismo para recopilar y registrar los mensajes que se envían. Los agentes de escucha son los objetos encargados de recibir los mensajes de seguimiento. Un agente de escucha se encarga de recopilar, almacenar y enrutar los mensajes de seguimiento. Los agentes de escucha dirigen los resultados del seguimiento a un destino apropiado, como un registro, una ventana o un archivo de texto.

Un tal agente de escucha, DefaultTraceListener, se crea y se inicializa automáticamente si la traza está habilitada. Si desea que los resultados de la traza se envíen a otros destinos adicionales, deberá crear e inicializar agentes de escucha adicionales. Los agentes de escucha que cree deben reflejar sus necesidades particulares. Por ejemplo, podría desear obtener un registro de texto con todo el resultado del seguimiento. En este caso, debe crear un agente de escucha que escriba en un nuevo archivo de texto cuando se habilite. Por otro lado, podría desear ver los resultados durante la aplicación de la ejecución. En ese caso, podría crear un agente de escucha que enviara todos los resultados a una ventana de consola. EventLogTraceListener puede enviar los resultados del seguimiento a un registro de eventos, y TextWriterTraceListener puede escribir esos mismos resultados en una secuencia

La habilitación del seguimiento

Para habilitar los rastros durante el procesamiento de transacciones, debe modificar el archivo de configuración de su aplicación. A continuación se muestra un ejemplo.

<configuration>  
<system.diagnostics>  
     <sources>  
          <source name="System.Transactions" switchValue="Warning">  
               <listeners>  
                    <add name="tx"
                     type="System.Diagnostics.XmlWriterTraceListener"
                     initializeData= "tx.log" />  
               </listeners>  
          </source>  
     </sources>  
</system.diagnostics>  
</configuration>  

Los rastros System.Transactions se escriben en el origen denominado "System.Transactions." Puede utilizar add para especificar el nombre y tipo de agente de escucha de seguimiento que desea utilizar. En nuestra configuración del ejemplo, denominamos "tx" del agente de escucha y agregamos el agente de escucha de seguimiento de .NET Framework estándar (XmlWriterTraceListener) como el tipo que deseamos utilizar. Utilice initializeData para establecer el nombre del archivo de registro para ese agente de escucha. Además, puede sustituir una ruta de acceso completa para un nombre de archivo simple.

A cada tipo de mensaje de seguimiento le está asignado un nivel para indicar su grado de importancia. Si el dominio de aplicación del nivel de seguimiento es igual o menor que el nivel de un tipo de evento, a continuación, se genera ese mensaje. switchValue controla el nivel de seguimiento en el archivo de configuración. Los niveles que están asociados a mensajes de seguimiento de diagnóstico se definen en la tabla siguiente.

Nivel de seguimiento	Descripción
Crítico	Los errores serios, como lo siguiente, han producido: - Un error que puede producir una pérdida inmediata de funcionalidad del usuario. - Un evento que exige a un administrador que tome medidas para evitar la pérdida de funcionalidad. - El código no responde. - Este nivel de la traza también puede proporcionar el contexto suficiente para interpretar otros rastros críticos. Esto puede ayudar a identificar la secuencia de operaciones que conducen a un error serio.
Error	Se ha producido un error (por ejemplo, configuración no válida o comportamiento de la red) que puede producir una pérdida de funcionalidad del usuario.
Advertencia	Existe una condición que puede producir como consecuencia un error o error crítico (por ejemplo, error de asignación o aproximación a un límite). El procesamiento normal de errores del código de usuario (por ejemplo, transacciones anuladas, tiempos de espera, error en la autenticación) también puede generar un mensaje de advertencia.
Información	Se han generado mensajes útiles para supervisar y diagnosticar el estado del sistema, medir el rendimiento o perfilar. Éstos pueden incluir transacción e inscripción de los eventos perpetuos, como una transacción que se está creando o confirmando, el cruce de un límite significativo o la asignación de recursos significativos. Un programador puede utilizar a continuación tal información para el diseño de la capacidad y gestión de rendimiento.

Códigos de seguimiento

La tabla siguiente hace una lista de los códigos de seguimiento que se generan mediante la infraestructura System.Transactions. Se incluye en la tabla el identificador de código de seguimiento, el nivel de enumeración EventType para el seguimiento, y los datos adicionales contenidas en TraceRecord para el seguimiento. Además, el nivel de seguimiento correspondiente del seguimiento también está almacenado en TraceRecord.

TraceCode	EventType	Datos adicionales en TraceRecord
TransactionCreated	Información	TransactionTraceId
TransactionPromoted	Información	TransactionTraceId local, TransactionTraceId distribuido
EnlistmentCreated	Información	TransactionTraceId, EnlistmentTraceId, EnlistmentType (durable/volátil), EnlistmentOptions
EnlistmentCallbackNegative	Advertencia	TransactionTraceId, EnlistmentTraceId Devolución de llamada (deshecho forzado/anulado/dudoso)
TransactionRollbackCalled	Advertencia	TransactionTraceId
TransactionAborted	Advertencia	TransactionTraceId
TransactionInDoubt	Advertencia	TransactionTraceId
TransactionScopeCreated	Información	TransactionScopeResult, que puede ser lo siguientes: - Nueva transacción. - Transacción pasada. - Transacción dependiente pasada. - Utilizando la transacción actual. - Sin transacción. Nueva TransactionTraceId actual
TransactionScopeDisposed	Información	TransactionTraceId de la transacción actual «esperada» del ámbito.
TransactionScopeIncomplete	Advertencia	TransactionTraceId de la transacción actual «esperada» del ámbito.
TransactionScopeNestedIncorrectly	Advertencia	TransactionTraceId de la transacción actual «esperada» del ámbito.
TransactionScopeCurrentTransactionChanged	Advertencia	TransactionTraceId actual anterior, otro TransactionTraceId
TransactionScopeTimeout	Advertencia	TransactionTraceId de la transacción actual «esperada» del ámbito.
DependentCloneCreated	Información	TransactionTraceId, tipo de transacción dependiente creada (RollbackIfNotComplete/BlockCommitUntilComplete)
DependentCloneComplete	Información	TransactionTraceId
RecoveryComplete	Información	Recurso Administrador GUID (de la base)
Reenlist	Información	Recurso Administrador GUID (de la base)
TransactionSerialized	Información	TransactionTraceId.
TransactionException	Error	Mensaje de la excepción
InvalidOperationException	Error	Mensaje de la excepción
InternalError	Crítico	Mensaje de la excepción
TransferEvent		Cuando se deserializa una transacción, o se promueve una transacción System.Transactions a uno distribuido, se escriben los ActivityID actuales de ExecutionContext y el Id. de la transacción distribuida. Cuando la DTC llama de nuevo en el código administrado, el Id. de la transacción distribuida se establece como ActivityID en ExecutionContext para la duración de la devolución de llamada.
ConfiguredDefaultTimeoutAdjusted	Advertencia	Ningún dato adicional
TransactionTimeout	Advertencia	La TransactionTraceId de la transacción habiendo agotado el tiempo de espera.

El esquema XML para cada uno de los elementos de datos adicionales anteriores tiene el formato siguiente.

TransactionTraceIdentifier

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

< CloneIdentifier >

the clone id number

</CloneIdentifier>

</TransactionTraceIdentifier>

EnlistmentTraceIdentifier

<EnlistmentTraceIdentifier>

<ResourceManagerId>

string form of guid

</ResourceManagerId>

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

<CloneIdentifier >

the clone id number

</CloneIdentifier>

<TransactionTraceIdentifier>

<EnlistmentIdentifier>

the enlistment id number

</EnlistmentIdentifier>

</EnlistmentTraceIdentifier>

Identificador del administrador de recursos

<ResourceManagerId>

string form of guid

</ResourceManagerId>

Problemas de seguridad para seguir paso a paso

Cuando usted como administrador comience el seguimiento, la información confidencial se podría escribir en un registro de seguimiento que está de forma predeterminada públicamente visible. Para mitigar cualquier posible amenaza de seguridad, debería considerar almacenar el registro de seguimiento en una ubicación segura controlado por recurso compartido y permisos de acceso del sistema de archivos.