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

La herramienta del visor de seguimiento de servicio Windows Communication Foundation (WCF) le ayuda a analizar seguimientos del diagnóstico generados por WCF. El visor de seguimiento de servicio proporciona una manera fácil de combinar, ver y filtrar los mensajes del registro para que así pueda diagnosticar, reparar y comprobar los problemas del servicio WCF.

Configurar seguimiento

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 su propio nombre indica, también puede seguir las operaciones desde el origen hasta el destino y en los puntos intermedios.

Puede configurar el seguimiento utilizando el archivo de configuración de la aplicación, o bien Web.config para las aplicaciones hospedadas en Web o bien Appname.config para las aplicaciones hospedadas en sí mismas. 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>

Los seguimientos WCF se escriben en el origen denominado System.ServiceModel

El valor switchValue controla el nivel de seguimiento. En la siguiente tabla se describen los niveles de seguimiento disponibles.

Nivel de seguimiento Descripción

Crítico

  • Registra entradas de Fail-Fast y del Registro de eventos y la información de correlación del seguimiento. A continuación se muestran algunos ejemplos de cuándo se puede utilizar el nivel Crítico:
  • Su AppDomain ha fallado debido a una excepción no controlada.
  • Su aplicación no se inicia.
  • El mensaje que produjo el error se origina en el proceso MyApp.exe.

Error

  • Registra todas las excepciones. Puede utilizar 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 del tipo “no se ha podido crear el extremo” está haciendo que su aplicación no pueda iniciarse.

Advertencia

  • Existe una condición que puede producir como consecuencia un error o un error crítico. Puede utilizar este nivel en las situaciones siguientes:
  • La aplicación está recibiendo más solicitudes que las que permiten sus valores de limitación de peticiones.
  • La cola receptora está al 98 por ciento de su capacidad configurada.

Información

  • Se han generado mensajes útiles para supervisar y diagnosticar el estado del sistema, medir el rendimiento o perfilar. Puede utilizar esa información para el diseño de la capacidad y la gestión del rendimiento. Puede utilizar este nivel en las situaciones siguientes:
  • Se ha producido un error después de que el mensaje llegase al AppDomain y se deserializase.
  • Se ha producido un error mientras se creaba el enlace HTTP.

Detalles

  • Seguimiento del nivel de depuración para el código de usuario y para el servicio. Establezca este nivel cuando:
  • No esté seguro de qué método de su código se llamó cuando se produjo el error.
  • Tiene configurado un extremo incorrecto y el servicio no se ha podido iniciar porque la entrada en el almacén de la reserva está bloqueada.

ActivityTracing

Transmitir eventos entre actividades de procesamiento y componentes.

Este nivel permite a los administradores y programadores poner en correlación las aplicaciones en el mismo dominio de aplicación.

  • Seguimiento de los límites de actividad: iniciar/detener.
  • Seguimiento de las transferencias.

