Compartir a través de


Herramienta del visor de seguimiento de servicio (SvcTraceViewer.exe)

Windows Communication Foundation (WCF) Service Trace Viewer Tool le ayuda a analizar los seguimientos de diagnóstico generados por WCF. Service Trace Viewer proporciona una manera de combinar, ver y filtrar fácilmente mensajes de seguimiento en el registro para poder diagnosticar, reparar y comprobar problemas del servicio WCF.

Configuración del rastreo

El seguimiento de diagnóstico le proporciona información que muestra lo que está pasando a lo largo de la operación de su aplicación. Como indica el nombre, puede seguir las operaciones desde su origen hasta el destino y a través de puntos intermedios.

Puede configurar el seguimiento mediante el archivo de configuración de la aplicación, ya sea Web.config para aplicaciones hospedadas en web o Appname.config para aplicaciones autohospedada. A continuación se muestra un ejemplo:

<system.diagnostics>
    <trace autoflush="true" />
    <sources>
            <source name="System.ServiceModel"
                    switchValue="Information, ActivityTracing"
                    propagateActivity="true">
            <listeners>
               <add name="sdt"
                   type="System.Diagnostics.XmlWriterTraceListener"
                   initializeData= "SdrConfigExample.e2e" />
            </listeners>
         </source>
    </sources>
</system.diagnostics>

En este ejemplo, se especifica el nombre y el tipo del agente de escucha de seguimiento. El agente de escucha se denomina sdt y se agrega como tipo el agente de escucha de traza estándar de .NET Framework (System.Diagnostics.XmlWriterTraceListener). El atributo initializeData se utiliza para establecer el nombre del archivo de log de ese Listener a SdrConfigExample.e2e. Para el archivo de registro, puede sustituir una ruta de acceso completa para un nombre de archivo simple.

En el ejemplo se crea un archivo en el directorio raíz denominado SdrConfigExample.e2e. Al usar el Visor de seguimiento para abrir el archivo como se describe en la sección "Abrir y ver archivos de seguimiento de WCF", puede ver todos los mensajes que se han enviado.

La configuración de switchValue controla el nivel de traza. Los niveles de seguimiento disponibles se describen en la tabla siguiente.

Nivel de seguimiento Descripción
Crítico - Registra las entradas Fail-Fast y Event Log, además de realizar el seguimiento de la información de correlación. A continuación se muestran algunos ejemplos de cuándo puede usar el nivel Crítico:
- El appDomain se ha inactivo debido a una excepción no controlada.
- La aplicación no se puede iniciar.
- El mensaje que provocó el error se originó en el proceso MyApp.exe.
Error : registra todas las excepciones. Puede usar el nivel Error en las situaciones siguientes:
- Su código se ha bloqueado debido a una excepción de conversión no válida.
- Una excepción "no se pudo crear el punto de conexión" provoca un error en la aplicación al iniciarse.
Advertencia - Existe una condición que puede provocar posteriormente un error o un error crítico. Puede usar este nivel en las situaciones siguientes:
- La aplicación recibe más solicitudes de las que permite su configuración de control de velocidad.
- La cola receptora está al 98 por ciento de su capacidad configurada.
Información - Se generan mensajes útiles para supervisar y diagnosticar el estado del sistema, medir el rendimiento o generar la generación de perfiles. Puede usar esta información para la planificación de la capacidad y la administración del rendimiento. Puede usar este nivel en las situaciones siguientes:
: se produjo un error después de que el mensaje llegara a AppDomain y se deserializara.
- Error al crear el enlace HTTP.
Verboso - Seguimiento de nivel de depuración para el código de usuario y el servicio. Establezca este nivel cuando:
- No está seguro de qué método del código se llamó cuando se produjo el error.
- Tiene un punto de conexión incorrecto configurado y el servicio no se pudo iniciar porque la entrada en el almacén de reservas está bloqueada.
ActivityTracing Flujo de eventos entre las actividades de procesamiento y los componentes.

Este nivel permite a los administradores y desarrolladores correlacionar las aplicaciones en el mismo dominio de aplicación.

- Seguimiento de los límites de actividad: iniciar/detener.
- Seguimientos de transferencias.

Puede usar add para especificar el nombre y el tipo del agente de escucha de seguimiento que desea usar. En la configuración del ejemplo, el agente de escucha se denomina sdt y se agrega como tipo el agente de escucha de traza de .NET Framework estándar (System.Diagnostics.XmlWriterTraceListener). Use initializeData para establecer el nombre del archivo de registro para ese agente de escucha. Además, puede sustituir un nombre de archivo simple por una ruta de acceso completa.

A partir de .NET Framework 4.8, los controles ComboBox en algunos temas de contraste alto se muestran en el color correcto. Para deshabilitar este cambio, quite la siguiente configuración del archivo svcTraceViewer.exe.config :

<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />

Uso de la herramienta Service Trace Viewer

Abrir y ver archivos de seguimiento de WCF

Service Trace Viewer admite tres tipos de archivo:

  • Archivo de seguimiento de WCF (.svcLog)

  • Archivo de seguimiento de eventos (.etl)

  • Archivo de seguimiento carmesí

