Compartir a través de


Recopilar información de IntelliTrace

Nota de precauciónPrecaución

Nota: en Visual Studio 2010 Ultimate Service Pack 1, IntelliTrace ya no guarda de forma predeterminada los archivos de registro de IntelliTrace (archivos .iTrace files) cuando se cierra. Para obtener información sobre cómo guardar los archivos de registro de Intellitrace, vea Guardar archivos de registro en este tema.

Este tema solo atañe a Visual Studio 2010 Ultimate.

IntelliTrace está habilitado de forma predeterminada en Visual Studio 2010 Ultimate. Durante una sesión de depuración en directo, IntelliTrace funciona en segundo plano, recogiendo información de IntelliTrace de forma automática e invisible. La disponibilidad de esta información permite cambiar de la sesión de depuración en directo a la depuración con IntelliTrace y "viajar en el tiempo" a través del código.

De forma predeterminada, IntelliTrace solamente recopila y registra información para eventos IntelliTrace seleccionados. La configuración de recopilación predeterminada presenta una sobrecarga mínima. No afecta al funcionamiento de la aplicación ni a su capacidad para usar el depurador de Visual Studio.

La recopilación de llamadas y parámetros permite a IntelliTrace proporcionar capacidades de depuración adicionales. Sin embargo, esta recopilación aumentará la sobrecarga de rendimiento, usará más espacio en disco y deshabilitará la característica Editar y continuar del depurador de Visual Studio. Deberá considerar los inconvenientes y las ventajas para su aplicación y escenario de depuración concretos.

Las opciones de recopilación se establecen en el nivel de Visual Studio. Se aplican a todos los proyectos y soluciones de Visual Basic y C#. Las opciones de recopilación se conservan entre sesiones de depuración y sesiones de Visual Studio.

En este tema

  • Guardar archivos de registro

  • Eventos de IntelliTrace

  • Llamadas y parámetros

  • Configurar la recopilación por módulo

Guardar archivos de registro

De forma predeterminada, IntelliTrace no guarda los archivos de registro de IntelliTrace (archivos .iTrace) cuando se cierra Visual Studio. Puede cambiar el comportamiento predeterminado para permitir que IntelliTrace guarde todos los archivos de registro o puede hacerlo manualmente, tal y como se describe en los procedimientos siguientes.

Para cambiar el comportamiento predeterminado de los archivos de registro de IntelliTrace

  1. En el menú Herramientas, haga clic en Opciones.

  2. En la lista de categorías de opciones, expanda el nodo IntelliTrace y haga clic en Avanzadas.

  3. Realice una de las tareas siguientes:

    1. Si desea guardar todos los archivos de registro de IntelliTrace (archivos .iTrace), active Almacenar registros de IntelliTrace en este directorio y, a continuación, especifique la ruta de acceso de la carpeta en la que desea guardar los archivos.

    2. Si desea que los archivos .iTrace se eliminen cuando se cierre Visual Studio a menos que los guarde manualmente, desactive Almacenar registros de IntelliTrace en este directorio.

  4. Haga clic en Aceptar para guardar los cambios.

Para guardar manualmente un archivo de registro de IntelliTrace

  1. Haga clic en el botón Guardar la sesión actual de IntelliTrace situado en la barra de herramientas de la ventana IntelliTrace.

  2. En el cuadro de diálogo Guardar como, especifique el nombre de archivo en el que desea guardar la sesión y, a continuación, haga clic en Guardar.

Eventos de IntelliTrace

Los eventos de IntelliTrace son eventos que se producen mientras se ejecuta la aplicación y que IntelliTrace puede recopilar. A continuación se indican los tipos de eventos que IntelliTrace puede recopilar:

  • Eventos de depurador. Son eventos que se producen dentro del Depurador de Visual Studio mientras se depura la aplicación. El inicio de la aplicación es un evento de depurador. Otros eventos de depurador son los eventos de parada, es decir, eventos que hacen que la aplicación entre en un estado de interrupción. La llegada a un punto de interrupción, la llegada a un punto de seguimiento o la ejecución de un comando de paso son ejemplos de eventos de parada.

    Por razones de rendimiento, IntelliTrace no recopila todos los valores posibles para cada evento del depurador. En su lugar, IntelliTrace recopila valores que son visibles para el usuario. Por ejemplo, si la ventana Automático está abierta, IntelliTrace recopilará los valores que sean visibles en la ventana Automático. Si la ventana Automático está cerrada, no se recopilarán esos valores.

    Si señala a una variable en una ventana de código fuente, se recopilará el valor que aparece en la información sobre datos. Sin embargo, los valores de una información sobre datos anclada no se recopilarán.

  • Eventos de excepción. Se producen en las excepciones administradas, en los puntos donde se produce y se detecta la excepción, y en las excepciones no controladas. IntelliTrace recopila el tipo de excepción y el mensaje de excepción.

  • Eventos de Framework. Se producen dentro de la biblioteca de .NET. Puede ver una lista completa de los eventos .NET que se pueden recopilar en la página Eventos de IntelliTrace del cuadro de diálogo Opciones. Los datos recopilados por IntelliTrace varían según el evento. En el caso de un evento Acceso a archivos, IntelliTrace recopila el nombre del archivo; si se trata de un evento Activar casilla, recopila el estado y el texto de la casilla, etc.

