Traza analítica de WCF

Este ejemplo muestra cómo agregar sus propios eventos de seguimiento en el flujo de seguimientos analíticos que Windows Communication Foundation (WCF) escribe en ETW en .NET Framework versión 4. Los seguimientos analíticos pretenden facilitar la visibilidad en los servicios sin que el rendimiento se vea penalizado. En este ejemplo se muestra cómo utilizar las API System.Diagnostics.Eventing para escribir eventos que se integran con los servicios de WCF.

Para obtener más información sobre las API System.Diagnostics.Eventing, vea System.Diagnostics.Eventing.

Para obtener más información acerca de la traza de eventos en Windows, vea Mejorar el ajuste de la depuración y el rendimiento con ETW.

Nota:

Puede que los ejemplos ya estén instalados en su equipo. Compruebe el siguiente directorio (valor predeterminado) antes de continuar. <InstallDrive>:\WF_WCF_Samples Si no existe este directorio, vaya a la página de ejemplos de Windows Communication Foundation (WCF) y Windows Workflow Foundation (WF) Samples para .NET Framework 4 para descargar todos los ejemplos de WF y Windows Communication Foundation (WCF). Este ejemplo se encuentra en el siguiente directorio. <InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\AnalyticTraceExtensibility

Eliminar EventProvider

En este ejemplo se usa la clase System.Diagnostics.Eventing.EventProvider, que implementa el objeto System.IDisposable. Al implementar el seguimiento de un servicio de WCF, es probable que pueda utilizar los recursos de EventProvider mientras dura el servicio. Por esta razón y para conservar la legibilidad, este ejemplo nunca elimina el objeto EventProvider ajustado. Si por alguna razón su servicio tiene requisitos diferentes para el seguimiento y debe eliminar este recurso, debería modificar este ejemplo de acuerdo con los procedimientos recomendados para eliminar los recursos no administrados. Para obtener más información sobre eliminar los recursos no administrados, vea Implementar un método de eliminación.

Autohospedamiento y hospedamiento en web

Para los servicios hospedados en web, los seguimientos analíticos de WCF proporcionan un campo, denominado "HostReference", que se utiliza para identificar el servicio que está emitiendo los seguimientos. Los seguimientos extensibles de usuario pueden participar en este modelo; este ejemplo muestra los procedimientos recomendados para ello. El formato de una referencia al hospedamiento en web cuando el carácter '|' de canalización aparece realmente en la cadena resultante puede ser cualquiera de los siguientes:

• Si la aplicación no está en la raíz.

  <nombreDeSitio><rutaDeAccesoVirtualDeAplicación>|<rutaDeAccesoVirtualDeServicio>|<nombreDeServicio>

• Si la aplicación está en la raíz.

  <nombreDeSitio>|<rutaDeAccesoVirtualDeServicio>|<nombreDeServicio>

En los servicios autohospedados, los seguimientos analíticos de WCF no rellenan el campo "HostReference". La clase WCFUserEventProvider de este ejemplo se comporta de forma coherente cuando se utiliza en un servicio autohospedado.

Detalles de eventos personalizados

El manifiesto del proveedor de eventos de ETW de WCF define tres eventos que están diseñados para ser emitidos por los autores de servicios de WCF desde dentro del código del servicio. La siguiente tabla muestra un desglose de los tres eventos:

Para utilizar este ejemplo

1. Con Visual Studio 2010, abra el archivo de solución WCFAnalyticTracingExtensibility.sln.

2. Presione F6 para compilar la solución.

3. Presione CTRL+F5 para ejecutar la solución.

   En el explorador web, haga clic en Calculator.svc. El URI del documento WSDL para el servicio debería aparecer en el explorador. Copie ese URI.

4. Ejecute el cliente de prueba de WCF (WcfTestClient.exe).

   El cliente de prueba de WCF (WcfTestClient.exe) se encuentra en el <directorio de instalación de Visual Studio 2010 >\Common7\IDE\WcfTestClient.exe (de forma predeterminada, el directorio de instalación de Visual Studio 2010 es C:\Common7\IDE\ WcfTestClient.exe).

