Configurar la traza de flujo de mensajes

Cuando se habilita la traza de actividad de la infraestructura Windows Communication Foundation (WCF), los id. de actividad de un extremo a otro se asignan a las actividades lógicas de la pila de WCF. Ahora, la versión 4.6.1 de .NET Framework incluye una versión de esta característica con un mayor rendimiento y que funciona con la característica de seguimiento de eventos para Windows (ETW). Esta nueva característica se denomina seguimiento del flujo de mensajes. Cuando se habilita, los identificadores de actividad de un extremo a otro se toman (o se asignan si están vacíos) de los mensajes entrantes y se propagan a todos los eventos de traza que se emiten una vez que el canal ha descodificado el mensaje. Los clientes pueden utilizar esta característica para reconstruir flujos de mensajes con registros de seguimiento de distintos servicios tras la descodificación.

Se puede habilitar la traza al detectar un problema con la aplicación y, a continuación, deshabilitarla una vez resuelto el problema.

La habilitación del seguimiento

Puede habilitar la traza del flujo de mensajes estableciendo el elemento de configuración messageFlowTracing de .NET Framework 4 como true, tal y como se muestra en el siguiente ejemplo.

<system.servicemodel>  
  <diagnostics>  
    <endToEndTracing propagateActivity="true" messageFlowTracing="true" />  
  </diagnostics>  
</system.servicemodel>  

Nota

Dado que el elemento de configuración endToEndTracing reside en un archivo Web.config, no se puede configurar dinámicamente de la misma manera que ETW. Para que el elemento de configuración endToEndTracing surta efecto, hay que reciclar la aplicación.

Las actividades se correlacionan mediante el intercambio de un identificador denominado de actividad. Este identificador es un GUID y lo genera la clase System.Diagnostics.CorrelationManager. Si manipula el System.Diagnostics.Trace.CorrelationManager.ActivityID, asegúrese de que el valor se establece en el valor original cuando el control de la ejecución se vuelve a transferir al código WCF. Además, si usa un modelo de programación WCF asincrónico, se asegura de que el System.Diagnostics.Trace.CorrelationManager.ActivityID se transfiere entre los subprocesos.

Seguimiento de flujo de mensajes y servicios REST

El seguimiento de flujo de mensajes permite realizar un seguimiento a una solicitud extremo a extremo. Con servicios basados en SOAP- se envía un Id. de actividad en un encabezado de mensaje SOAP. Las solicitudes REST no contienen este encabezado, por ello se usa un encabezado especial de eventos HTTP en su lugar. El fragmento de código siguiente muestra cómo se puede recuperar mediante programación el valor de Id. de actividad:

Object output = null;
if (OperationContext.Current.IncomingMessageProperties.TryGetValue(HttpRequestMessageProperty.Name, out output))
{
   HttpRequestMessageProperty httpHeaders = output as HttpRequestMessageProperty;
   // Retrieve the Activity Id from the HTTP header    string e2eId = httpHeaders.Headers["E2EActivity"];
   // ...
}

Puede agregar el encabezado mediante programación usando el código siguiente:

HttpContent content = new StreamContent(contentStream);  
Guid correlation = Guid.NewGuid();  
content.Headers.Add("E2EActivity", Convert.ToBase64String(correlation.ToByteArray()));