Para ver una lista de los eventos de IntelliTrace que se han recopilado, haga clic en la pestaña Eventos de IntelliTrace de la ventana IntelliTrace. Si IntelliTrace está habilitado, los eventos de depurador se recopilan siempre. No puede desactivar su recopilación.

De forma predeterminada se recoge la mayoría de los eventos de .Framework comunes. Puede utilizar el siguiente procedimiento para seleccionar otros eventos de .NET. Además, puede deshabilitar la recopilación de cualquier evento de .NET o de todos ellos. Para reducir el desorden de la ventana IntelliTrace, puede deshabilitar la recopilación de eventos que no lo interesan. La habilitación o la deshabilitación de la recopilación de eventos específicos suele tener poco efecto en el rendimiento de la aplicación.

Para elegir qué eventos de IntelliTrace se desean registrar

  1. En la barra de herramientas de la ventana IntelliTrace, haga clic en el icono Abrir configuración de IntelliTrace.

    O bien

    1. En el menú Herramientas, haga clic en Opciones.

    2. En el cuadro de diálogo Opciones, elija el nodo IntelliTrace y haga clic en General.

  2. Compruebe que la opción Habilitar IntelliTrace está seleccionada.

    Nota

    Al desactivar la casilla Deshabilitar IntelliTrace, se deshabilita toda la configuración personalizada.

  3. En el nodo IntelliTrace, haga clic en Eventos de IntelliTrace.

  4. Busque en el cuadro Eventos de IntelliTrace las categorías de eventos que le interesan.

    1. Para ver eventos individuales, haga clic en el control de árbol situado junto al nombre Categoría. Por ejemplo, puede expandir Registro para ver los eventos del Registro concretos como ClosedRegistryKey.

    2. Para habilitar o deshabilitar el registro de una categoría completa de eventos, active o desactive la casilla situada junto al nombre de la categoría.

    3. Para habilitar o deshabilitar el registro de un evento específico, active o desactive la casilla situada junto al nombre de evento específico.

  5. Haga clic en Aceptar.

  6. Si está depurando, debe reiniciar la sesión de depuración para que los cambios surtan efecto.

Llamadas y parámetros

Si necesita más información durante la depuración con IntelliTrace, puede activar la opción que le permite recopilar información sobre las llamadas y sus parámetros. La recopilación de información de las llamadas puede afectar al rendimiento de la aplicación y aumentar el tamaño de los archivos de registro.

La recopilación de información de las llamadas es incompatible con la característica Editar y continuar del depurador de Visual Studio. Si decide recopilar información de las llamadas, la opción Editar y continuar se deshabilita automáticamente y no se puede volver a habilitar mientras esté habilitada la recopilación de información de las llamadas.

Al habilitar Eventos de IntelliTrace e información de llamadas, IntelliTrace recopila un registro de cada entrada y salida de llamada. En la entrada, IntelliTrace recopila información sobre el nombre y el valor de cada parámetro. En las matrices sólo se registran los 256 primeros objetos. En los objetos, solamente se registra el nivel superior de la estructura. En la salida, IntelliTrace recopila el valor devuelto del método.

Para habilitar la recopilación de información de llamadas

  1. En el cuadro de diálogo Opciones, en el nodo IntelliTrace, haga clic en General.

  2. En la página General, haga clic en Eventos de IntelliTrace e información de llamadas.

  3. Haga clic en Aceptar.

Configurar la recopilación por módulo

Puede activar o desactivar la recopilación de información de IntelliTrace para módulos concretos. Esta capacidad es útil porque ciertos módulos podrían no resultar interesantes a efectos de depuración. Por ejemplo, podría depurar una solución que incluye proyectos DLL heredados que ya se han probado y depurado correctamente. Al excluir módulos que no interesan, se reduce el desorden de la ventana IntelliTrace y resulta más fácil concentrarse en el código interesante. También puede mejorar el rendimiento y reducir el espacio en disco que usa el archivo de registro. La diferencia puede resultar significativa si ha decidido recopilar llamadas y parámetros.

Para recopilar datos de módulos seleccionados

  1. En el cuadro de diálogo Opciones, en el nodo IntelliTrace, haga clic en Módulos.

  2. Active Recopilar datos de todos los módulos excepto los siguientes o en Recopilar datos solo de los siguientes módulos.

    Debajo de esta configuración aparece una lista de nombres de módulo.

  3. Para quitar un módulo de la lista, seleccione su nombre y haga clic en el botón Quitar.

  4. Para agregar un módulo a la lista:

    1. Haga clic en el botón Agregar.

      Aparecerá el cuadro de diálogo Agregar un modelo.

    2. En el cuadro Escriba un modelo de cadena, escriba el nombre del módulo que desea agregar a la lista. Puede usar especificadores de carácter comodín al principio o al final de la cadena para agregar más de un módulo.

    3. Haga clic en Agregar.

    Los nombres de módulo deben ser nombres de archivo y no nombres del ensamblado. No se aceptan rutas de acceso a archivos.

  5. Haga clic en Aceptar.

    Nota

    Si la recolección está establecida en Solo eventos en la página General, la configuración de los módulos no tiene ningún efecto.

Vea también

Conceptos

Depurar con IntelliTrace