Service Trace Viewer permite abrir cualquier archivo de seguimiento compatible, agregar e integrar archivos de seguimiento adicionales, o abrir y combinar un grupo de archivos de seguimiento simultáneamente.

Para abrir un archivo de seguimiento
  1. Inicie el Visor de seguimiento del servicio mediante una ventana de comandos para ir a la ubicación de instalación de WCF (C:\Archivos de programa\Microsoft SDKs\Windows\v6.0\Bin) y, a continuación, escriba SvcTraceViewer.exe.

Nota:

La herramienta Service Trace Viewer puede asociarse a dos tipos de archivo: .svclog y .stvproj. Puede usar dos parámetros en la línea de comandos para registrar y anular el registro de las extensiones de archivo.

/register: registre la asociación de extensiones de archivo ".svclog" y ".stvproj" con SvcTraceViewer.exe

/unregister: eliminar del registro la asociación de las extensiones de archivo “.svclog” y “.stvproj” con SvcTraceViewer.exe

  1. Cuando se inicie Service Trace Viewer, haga clic en Archivo y, a continuación, apunte a Abrir. Vaya a la ubicación donde se almacenan los archivos de seguimiento.

  2. Haga doble clic en el archivo de seguimiento que desea abrir.

    Nota:

    Presione MAYÚS al hacer clic en varios archivos de seguimiento para seleccionarlos y abrirlos simultáneamente. Service Trace Viewer combina el contenido de todos los archivos y presenta una vista. Por ejemplo, puede abrir archivos de seguimiento de cliente y servicio. Esto resulta útil cuando se ha habilitado el registro de mensajes y la propagación de actividad en la configuración. De este modo, puede examinar el intercambio de mensajes entre el cliente y el servicio. También puede arrastrar varios archivos al visor o usar la pestaña Proyecto . Consulte la sección Managing Project (Administrar proyecto) para obtener más detalles.

  3. Para agregar archivos de seguimiento adicionales a la colección que está abierta, haga clic en Archivo y, a continuación, seleccione Agregar. En la ventana que se abre, vaya a la ubicación de los archivos de seguimiento y haga doble clic en el archivo que desea agregar.

Precaución

No se recomienda cargar un archivo de registro de seguimiento mayor que 200 MB. Si intenta cargar un archivo mayor que este límite, el proceso de carga puede tardar mucho tiempo, en función del recurso del equipo. Es posible que la herramienta Service Trace Viewer no responda durante mucho tiempo o que agote la memoria de la máquina. Se recomienda configurar la carga parcial para evitar esto. Para obtener más información sobre cómo hacerlo, vea la sección "Carga de archivos de seguimiento grandes".

Traza de eventos y traza carmesí

El formato original del visor es el formato de traza de la actividad que emite WCF. Las trazas emitidas en un formato diferente se deben convertir antes de que el visor las muestre. Actualmente, además del formato de traza de la actividad, el visor admite traza de eventos y traza carmesí.

Al abrir un archivo que no contiene seguimientos de actividad, el visor intenta convertir el archivo. Debe especificar el nombre y la ubicación del archivo que contendrán los datos de seguimiento convertidos. Una vez convertidos los datos, el visor muestra el contenido del nuevo archivo.

Nota:

La conversión requiere espacio en disco para almacenar los datos de seguimiento convertidos. Asegúrese de que tiene suficiente espacio en disco disponible para almacenar los datos antes de iniciar una conversión. De lo contrario, se produce un error en la conversión.

Administración de proyectos

El visor admite proyectos para facilitar la visualización de varios archivos de seguimiento. Por ejemplo, si tiene un archivo de seguimiento de cliente y un archivo de seguimiento de servicio, puede agregarlos a un proyecto. A continuación, cada vez que abra el proyecto, todos los archivos de seguimiento del proyecto se cargan simultáneamente.

Hay dos maneras de administrar proyectos:

  • En el menú Archivo , puede abrir, guardar y cerrar proyectos.

  • En la pestaña Proyecto , puede agregar archivos a un proyecto.

Ver seguimiento de WCF

WCF emite rastros utilizando el formato de rastreo de actividad. En el modelo de seguimiento de actividad, los seguimientos individuales se agrupan en actividades según su propósito. El flujo de control lógico se transfiere entre actividades. Por ejemplo, durante la vigencia de una aplicación, aparecen y desaparecen muchas "actividades de envío de mensajes". Para obtener más información sobre cómo ver seguimientos y actividades, y la interfaz de usuario del Visor de seguimiento de servicio también, consulte Uso del Visor de seguimientos de servicio para ver seguimientos correlacionados y solución de problemas.

Cambiar a vistas diferentes

El Visor de seguimiento de servicio proporciona las siguientes vistas diferentes. Se muestran como pestañas en el panel izquierdo del Visor y también se puede acceder desde el menú Ver .

  • Vista de actividad

  • Vista de proyecto

  • Vista de mensajes

  • Vista gráfica

Vista de actividad