Puede utilizar add para especificar el nombre y tipo de agente de escucha de seguimiento que desea utilizar. En nuestra configuración del ejemplo, hemos denominado "sdt" al agente de escucha y hemos agregado el agente de escucha de seguimiento de .NET Framework estándar (System.Diagnostics.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 un nombre de archivo simple por una ruta de acceso completa.

Utilizar la herramienta de visor de seguimiento de servicio

Abrir y ver los archivos de seguimiento de WCF

El visor de seguimiento de servicio admite tres tipos de archivo:

  • Archivo de seguimiento WCF (.svcLog)
  • Archivo de seguimiento de eventos (.etl)
  • Archivo de seguimiento carmesí

El visor de seguimiento de servicio le permite abrir cualquier archivo de seguimiento compatible, agregar e integrar archivos de seguimiento adicionales o abrir y combinar simultáneamente un grupo de archivos de seguimiento.

Para abrir un archivo de seguimiento

  1. Inicie el visor de seguimiento de servicio utilizando una ventana de comandos para navegar a su ubicación de instalación WCF (\Bin de C:\Program Files\Microsoft SDKs\Windows\v6 .0) y, a continuación, escriba SvcTraceViewer.exe.

Nota

La herramienta del visor de seguimiento de servicio puede asociar dos tipos de archivo: .svclog y .stvproj. Puede utilizar dos parámetros en línea de comandos para registrar y eliminar del registro las extensiones de archivo.

/register: registrar la asociación de las 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 el visor de seguimiento de servicio, haga clic en Archivo y, a continuación, señale Abrir. Navegue hasta la ubicación donde se almacenan sus archivos de seguimiento.
  2. Haga doble clic en el archivo de seguimiento que desea abrir.

Nota

Presione MAYÚS mientras hace clic en varios archivos de seguimiento para seleccionarlos y abrirlos de forma simultánea. El visor de seguimiento de servicio combina el contenido de todos los archivos y los muestra en una vista. Por ejemplo, puede abrir archivos de seguimiento tanto de cliente como de servicio. Esto es útil cuando ha habilitado en la configuración el registro de mensajes y la propagación de la actividad. De esta manera, puede examinar el intercambio de mensajes entre cliente y servicio. También puede arrastrar varios archivos al visor o utilizar la pestaña Proyecto. Para obtener información más detallada, consulte la sección Administrar proyecto.

  1. Para agregar archivos de seguimiento adicionales a la colección que está abierta, haga clic en Archivo y, a continuación, señale Agregar. En la ventana que se abre, navegue a la ubicación de los archivos de seguimiento y haga doble clic en el archivo que desea agregar.
ms732023.Caution(es-es,VS.90).gifPrecaución:
No se recomienda cargar un archivo de seguimiento mayor de 200 MB. Si intenta cargar un archivo mayor que ese límite, el proceso de carga puede tardar mucho tiempo, dependiendo de su recurso informático. Puede que la herramienta del visor de seguimiento de servicio no responda durante mucho tiempo o que agote la memoria de su equipo. Se recomienda que configure carga parcial para evitarlo. Para obtener más información sobre cómo hacerlo, vea la sección “Cargar archivos de seguimiento grandes”.

Seguimiento de eventos y seguimiento carmesí

El formato original del visor es el formato de seguimiento de actividad que emite WCF. Los seguimientos emitidos en un formato diferente se deben convertir antes de que el visor los muestre. Actualmente, además del formato de seguimiento de actividad, el visor admite seguimiento de eventos y seguimiento 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á 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 la información de seguimiento convertida. Antes de iniciar una conversión, asegúrese de tener suficiente espacio en disco para almacenar los datos. De lo contrario, se produce un error en la conversión.

Administrar proyectos

El visor admite proyectos para facilitar la vista 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. Así, cada vez que abra el proyecto, se cargan todos los archivos de seguimiento en el proyecto de manera simultánea.

Hay dos maneras de administrar los 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 seguimientos utilizando el formato de seguimiento de actividad. En el modelo de seguimiento de actividad, los seguimientos individuales están agrupados en actividades según su propósito. El flujo de control lógico se transfiere entre las actividades. Por ejemplo, durante el tiempo que dura una aplicación, aparecen y desaparecen muchas "actividades de envío de mensaje". Para obtener más información sobre cómo ver seguimientos y actividades, y también la interfaz de usuario del visor de seguimiento de servicio, vea Using Service Trace Viewer for Viewing Correlated Traces and Troubleshooting.

Alternar vistas diferentes

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

  • Vista de actividad
  • Vista de proyecto
  • Vista de mensaje
  • Vista de gráficos

Vista de actividad

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

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

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

Puede seleccionar varias actividades presionando las teclas Ctrl o Mayús y haciendo clic en las actividades deseadas. El panel de seguimiento muestra todos los seguimientos de las actividades seleccionadas.

Puede hacer doble clic en una actividad para mostrarla en la vista de 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 las otras actividades se vinculan a ella, mostrar esta actividad tiene un impacto importante en el rendimiento.

Puede hacer clic en el título de la columna para ordenar la lista de actividades. Las actividades que contienen seguimientos de advertencia tienen un fondo amarillo y aquéllas que contienen seguimientos 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 Introducción a los iconos de seguimiento para conocer su significado.

Vista de proyecto

Esta vista le permite administrar los archivos de seguimiento en el proyecto actual. Para obtener información más detallada, consulte la sección Administrar proyecto.

Vista de gráficos

Una de las características más eficaces del visor de seguimiento de servicio es la vista de Gráfico, que muestra la información de seguimiento para una actividad determinada en gráficos. Esta opción de gráficos le permite ver la ejecución paso a paso de eventos y las relaciones mutuas entre varias actividades cuando los datos se mueven entre ellas.

Para cambiar a la vista de Gráfico, seleccione una actividad en la vista de Actividad y haga clic en la pestaña Actividad o seleccione 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 de 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 los procesos representan el intercambio de mensajes. La actividad seleccionada siempre aparece en amarillo.

Seleccionar seguimientos en el gráfico

  1. Haga clic en un bloque del 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 la actividad cuando la actividad seleccionada transfiere a otra actividad. Le permite seguir las transferencias.

Para expandir o contraer transferencias de la actividad,

  1. Busque el seguimiento de la transferencia con un signo "+" a la izquierda del icono de transferencia.
  2. Haga clic en "+" o presione Ctrl y "+" en el teclado.
  3. La actividad siguiente 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 cancela la transferencia de la actividad.

Nota

Cuando una actividad tiene varias transferencias y expande una de ellas, se muestran las actividades que llevan a la nueva actividad desde la actividad de raíz. Estas nuevas actividades se muestran en formato contraído. Si desea ver los detalles de estas actividades, expándalas verticalmente haciendo clic en el icono de expandir, en el 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 en una actividad, expanda verticalmente la actividad haciendo clic en el icono de expandir de la actividad situado en el encabezado del gráfico.

Para expandir o contraer verticalmente las actividades,

  1. Haga clic en el icono “+” en el encabezado de la actividad para expandir verticalmente la actividad.
  2. Tenga en cuenta que todos los seguimientos 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 en la vista de 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 más grande de organización. El modo de diseño predeterminado es el de Proceso, es decir, las actividades están agrupadas por procesos en el gráfico.

Lista de ejecución

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

Ver detalles del seguimiento

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

Panel de seguimiento

El panel derecho superior en el visor de seguimiento de servicio es el panel de seguimiento. Contiene una lista de todos los seguimientos en la actividad seleccionada con información adicional, como nivel de seguimiento, id. de subproceso y nombre del proceso.

Puede copiar el XML sin formato del seguimiento al Portapapeles haciendo clic con el botón secundario en un seguimiento y seleccionando Copiar seguimiento a Portapapeles.

Panel detalle

El panel inferior izquierdo en el visor de seguimiento de servicio es el panel detalle. Tiene tres pestañas para ver los detalles de seguimiento.

La vista Con formato muestra la información de una manera más organizada. Contiene una lista de todos los elementos XML conocidos en tablas y árboles, por lo que será más fácil leer y entender la información.

La vista XML muestra XML que corresponden al seguimiento seleccionado. Permite resaltar y colorear la sintaxis. Al utilizar Buscar para buscar en cadenas, resalta 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.

Filtrar los seguimientos de WCF

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

  • La barra de herramientas de filtro proporciona el acceso a los filtros predefinidos y personalizados. Se puede habilitar en el menú Ver.
  • El filtro predefinido del visor se puede utilizar para filtrar selectivamente partes de los seguimientos de WCF. Se establece de forma predeterminada que todos los seguimientos de infraestructura puedan pasar. La configuración de este filtro se define en el submenú Opciones de filtro, en el menú Ver.
  • Los filtros del XPath personalizados les dan a los usuarios el control completo sobre cómo filtrar. Se pueden definir en Filtro personalizado, en el menú Ver.

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

Utilizar la barra de herramientas del filtro

La barra de herramientas del filtro aparece en la parte superior de la herramienta. Si no aparece, puede activarla 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 buscar todos los seguimientos que se emitieron durante el proceso X, escriba en este campo X y en el campo Buscar en el “nombre del proceso”. Este campo cambia a un control de seleccionador DateTime cuando se selecciona un filtro basado en tiempo.
  • Buscar en: este campo define el tipo de filtro que se va a aplicar.
  • Nivel: el valor 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 en Buscar y Buscar en.

El botón Filtrar ahora inicia la operación del filtro. Algunos filtros, sobre todo cuando se aplican a un conjunto de datos grande, tardan un buen rato en terminar. Puede cancelar la operación de filtrado presionando el botón Detener que aparece en la barra de estado en el menú Operaciones.

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

Opciones de filtro:

El visor puede quitar de la vista automáticamente los seguimientos 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 XML Path Language (XPath), puede utilizarlo y así construir filtros personalizados para buscar en los datos de seguimiento cualquier elemento XML que le interese. Se puede acceder a los filtros a través de la barra de herramientas de filtro.

Los filtros personalizados pueden incluir parámetros. También puede importar filtros personalizados que ya existan.

Crear un filtro personalizado

Los filtros se pueden crear de dos maneras:

Crear 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 un id. de subproceso.

  1. En el panel de seguimiento, en la parte superior derecha del visor, seleccione un seguimiento que incluya el elemento que desea filtrar.
  2. Haga clic en el botón Crear filtro personalizado situado en la parte superior del panel de seguimiento.
  3. En el cuadro de diálogo que aparece, escriba un nombre para su filtro. En este ejemplo, escriba ThreadID. También puede proporcionar una descripción de su filtro.
  4. La vista de árbol a la izquierda muestra la estructura del registro de seguimiento que seleccionó en el paso 1. Vaya al elemento para el que desea crear una condición. En este ejemplo, vaya a ThreadID, 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 diálogo.
  5. Cambie el campo de parámetro para la condición ThreadID de Ninguno a “{0}”. Este paso permite configurar el valor 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 O.
  6. Haga clic en Aceptar para crear el filtro.

Nota: una vez que se haya creado un filtro mediante el Asistente para plantillas, sólo 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 de XPath creado mediante el Asistente para plantillas se combinan con el operador O. Si necesita una operador Y, puede modificar la expresión del filtro una vez haya sido creado.

Crear manualmente un filtro personalizado

El menú Filtros personalizados le permite escribir manualmente los filtros de XPath.

  1. En el menú Ver, haga clic en el elemento de menú Filtros personalizados.
  2. En el diálogo que aparece, haga clic en Nuevo.
  3. Como mínimo especifique un nombre de filtro y una expresión XPath.
  4. Haga clic en Aceptar.

Aplicar un filtro personalizado

Una vez creado un filtro personalizado, puede acceder a él 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. Para el ejemplo anterior, seleccione “ThreadID”.

  1. Especifique el valor que está buscando en el campo Buscar. En este ejemplo, escriba el id. del subproceso que desea buscar.
  2. Haga clic en Filtrar ahora y observe el resultado de la operación.

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

Compartir filtros personalizados

Los filtros personalizados se pueden compartir entre sesiones diferentes 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 aparece, haga clic en el botón Importar.
  3. Navegue 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 aparece, 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 se pueden importar y exportar sólo desde el visor de seguimiento de servicio. No se pueden leer con otras herramientas.

Buscar datos

El visor proporciona las maneras siguientes 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. Se puede acceder a él a través del menú Editar o mediante la combinación de teclas Ctrl + F.

La barra de herramientas Buscar aparece en la parte superior del visor. Si no aparece, puede activarla en el menú Ver. La barra tiene dos componentes:

  • Buscar: le permite escribir una palabra clave de búsqueda.
  • Buscar en: le permite introducir un área de búsqueda. Puede seleccionar buscar en todas las actividades o sólo en la actividad actual.

El diálogo de la búsqueda proporciona dos opciones adicionales:

  • Buscar destino:
    • La opción “datos de registro sin formato” busca la palabra clave en todos los datos sin formato.
    • Las opciones “texto XML” y “atributo XML” sólo buscan en elementos XML.
    • La opción “Mensaje registrado” sólo busca la palabra clave en mensajes.
  • Omitir la actividad raíz: la búsqueda omite los seguimientos 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 los 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.

Paso hacia delante o hacia atrás

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. Ir hacia delante significa ir al seguimiento próximo en la actividad.

  • Ir hacia delante: utilice el menú Actividad o presione “F10”. También puede utilizar la tecla de dirección “abajo” en el panel de seguimiento.
  • Ir hacia detrás: utilice el menú Actividad o presione “F9”. También puede utilizar la tecla de dirección “arriba” en el panel de seguimiento.

Nota

Esto puede llevarlo a una actividad que ocurre en un proceso diferente o incluso en un equipo diferente, porque los mensajes WCF pueden llevar id. de actividad que abarcan varios equipos.

Seguir la transferencia

Los seguimientos de transferencia son seguimientos especiales en el archivo de seguimiento. Una actividad puede transferir a otra actividad por un seguimiento de la transferencia. Por ejemplo, la “actividad A” puede transferir a la “actividad B”. En este caso, hay un seguimiento de la transferencia en la “actividad A” con el nombre “A: actividad” y el icono de transferencia. Este seguimiento de la transferencia es un vínculo entre los dos seguimientos. 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, a continuación, 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 otros seguimientos.

Hay dos maneras de seguir una transferencia: con el mouse o con el teclado:

  • Con el mouse: haga doble clic en el seguimiento de la transferencia en el panel de seguimiento.
  • Con el teclado: seleccione un seguimiento de la transferencia y utilice “Seguir transferencia” en el menú Actividad o presione “F11”

Nota

En muchos casos, cuando la actividad A transfiere a la actividad B, la actividad A espera hasta que la actividad B transfiere de vuelta a la actividad A. Esto significa que la actividad A no tiene registrado ningún seguimiento cuando la actividad B realiza un seguimiento activo. Sin embargo, también es posible que la actividad A no espere y continúe registrando los seguimientos. También es posible que la actividad B no transfiera de vuelta a la actividad A. En este sentido, las transferencias de actividad aún son diferentes de las llamadas de función. Es más fácil entender las transferencias de actividad en la vista de gráfico.

Pasar a la transferencia siguiente o anterior

Cuando analice la actividad actual, o las actividades seleccionadas cuando se han seleccionado varias actividades, puede que quiera buscar rápidamente las actividades a las que transfiere. “Pasar a la siguiente transferencia” le permite buscar el siguiente seguimiento de transferencia en la actividad. En cuanto haya encontrado el seguimiento de transferencia, puede utilizar “Seguir transferencia" para ir a la actividad siguiente.

  • Pasar a la transferencia siguiente: utilice el menú Actividad o presione “Ctrl + F10”.
  • Pasar a la transferencia anterior: utilice el menú Actividad o presione “Ctrl + F9”.

Aunque navegar por el panel de actividad y el panel de seguimiento es similar a depurar, utilizar la vista de Gráfico proporciona una navegación mucho mejor. Consulte la sección “Vista de gráfico” para obtener más información.

Cargar archivos de seguimiento grandes

Algunos archivos de seguimiento pueden ser muy grandes. Por ejemplo, si habilita el seguimiento en nivel “detallado”, el archivo de seguimiento resultante que vaya a ejecutarse unos minutos puede ser fácilmente de cientos de megabytes o incluso mayor, según la velocidad de red y el modelo de comunicación.

Abrir un archivo de seguimiento muy grande en el visor de seguimiento de servicio puede repercutir negativamente en el rendimiento del sistema. La velocidad de carga y el tiempo de respuesta después de haber terminado la carga pueden ser lentos. La velocidad real difiere de vez en cuando, según su configuración del hardware. En la mayoría de los PC, cargar un archivo de seguimiento de más de 200 MB repercute seriamente en el rendimiento. Y en el caso de archivos de seguimiento de más de 1 GB, la herramienta puede agotar toda la memoria disponible o no responder durante bastante tiempo.

Para evitar una carga y tiempo de respuesta lentos al analizar archivos de seguimiento grandes, el visor de seguimiento de servicio cuenta con una característica llamada “carga parcial”, con la cual se cargan partes pequeñas del seguimiento de una en una. Por ejemplo, puede darse el caso de que tenga un archivo de seguimiento de más de un 1 GB y que esté ejecutándose durante varios días en el servidor. Cuando hayan ocurrido algunos errores y desee 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 área es menor, la herramienta de visor de seguimiento de servicio puede cargar el archivo más rápido, e identificar así los errores utilizando un conjunto menor de datos.

Habilitar la carga parcial

No necesita 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 diálogo de carga parcial para que usted seleccione la parte que desea cargar.

Nota

Dado que puede que los seguimientos no se distribuyan de manera uniforme en el intervalo de tiempo, la longitud del período de tiempo que especifique en la barra de herramientas de carga parcial puede que no sea proporcional al tamaño de carga que se muestra. El tamaño de carga real puede ser menor que el tamaño estimado en el diálogo de carga parcial.

Ajustar la carga parcial

Después de haber cargado parcialmente el archivo de seguimiento, puede cambiar el conjunto de datos que se está cargando. Puede hacer esto ajustando la barra de herramientas de carga parcial en la parte superior del visor.

  1. Mueva la barra de herramientas con el mouse o escriba la hora de inicio y finalización.
  2. Haga clic en el botón Ajustar.

Introducción a los iconos de seguimiento

A continuación, se muestra una lista de iconos que la herramienta visor de seguimiento de servicio utiliza en las vistas de Actividad y de Gráfico y en el panel de Seguimiento para representar elementos diferentes.

Nota

Algunos seguimientos que no están categorizados (por ejemplo, “se cierra un mensaje”) no tienen ningún icono.

Actividad de seguimiento de seguimientos

Icono Descripción
Seguimiento de advertencia

Seguimiento de advertencia: un seguimiento 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 la aplicación, 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 seguimiento para la correlación de seguimiento, puede ver varios inicios para el mismo id. de actividad (uno por origen de seguimiento). Se emite el seguimiento de inicio si ActivityTracing está habilitado para el origen de seguimiento.

Seguimiento de detención de actividad

Seguimiento de fin de actividad: un seguimiento que marca el fin de una actividad. . Contiene el nombre de la actividad. Como diseñador o programador de la aplicación, debería definir un seguimiento de fin de actividad por origen de seguimiento. Ningún seguimiento de un origen de seguimiento determinado aparece después del fin de actividad emitido por ese origen de seguimiento, 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 seguimiento para la correlación de seguimiento, puede ver varios finales para el mismo id. de actividad (uno por origen de seguimiento). Se emite el seguimiento de fin si ActivityTracing está habilitado para el origen de seguimiento.

Seguimiento de suspensión de actividad

Seguimiento de suspensión de actividad: un seguimiento que marca la hora que se pausa una actividad. No se emite ningún rastro en una actividad suspendida hasta que se reanuda la actividad. Una actividad suspendida denota que no se está efectuando ningún procesamiento en esa actividad en el área 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 seguimiento.

Seguimiento de reanudación de actividad

Seguimiento de reanudación de actividad: un seguimiento que marca la hora a la que se reanuda una actividad una vez 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 seguimiento.

Transferencia

Transferencia: un seguimiento que se emite cuando el flujo de control lógico se transfiere de una actividad a otra. La actividad en la que se origina la transferencia puede continuar realizando el trabajo en paralelo a la actividad a la que va la transferencia. Se emite el seguimiento de transferencia si ActivityTracing está habilitado para el origen de seguimiento.

Transferir 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 del registro 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 seguimiento de System.ServiceModel.MessageLogging está habilitado. Al hacer clic en este seguimiento, se muestra el mensaje. Hay cuatro puntos de registro configurables para un mensaje: ServiceLevelSendRequest, TransportSend, TransportReceive y ServiceLevelReceiveRequest, que también pueden ser especificados por el atributo messageSource en el seguimiento del registro de mensajes.

Seguimiento de mensajes recibidos

Seguimiento de mensaje recibido: un seguimiento que se emite cuando se recibe un mensaje WCF, si el origen de seguimiento 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 WCF, si el origen de seguimiento 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 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.

Escuchar actividad

Actividad de escucha: una actividad que registra los seguimientos relacionados con un agente de escucha. Dentro de esta actividad, podemos ver información del agente de escucha y solicitudes de conexión.

Recibir actividad de bytes

Actividad de recepción de bytes: una actividad que agrupa todos los seguimientos relacionados con la recepción de bytes de entrada en una conexión entre dos extremos. Esta actividad es esencial para ponerse en correlación con actividades de transporte que propagan su id. de actividad como http.sys. Esta actividad es esencial para ponerse en correlación con actividades de transporte que propagan su id. de actividad como http.sys. En esta actividad aparecerán errores de conexión tales como interrupciones.

Actividad de mensaje de proceso

Actividad de procesamiento de mensajes: una actividad que agrupa los seguimientos relacionados con crear un mensaje WCF. En esta actividad aparecerán errores debidos a una envoltura no válida o a un mensaje incorrecto. Dentro de esta actividad, podemos inspeccionar los encabezados del mensaje para ver si un id. de actividad se propagó a partir del 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 del registro de mensajes

Actividad de procesamiento de acción: una actividad que agrupa todos los seguimientos relacionados con una solicitud WCF a través de dos extremos. 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. Tal actividad contendrá los errores debidos al procesamiento de seguridad o transporte, extendiéndose al límite del código de usuario y de vuelta (si existe una respuesta).

Actividad de mensaje de proceso

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 el permiso para escribir en el registro, obtendrá el mensaje de error siguiente que "El visor de seguimiento de servicio de Microsoft no está registrado en el sistema" al utilizar el comando "svctraceviewer /register" para registrar la herramienta. Si ocurre esto, debe iniciar una sesión utilizando una cuenta que tenga acceso de la escritura al registro.

Además, las herramienta del visor de seguimiento de servicio escribe algunos valores (por ejemplo, filtros personalizados y opciones de filtro) en el archivo SvcTraceViewer.exe.settings de su carpeta de ensamblado. Si no tiene permiso de lectura para el archivo, puede iniciar la herramienta pero no puede cargar los valores.

Si obtiene el mensaje de error "Se ha producido un error desconocido al procesar uno o más seguimientos" al abrir el archivo .etl, quiere decir que el formato del archivo .etl no es válido.

Si se abre un registro de seguimiento creado utilizando un sistema operativo árabe, puede observar que el filtro horario no funciona. Por ejemplo, el año 2005 corresponde al año 1427 en el calendario árabe. Sin embargo, el intervalo temporal admitido por el filtro de la herramienta del visor de seguimiento de servicio no admite una fecha anterior a 1752. Esto puede hacer que no pueda seleccionar una fecha correcta en el filtro. Para resolver este problema, puede crear un filtro personalizado (Ver/Filtros personalizados) utilizando una expresión XPath para incluir un intervalo temporal concreto.

Consulte también

Otros recursos

Using Service Trace Viewer for Viewing Correlated Traces and Troubleshooting
Configuring Tracing
Activity Tracing and Propagation for End-To-End Trace Correlation