5. Dentro del cliente de prueba de WCF, agregue el servicio seleccionando Archivo y, a continuación, Agregar servicio.

   Agregue la dirección del extremo en el cuadro de entrada.

6. Haga clic en Aceptar para cerrar el cuadro de diálogo.

   El servicio ICalculator se agrega en el recuadro izquierdo bajo Mis proyectos de servicios.

7. Abra la aplicación Visor de eventos.

   Antes de invocar el servicio, inicie el Visor de eventos y asegúrese de que el registro de eventos escucha los eventos de seguimiento emitidos por el servicio de WCF.

8. En el menú Inicio, seleccione Herramientas administrativas y, a continuación, Visor de eventos. Habilite los registros de Depuración y Analíticos.

9. En la vista de árbol del Visor de eventos, navegue hasta Visor de eventos, Registros de aplicaciones y servicios, Microsoft Windows y Servidor de aplicaciones-Aplicaciones. Haga clic con el botón secundario en Servidor de aplicaciones-Aplicaciones, seleccione Ver y, después, Mostrar registros analíticos y de depuración.

   Asegúrese de que esté activada la opción Mostrar registros analíticos y de depuración. Habilite el registro Analítico.

   íEn la vista de árbol del Visor de eventos, navegue hasta Visor de eventos, Registros de aplicaciones y servicios, Microsoft Windows, Servidor de aplicaciones-Aplicaciones y Analítico. Haga clic con el botón secundario en Analítico y seleccione Habilitar registro.

10. Pruebe el servicio con el cliente de prueba de WCF.

    1. En el cliente de prueba de WCF, haga doble clic en Add() bajo el nodo de servicio ICalculator.

       El método Add() aparece en el recuadro derecho con dos parámetros.

    2. Escriba 2 en el primer parámetro y 3 en el segundo.

    3. Haga clic en Invocar para invocar el método.

11. Vaya a la ventana del Visor de eventos que ya ha abierto. Navegue hasta Visor de eventos, Registros de aplicaciones y servicios, Microsoft, Windows, Aplicaciones de servidor-Aplicaciones.

12. Haga clic con el botón secundario en el nodo Analítico y seleccione Actualizar.

    Los eventos aparecen en el recuadro derecho.

13. Busque el evento con el identificador 303 y haga doble clic en él para abrirlo e inspeccionar su contenido.

    Este evento fue emitido por el método Add() del servicio ICalculator y tenía una carga igual a "2+3=5".

Para realizar la limpieza (Opcional)

1. Abra el Visor de eventos.

2. Desplácese hasta Visor de eventos, Registros de aplicaciones y servicios, Microsoft Windows y Aplicaciones de servidor-Aplicaciones. Haga clic con el botón secundario en Analítico y seleccione Deshabilitar registro.

3. Desplácese hasta Visor de eventos, Registros de aplicaciones y servicios, Microsoft Windows, Aplicaciones de servidor-Aplicaciones y, después, en Analítico. Haga clic con el botón secundario en Analítico y seleccione Borrar registro.

4. Haga clic en Borrar para borrar los eventos.

Problema conocido

Existe un problema conocido en el Visor de eventos en virtud del cual el visor no puede descodificar eventos de ETW. Puede ver un mensaje de error similar a: "No se puede encontrar la descripción del id. de evento <id.> del origen Microsoft-Windows-Servidor de aplicaciones-Aplicaciones. El componente que genera este evento no está instalado en el equipo local, o bien la instalación está dañada. Puede instalar o reparar el componente en el equipo local". Si encuentra este error, seleccione Actualizar en el menú Acciones. El evento debería descodificarse entonces correctamente.

Nota:

Puede que los ejemplos ya estén instalados en su equipo. Compruebe el siguiente directorio (valor predeterminado) antes de continuar. <InstallDrive>:\WF_WCF_Samples Si no existe este directorio, vaya a la página de ejemplos de Windows Communication Foundation (WCF) y Windows Workflow Foundation (WF) Samples para .NET Framework 4 para descargar todos los ejemplos de WF y Windows Communication Foundation (WCF). Este ejemplo se encuentra en el siguiente directorio. <InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\ETWTrace