Una vez abiertos los archivos de seguimiento, puede ver los seguimientos agrupados en actividades y mostrarlos en la vista Actividad del panel izquierdo.

La vista Actividad muestra los nombres de actividad, el número de seguimientos de la actividad, la hora de duración, la hora de inicio y la hora de finalización.

Al hacer clic en cualquiera de las actividades enumeradas, los seguimientos de esta actividad se muestran en el panel de seguimiento de la derecha. Puede seleccionar a continuación un seguimiento para ver sus detalles.

Puede seleccionar varias actividades presionando la tecla Ctrl o Mayús y haciendo clic en las actividades deseadas. El panel de rastreo muestra todos los rastros de las actividades seleccionadas.

Puede hacer doble clic en una actividad para mostrarla en la vista gráfico . La manera alternativa es seleccionar una actividad y cambiar a la vista de gráfico.

Nota:

La actividad "000000000000" es una actividad especial que no se puede mostrar en la vista de gráfico. Dado que todas las demás actividades están vinculadas a ella, mostrar esta actividad tiene un impacto grave en el rendimiento.

Puede hacer clic en el título de la columna para ordenar la lista de actividades. Las actividades que contienen trazas de advertencia tienen un fondo amarillo y las que contienen trazas de error tienen un fondo rojo.

Hay diferentes tipos de actividades y cada tipo corresponde a un icono en el lado izquierdo de cada actividad. Puede consultar la sección Descripción de los iconos de seguimiento para su significado.

Vista de proyecto

Esta vista le permite administrar archivos de seguimiento en el proyecto actual. Consulte la sección Managing Project (Administrar proyecto) para obtener más detalles.

Vista de mensajes

Esta vista le permite ver todos los seguimientos del registro de mensajes, incluidos Acción, Fecha/Hora, Proceso, Actividad y Desde/A, y navegar a los detalles del seguimiento del registro de mensajes asociado. Puede agrupar los seguimientos del registro de mensajes por límite de actividad, proceso/subproceso o envío y recepción para facilitar la navegación del flujo de mensajes.

Vista gráfica

Esta vista muestra los datos de seguimiento de una actividad determinada en el formulario de gráfico. El formulario de gráfico permite ver la ejecución paso a paso de eventos y las interrelaciones entre varias actividades a medida que se mueven los datos entre ellos.

Para cambiar a la vista Gráfico, seleccione una actividad en la vista Actividad y haga clic en la pestaña Actividad o en un seguimiento del registro de mensajes en la vista Mensaje. Si se cargan varios archivos de seguimiento y la actividad implica seguimientos de más de un archivo, todos los seguimientos pertinentes aparecen en la vista de gráfico. Al hacer doble clic en las actividades y seguimientos del registro de mensajes también podrá acceder a la vista de Gráfico.

En la vista Gráfico , cada columna vertical representa una actividad y cada bloque de la columna representa un seguimiento. Las actividades se agrupan por proceso (o subproceso). Las flechas pequeñas entre las actividades representan las transferencias. Las flechas grandes entre procesos representan el intercambio de mensajes. La actividad seleccionada siempre aparece en amarillo.

Seleccionar trazas en el gráfico
  1. Haga clic en un bloque en el gráfico.

  2. Utilice las teclas arriba y abajo para seleccionar los seguimientos adyacentes.

  3. Puede ver la información del seguimiento en el panel de seguimiento y en el panel detalle.

Expandir o contraer transferencias de la actividad

Puede expandir las transferencias de actividad cuando la actividad seleccionada se transfiere a otra actividad. Permite seguir las transferencias.

Para expandir o contraer transferencias de la actividad,

  1. Busque el registro de transferencia con un '+' a la izquierda del icono de transferencia.

  2. Haga clic en "+" o presione Ctrl y "+" con el teclado.

  3. La siguiente actividad aparece en el gráfico.

  4. Aparece "-" a la izquierda del icono de transferencia. Si hace clic en el signo “-” o presiona Ctrl y “-”, se contrae la transferencia de la actividad.

Nota:

Cuando una actividad tiene varias transferencias en ella y expande una de las transferencias, se muestran las actividades que conducen a la nueva actividad desde la actividad raíz. Estas nuevas actividades se muestran en formato contraído. Si desea ver los detalles de estas actividades, expándalos verticalmente haciendo clic en el icono de expansión del encabezado del gráfico.

Expandir o contraer verticalmente las actividades

El visor contrae las actividades para así ocultar detalles innecesarios en el gráfico de la actividad. En una actividad contraída no se muestran los seguimientos individuales. Sólo aparecen las transferencias de seguimiento. Si desea ver todos los seguimientos de una actividad, expanda la actividad verticalmente haciendo clic en el símbolo de expansión de la actividad en el encabezado del gráfico.

Para expandir o contraer verticalmente las actividades,

  1. Haga clic en el icono "+" del encabezado de actividad para expandir la actividad verticalmente.

  2. Observe que todas las trazas se muestran en el gráfico.

  3. Haga clic en el icono “-” en el encabezado de la actividad para contraer verticalmente la actividad.

  4. Tenga en cuenta que sólo se muestran en la actividad las transferencias importantes, registros de mensajes y seguimientos de advertencia y de excepción.

Opciones

Puede seleccionar dos opciones en el menú Opción de la vista Gráfico.

  • Mostrar seguimientos de límite de la actividad que, cuando se desactiva, omite los seguimientos del límite de la actividad en el gráfico.

  • Mostrar seguimientos detallados sin mensaje que, cuando se desactiva, omite todos los seguimientos de nivel detallados, excepto los seguimientos de mensajes. En la mayoría de los casos, los seguimientos de nivel detallados son menos importantes para el análisis. Esta opción es útil cuando no desea analizar los seguimientos de nivel detallados y sólo desea centrarse en seguimientos más importantes.

Modo de diseño

El visor tiene dos modos de diseño: proceso y subproceso. Esta configuración define la unidad de organización más grande. El modo de diseño predeterminado es Proceso, lo que significa que las actividades se agrupan por procesos en el gráfico.

Lista de ejecución

Puede seleccionar qué proceso o subproceso se mostrará en el gráfico de esta lista desplegable. Por ejemplo, si tiene abiertos los archivos de seguimiento de dos clientes (A y B) y un servicio, y solo desea mostrar el servicio y el cliente A en el gráfico, puede anular la selección del cliente B de la lista.

Visualización de detalles de seguimiento

Para ver un detalle de seguimiento, seleccione un seguimiento en el panel Seguimiento. Los detalles se muestran en el panel Detalles.

Panel de traza

El panel superior derecho en el visor de seguimiento de servicio es el panel de traza. Enumera todos los seguimientos de la actividad seleccionada con información adicional, por ejemplo, el nivel de seguimiento, el identificador de subproceso y el nombre del proceso.

Para copiar el XML bruto del rastro en el Portapapeles, haga clic con el botón derecho en un rastro y seleccione Copiar rastro en el Portapapeles.

Panel de detalles

El panel inferior izquierdo del Visor de seguimiento de servicio es el panel de detalles. Proporciona tres pestañas para ver los detalles del seguimiento.

La vista Formatted muestra la información de una manera más organizada. Enumera todos los elementos XML conocidos de tablas y árboles, lo que facilita la lectura y comprensión de la información.

La vista XML muestra XML correspondiente al seguimiento seleccionado. Admite el resaltado y el color de sintaxis. Cuando se usa Buscar para buscar cadenas, se resaltan los resultados de la búsqueda.

La vista de Mensaje muestra la parte del mensaje del XML en los seguimientos del registro de mensajes. No se puede ver si selecciona un seguimiento sin mensaje.

Filtrado de rastros de WCF

Para facilitar el análisis del seguimiento, puede filtrarlos de las siguientes maneras:

  • La barra de herramientas de filtro proporciona acceso a filtros predefinidos y personalizados. Se puede habilitar a través del menú Ver .

  • El filtro predefinido del visor puede usarse para filtrar de forma selectiva partes de las trazas de WCF. De forma predeterminada, está configurado para permitir el paso de todas las trazas de infraestructura. La configuración de este filtro se define en el submenú Opciones de filtro en el menú Ver .

  • Los filtros XPath personalizados proporcionan a los usuarios control total sobre el filtrado. Se pueden definir en el menú Filtro personalizado en Ver .

Sólo se muestran los seguimientos que atraviesan todos los filtros.

Uso de la barra de herramientas de filtro

La barra de herramientas de filtro aparece en la parte superior de la herramienta. Si no está presente, puede activarlo en el menú Ver . La barra tiene tres componentes:

  • Buscar: Buscar define el tema u objeto que se ha de buscar en la operación de filtro. Por ejemplo, si desea encontrar todos los rastros emitidos en el contexto del proceso X, establezca este campo en X y el campo Buscar en en "Nombre del proceso". Este campo cambia a un control selector DateTime cuando se selecciona un filtro basado en tiempo.

  • Buscar en: este campo define el tipo de filtro que se va a aplicar.

  • Nivel: la configuración de nivel define el nivel de seguimiento mínimo permitido por el filtro. Por ejemplo, si se fija el nivel en “Error y arriba”, sólo se muestran los seguimientos en el nivel error y crítico. Este filtro se combina con los criterios especificados por Look For y Search In.

El botón Filtrar ahora inicia la operación de filtro. Algunos filtros, especialmente cuando se aplican a un conjunto de datos de gran tamaño, tardan mucho tiempo en completarse. Puede cancelar la operación de filtro presionando el botón Detener que aparece en la barra de estado en el menú Operaciones .

El botón Borrar restablece filtros predefinidos y personalizados para permitir que todos los seguimientos pasen.

Opciones de filtro

El visor puede quitar de la vista automáticamente los seguimientos de WCF. Puede quitar selectivamente seguimientos emitidos por áreas concretas de WCF, por ejemplo, mediante la eliminación de la vista de seguimientos relacionados con la transacción.

La configuración de este filtro se define en el submenú Opciones de filtro en el menú Ver .

Filtros personalizados

Si está familiarizado con el lenguaje de ruta de acceso XML (XPath), puede usarlo para construir filtros personalizados para buscar los datos de seguimiento de cualquier elemento XML de interés. Los filtros son accesibles a través de la barra de herramientas de filtro.

Los filtros personalizados pueden incluir parámetros. También puede importar filtros personalizados preexistentes.

Creación de un filtro personalizado

Los filtros se pueden crear de dos maneras:

Creación de un filtro personalizado mediante el Asistente para plantillas

Puede hacer clic en un seguimiento existente y crear un filtro basado en la estructura del seguimiento. En este ejemplo se crea un filtro personalizado basado en el identificador de subproceso.

  1. En el panel de seguimiento del área superior derecha del visor, seleccione un seguimiento que incluya el elemento para el que desea filtrar.

  2. Haga clic en el botón Crear filtro personalizado ubicado en la parte superior del panel de seguimiento.

  3. En el cuadro de diálogo que aparece, escriba un nombre para el filtro. En este ejemplo, escriba Thread ID. También puede proporcionar una descripción del filtro.

  4. La vista de árbol de la izquierda muestra la estructura del registro de seguimiento seleccionado en el paso 1. Vaya al elemento para el que desea crear una condición. En este ejemplo, navegue hasta el Identificador de hilo que se encuentra en el nodo XPath: /E2ETraceEvent/System/Execution/@ThreadID. Haga doble clic en el atributo ThreadID en la vista de árbol. Esto crea una expresión para el atributo a la derecha del cuadro de diálogo.

  5. Cambie el campo de parámetro de la condición ThreadID de None a '{0}'. Este paso permite configurar el valor de ThreadID cuando se aplica el filtro. (Consulte la sección Cómo aplicar un filtro). Puede definir hasta cuatro parámetros. Las condiciones se combinan mediante el operador OR.

  6. Haga clic en Aceptar para crear el filtro.

Nota:

Una vez creado un filtro mediante el asistente para plantillas, solo se puede editar manualmente. No es posible activar el Asistente para un filtro que se ha creado previamente. Además, las condiciones de un filtro XPath creado en el asistente para plantillas se combinan mediante el operador OR. Si necesita una operación AND, puede editar la expresión de filtro una vez creada.

Crear manualmente un filtro personalizado

El menú Filtros personalizados permite escribir filtros XPath manualmente.

  1. En el menú Ver, haga clic en el elemento de menú Filtros personalizados .

  2. En el cuadro de diálogo que aparece, haga clic en Nuevo.

  3. Como mínimo, especifique un nombre de filtro y una expresión XPath.

  4. Haz clic en Aceptar.

Aplicación de un filtro personalizado

Una vez creado un filtro personalizado, es accesible a través de la barra de herramientas de filtro. Seleccione el filtro que desea aplicar en el campo Buscar en de la barra de herramientas de filtro. En el ejemplo anterior, seleccione "ID de hilo".

  1. Especifique el valor que busca en el campo Buscar qué. En nuestro ejemplo, ingrese el ID del hilo que desea buscar.

  2. Haga clic en Filtrar ahora y observe el resultado de la operación.

Si el filtro usa varios parámetros, escríbalos con ';' como separador en el campo Buscar . Por ejemplo, la cadena siguiente define 3 parámetros: '1; findValue; text'. El visor aplica '1' al {0} parámetro del filtro. 'findValue' y 'text' se aplican a {1} y {2} respectivamente.

Uso compartido de filtros personalizados

Los filtros personalizados se pueden compartir entre diferentes sesiones y usuarios diferentes. Puede exportar los filtros a un archivo de definición e importar este archivo en otra ubicación.

Para importar un filtro personalizado:

  1. En el menú Ver , haga clic en Filtros personalizados.

  2. En el cuadro de diálogo que se abre, haga clic en el botón Importar .

  3. Vaya al archivo de filtro personalizado (.stvcf), haga clic en el archivo y haga clic en el botón Abrir .

Para exportar un filtro personalizado:

  1. En el menú Ver, haga clic en Filtros personalizados.

  2. En el cuadro de diálogo que se abre, seleccione el filtro que desea exportar.

  3. Haga clic en el botón Exportar .

  4. Especifique el nombre y la ubicación del archivo de definición de filtro personalizado (.stvcf) y haga clic en el botón Guardar .

Nota:

Estos filtros personalizados solo se pueden importar y exportar desde service Trace Viewer. No pueden ser leídos por otras herramientas.

Buscar datos

El visor proporciona las siguientes maneras de buscar datos:

  • La barra de herramientas Buscar proporciona un acceso rápido a las opciones de búsqueda más comunes.

  • El cuadro de diálogo Buscar proporciona más opciones de búsqueda. Es accesible a través del menú Editar , o bien mediante la tecla Ctrl + F.

La barra de herramientas de búsqueda aparece en la parte superior del visor. Si no está presente, puede activarlo en el menú Ver . La barra tiene dos componentes:

  • Buscar qué: permite escribir la palabra clave de búsqueda.

  • Buscar en: le permite introducir un área de búsqueda. Puede seleccionar si desea buscar en todas las actividades o solo en la actividad actual.

El cuadro de diálogo buscar proporciona dos opciones adicionales:

  • Buscar destino:

    • La opción "Datos de registro sin procesar" busca la palabra clave en todos los datos sin procesar.

    • Las opciones "Texto XML" y "Atributo XML" solo buscan en elementos XML.

    • La opción "Mensaje registrado" busca la palabra clave solo en los mensajes.

  • Ignorar la actividad raíz: la búsqueda ignora las trazas en la actividad “000000000000”. Esto mejora el rendimiento en archivos de seguimiento grandes cuando la actividad raíz tiene miles de seguimientos, la mayoría de las cuales son transferencias.

Dado que los seguimientos se graban paso a paso durante el tiempo de ejecución de la aplicación, navegar por los seguimientos puede ayudarle a depurar su aplicación. El visor de seguimiento de servicio proporciona varias maneras de navegar por los seguimientos.

Avanzar o retroceder

Si considera cada seguimiento como una línea de código en el programa, ir hacia delante es muy similar al “paso a paso por procedimientos” en el entorno de desarrollo integrado de Visual Studio (IDE). La diferencia radica en que también puede ir hacia atrás en los seguimientos. Avanzar significa pasar al siguiente paso en la actividad.

  • Avanzar paso a paso: use el menú Actividad o presione "F10". También puede usar la tecla de flecha "abajo" en el panel de seguimiento.

  • Retroceder: use el menú Actividad o presione "F9". También puede usar la tecla de flecha "arriba" en el panel de seguimiento.

Nota:

Esto puede llevarte a una actividad que se produce en un proceso diferente o incluso en un equipo diferente, ya que los mensajes WCF pueden llevar identificadores de actividad que abarcan máquinas.

Seguimiento de transferencia

Los rastros de transferencia son rastros especiales en el archivo de rastros. Una actividad puede transferirse a otra actividad mediante un rastro de transferencia. Por ejemplo, "Actividad A" puede transferirse a "Actividad B". En este caso, hay una traza de transferencia en la “Actividad A” con el nombre “A: actividad” y el icono de transferencia. Esta traza de transferencia es un enlace entre las dos trazas. En la “actividad B”, podría haber también un seguimiento de la transferencia al final de la actividad para transferir de vuelta a la “actividad A”. Esto es similar a las llamadas de función en programas: A llama a B, y luego B devuelve.

“Seguir transferencia” es similar a la opción “Ir a” en un depurador. Sigue la transferencia de A a B. No tiene ningún efecto en otras trazas.

Hay dos maneras de seguir una transferencia: por mouse o por teclado:

  • Con el mouse: haga doble clic en el seguimiento de transferencia del panel de traza.

  • Por teclado: seleccione un seguimiento de transferencia y use "Seguir transferencia" en el menú Actividad , o presione "F11"

Nota:

En muchos casos, cuando la actividad A se transfiere a la actividad B, la actividad A espera hasta que la actividad B vuelva a la actividad A. Esto significa que la actividad A no tiene ningún seguimiento registrado durante el período en el que la actividad B está trazando activamente. Sin embargo, también es posible que la actividad A no espere y continúe registrando trazas. También es posible que la actividad B no vuelva a transferirse a la actividad A. Por lo tanto, las transferencias de actividad siguen siendo diferentes de las llamadas de función en este sentido. Puede comprender mejor las transferencias de actividad en la vista de gráfico.

Ir a la transferencia siguiente o anterior

Al analizar la actividad actual o las actividades seleccionadas cuando se seleccionan varias actividades, es posible que desee encontrar rápidamente las actividades a las que transfiere. "Saltar a la siguiente transferencia" le permite localizar el próximo rastro de transferencia en la actividad. Una vez que encuentre el rastro de transferencia, puede usar "Seguir transferencia" para pasar a la siguiente actividad.

  • Ir a Siguiente transferencia: use el menú Actividad o presione "Ctrl + F10".

  • Ir a Transferencia anterior: use el menú Actividad o presione "Ctrl + F9".

Aunque navegar por el panel de actividad y el panel de traza sea similar a depurar, usar la vista del Gráfico proporciona una experiencia de navegación mucho mejor. Consulte la sección "Vista de grafos" para obtener más información.

Carga de archivos de seguimiento grandes

Los archivos de seguimiento pueden ser muy grandes. Por ejemplo, si activa el seguimiento en el nivel "Detallado", el archivo de seguimiento resultante durante unos minutos puede fácilmente alcanzar cientos de megabytes o incluso ser aún mayor, dependiendo de la velocidad de la red y el patrón de comunicación.

Al abrir un archivo de seguimiento muy grande en el Visor de seguimiento de servicio, el rendimiento del sistema puede verse afectado negativamente. La velocidad de carga y el tiempo de respuesta después de la carga pueden ser lentos. La velocidad real difiere de vez en cuando, en función de la configuración del hardware. En la mayoría de los equipos, cargar un archivo de seguimiento mayor que 200M tiene un impacto grave en el rendimiento. En el caso de los archivos de seguimiento mayores que 1G, la herramienta puede usar toda la memoria disponible o dejar de responder durante mucho tiempo.

Para evitar la carga lenta y el tiempo de respuesta en el análisis de archivos de seguimiento grandes, el Visor de seguimiento de servicio proporciona una característica denominada "Carga parcial", que solo carga una pequeña parte del seguimiento a la vez. Por ejemplo, puede tener un archivo de seguimiento de más de 1 GB, ejecutándose durante varios días en el servidor. Cuando se han producido algunos errores y desea analizar el seguimiento, no es necesario abrir todo el archivo de seguimiento. En su lugar, puede cargar los seguimientos pertenecientes al período de tiempo en el que se puede haber producido el error. Dado que el ámbito es más pequeño, la herramienta Visor de seguimiento de servicio puede cargar el archivo más rápido y puede identificar los errores mediante un conjunto más pequeño de datos.

Habilitar la carga parcial

No es necesario habilitar manualmente la carga parcial. Si el tamaño total de los archivos de seguimiento que intenta cargar supera los 40 MB, el Visor de seguimiento de servicio muestra automáticamente un cuadro de diálogo Carga parcial para seleccionar el elemento que desea cargar.

Nota:

Dado que los rastros pueden no distribuirse uniformemente en el intervalo de tiempo, el período de tiempo que especifiques en la barra de herramientas de Carga parcial puede no ser proporcional al tamaño de carga mostrado. El tamaño de carga real puede ser menor que el tamaño estimado en el cuadro de diálogo de carga parcial.

Ajustar la carga parcial

Después de cargar parcialmente el archivo de seguimiento, es posible que desee cambiar el conjunto de datos que se va a cargar. Puede hacerlo ajustando la barra de herramientas de Carga parcial ubicada en la parte superior del visor.

  1. Mueva la barra de herramientas por mouse o escriba la hora de inicio y finalización.

  2. Haga clic en el botón Ajustar .

Descripción de los iconos de seguimiento

A continuación se muestra una lista de iconos que usa la herramienta Visor de seguimiento de servicio en la vista Actividad , la vista Gráfico y el panel Seguimiento para representar distintos elementos.

Nota:

Algunos rastros que no están clasificados (por ejemplo, "se ha cerrado un mensaje") no tienen algún icono.

Seguimiento de la actividad

Icono Descripción
Traza de advertencia Traza de advertencia: traza que se emite en el nivel de advertencia
Seguimiento de errores Seguimiento de error: un seguimiento que se emite en el nivel de error.
Seguimiento de inicio de actividad: Seguimiento de inicio de actividad: un seguimiento que marca el principio de una actividad. Contiene el nombre de la actividad. Como diseñador o programador de aplicaciones, debería definir un seguimiento de inicio de actividad por id. de actividad, por proceso o subproceso.

Si el id. de actividad se propaga por los orígenes de traza para la correlación de seguimiento, puede ver varios inicios para el mismo id. de actividad (uno por origen de traza). Se emite la traza de inicio si ActivityTracing está habilitado para la fuente de traza.
Seguimiento de detención de actividad parada de actividad Rastro de finalización de actividad: un rastro que marca el final de una actividad. . Contiene el nombre de la actividad. Como diseñador o programador de aplicaciones, debe definir una traza de detención por identificador de actividad por origen de traza. Ningún seguimiento de un origen de traza determinado aparece después del fin de actividad emitido por ese origen de traza, excepto si la granularidad de tiempo del seguimiento no es lo bastante pequeña. Cuando eso pasa, se pueden intercalar dos seguimientos con la misma hora, incluyendo uno de fin, al mostrarlos. Si el id. de actividad se propaga por los orígenes de traza para la correlación de seguimiento, puede ver varios finales para el mismo id. de actividad (uno por origen de traza). Se emite la traza de detención si ActivityTracing está habilitado para el origen de traza.
Seguimiento de suspensión de actividad Seguimiento de suspensión de actividad: un seguimiento que marca la hora en que se pausa una actividad. No se emite ningún rastro en una actividad suspendida hasta que se reanuda la actividad. Una actividad suspendida indica que no se está produciendo ningún procesamiento en esa actividad en el ámbito del origen de seguimiento. Los seguimientos de suspensión/reanudación son útiles para perfilar. Se emite el seguimiento de suspensión si ActivityTracing está habilitado para el origen de traza.
Seguimiento de reanudación de actividad Seguimiento de reanudación de actividad: un seguimiento que marca la hora en que se reanuda una actividad después de haber sido suspendida. Se pueden volver a emitir seguimientos en esa actividad. Los seguimientos de suspensión/reanudación son útiles para perfilar. Se emite el seguimiento de reanudación si ActivityTracing está habilitado para el origen de traza.
Transferencia Transferencia: un registro que se emite cuando el flujo de control lógico se transfiere de una actividad a otra. La actividad de la que se origina la transferencia puede seguir realizando sus tareas en paralelo a la actividad a la que se dirige la transferencia. El rastro de transferencia se emite si ActivityTracing está habilitado para la fuente de rastreo.
Transferencia desde Transferir de: un seguimiento que define una transferencia desde otra actividad a la actividad actual.
Transferir a Transferir a: un seguimiento que define una transferencia de flujo de control lógico desde la actividad actual a otra actividad.

Seguimiento WCF

Icono Descripción
Seguimiento de registro de mensajes de mensajes Seguimiento de registro de mensajes: un seguimiento que se emite cuando la característica de registro de mensajes registra un mensaje de WCF cuando el origen de traza de System.ServiceModel.MessageLogging está habilitado. Al hacer clic en esta traza se muestra el mensaje. Hay cuatro puntos de registro configurables para un mensaje: ServiceLevelSendRequest, TransportSend, TransportReceive y ServiceLevelReceiveRequest, los cuales también pueden ser especificados por el atributo messageSource en el seguimiento del registro de mensajes.
Rastro de mensaje recibido Seguimiento de mensaje recibido: un seguimiento que se emite cuando se recibe un mensaje de WCF, si el origen de traza System.ServiceModel está habilitado en los niveles de Información o Detallado. Este seguimiento es esencial para ver la flecha de correlación de mensaje en la vista de Gráfico de actividad.
Seguimiento de mensajes enviados Seguimiento de mensaje enviado: un seguimiento que se emite cuando se envía un mensaje de WCF, si el origen de traza System.ServiceModel está habilitado en los niveles de Información o Detallado. Este seguimiento es esencial para ver la flecha de correlación de mensaje en la vista de Gráfico de actividad.

Actividades

Icono Descripción
Actividad Actividad: indica que la actividad actual es una actividad genérica.
Actividad raíz Actividad raíz: indica la actividad raíz de un proceso.

Actividades de WCF

Icono Descripción
Actividad del entorno Actividad de entorno: una actividad que crea, abre o cierra un host o un cliente wcF. Los errores que se han producido durante estas fases aparecerán en esta actividad.
Actividad de escucha Actividad de escucha: una actividad que registra trazas relacionadas con un oyente. En esta actividad, podemos ver la información del oyente y las solicitudes de conexión.
Actividad de recepción de bytes Actividad de recepción de bytes: agrupa todos los seguimientos relacionados con la recepción de bytes de entrada en una conexión entre dos puntos de conexión. Esta actividad es esencial para correlacionar con actividades de transporte que propagan su identificador de actividad, como http.sys. En esta actividad aparecerán errores de conexión tales como interrupciones.
Actividad de procesamiento de mensajes Actividad de procesamiento de mensajes: actividad que agrupa trazas relacionadas con la creación de un mensaje WCF. Los errores debidos a un sobre incorrecto o a un mensaje con formato incorrecto aparecerán en esa actividad. Dentro de esta actividad, podemos inspeccionar los encabezados de mensaje para ver si se ha propagado un identificador de actividad desde el autor de la llamada. Si esto es verdad, cuando transferimos a la actividad de procesamiento de acción (el icono siguiente), también podemos asignar a esa actividad el id. de actividad propagado para la correlación entre el autor de la llamada y los seguimientos del destinatario.
Seguimiento de registro de mensajes de mensajes Actividad de procesamiento de acción: actividad que agrupa todas las trazas relacionadas con una solicitud de WCF a través de dos puntos de conexión. Si propagateActivity está establecido en true en los dos extremos de la configuración, se combinan todos los seguimientos de ambos extremos en una actividad para la correlación directa. Dicha actividad contendrá errores debidos al procesamiento de transporte o seguridad, extendiéndose hasta el límite del código de usuario y de regreso, si existe una respuesta.
Actividad de procesamiento de mensajes Actividad de ejecución de código de usuario: una actividad que agrupa seguimientos de código de usuario para procesar una solicitud.

Solución de problemas

Si no tiene permiso para escribir en el registro, recibirá el siguiente mensaje de error "Microsoft Service Trace Viewer no se registró en el sistema" al usar el comando "svctraceviewer /register" para registrar la herramienta. Si esto ocurre, debe iniciar sesión con una cuenta que tenga acceso de escritura al Registro.

Además, la herramienta Visor de Seguimiento de Servicios escribe algunas opciones de configuración (por ejemplo, filtros personalizados y opciones de filtro) en el archivo .settings de SvcTraceViewer.exeen su carpeta de ensamblaje. Si no tiene permiso de lectura para el archivo, puede iniciar la herramienta, pero no puede cargar la configuración.

Si recibe el mensaje de error "Error desconocido al procesar uno o más rastros" al abrir el archivo .etl, significa que el formato del archivo .etl no es válido.

Si abre un registro de seguimiento creado con un sistema operativo árabe, puede observar que el filtro de tiempo no funciona. Por ejemplo, el año 2005 corresponde al año 1427 en el calendario árabe. Sin embargo, el intervalo de tiempo admitido por la herramienta Visor de Seguimiento de Servicio no admite una fecha anterior a 1752. Esto puede implicar que no puede seleccionar una fecha correcta en el filtro. Para resolver este problema, puede crear un filtro personalizado (Ver o filtros personalizados) mediante una expresión XPath para incluir un intervalo de tiempo específico.

Consulte también