Depuración de un servicio en la nube de Azure publicado con Visual Studio e IntelliTrace

Nota:

Este artículo se aplica a Azure Cloud Services (clásico), que ahora está en desuso para los nuevos clientes y se retirará el 31 de agosto de 2024. Los servicios existentes creados con esta tecnología siguen teniendo soporte técnico a través de Azure Cloud Services (soporte extendido). Para los desarrollos nuevos, le recomendamos que use un tipo de servicio más reciente diseñado para su propósito específico, como por ejemplo, Azure App Service, Azure Functions o Azure Container Apps. Para obtener la lista más reciente de los servicios disponibles, consulte Directorio de productos de Azure.

Con IntelliTrace, puede registrar información de depuración amplia para una instancia de rol cuando se ejecuta en Azure. Si necesita encontrar la causa de un problema, puede utilizar los registros de IntelliTrace para recorrer su código desde Visual Studio como si se estuviera ejecutando en Azure. De hecho, IntelliTrace graba datos de entorno y ejecución de código de clave cuando su aplicación de Azure se ejecuta como servicio en la nube en Azure y le permite reproducir los datos grabados desde Visual Studio.

Puede utilizar IntelliTrace si tiene Visual Studio Enterprise instalado y su aplicación de Azure tiene como destino .NET Framework 4 o una versión posterior. IntelliTrace recopila información para sus roles de Azure. Las máquinas virtuales para estos roles siempre ejecutan sistemas operativos de 64 bits.

Como alternativa, puede usar la depuración remota para conectarse directamente a un servicio en la nube que se ejecuta en Azure.

Importante

IntelliTrace está pensado solo para escenarios de depuración y no debe usarse para una implementación de producción.

Requisitos previos

Configuración de una aplicación de Azure para IntelliTrace

Para habilitar IntelliTrace para una aplicación de Azure, debe crear y publicar la aplicación desde un proyecto de Azure de Visual Studio. Debe configurar IntelliTrace para su aplicación de Azure antes de su publicación en Azure. Si publica la aplicación sin configurar IntelliTrace, deberá volver a publicar el proyecto. Para obtener más información, consulte Publicación de proyectos de Azure Cloud Services con Visual Studio.

  1. Cuando esté preparado para implementar la aplicación de Azure, compruebe que los destinos de compilación del proyecto estén establecidos en Depurar.

  2. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y, en el menú contextual, seleccione Publicar.

  3. En el cuadro de diálogo Publicar aplicaciones de Azure, seleccione la suscripción de Azure y, luego, Siguiente.

  4. En la página de configuración, seleccione la pestaña de configuración avanzada.

  5. Active la opción Habilitar IntelliTrace para recopilar registros de IntelliTrace de la aplicación cuando se publique en la nube.

  6. Para personalizar la configuración básica de IntelliTrace, seleccione Configuración junto a Habilitar IntelliTrace.

    Vínculo de configuración de IntelliTrace

  7. En el cuadro de diálogo de configuración de IntelliTrace, puede especificar qué eventos se van a registrar, si se va a recopilar información de llamada, para qué módulos y procesos se van a recopilar registros y cuánto espacio se va a asignar a la grabación. Para obtener más información sobre IntelliTrace, consulte Depuración con IntelliTrace.

    Configuración de IntelliTrace

El registro de IntelliTrace es un archivo de registro circular del máximo tamaño especificado en la configuración de IntelliTrace (el tamaño predeterminado es de 250 MB). Los registros de IntelliTrace se recopilan en un archivo en el sistema de archivos de la máquina virtual. Al solicitar los registros, se toma una instantánea en ese momento en el tiempo y se descarga en su equipo local.

Después de que el servicio en la nube de Azure se publica en Azure, puede determinar si se habilitó IntelliTrace desde el nodo de Azure en el Explorador de servidores, tal como se muestra en la imagen siguiente:

Explorador de servidores: IntelliTrace habilitado

Descarga de registros de IntelliTrace para una instancia de rol

Con Visual Studio, puede descargar registros de IntelliTrace para una instancia de rol si sigue estos pasos:

  1. En Explorador de servidores, expanda el nodo Cloud Services y ubique la instancia de rol cuyos registros desea descargar.

  2. Haga clic con el botón derecho en la instancia de rol y, en el menú contextual, seleccione Ver registros de IntelliTrace.

    Opción de menú Ver registros de IntelliTrace

  3. Los registros de IntelliTrace se descargan en un archivo de un directorio de su equipo local. Cada vez que solicita los registros de IntelliTrace, se crea una nueva instantánea. Cuando se descargan los registros, Visual Studio muestra el avance de la operación en la ventana Registro de actividad de Azure. Como se muestra en la ilustración siguiente, puede expandir el artículo de línea de la operación para ver más detalles.

VST_IntelliTraceDownloadProgress

Puede continuar trabajando en Visual Studio mientras se descargan los registros de IntelliTrace. Cuando el registro termine la descarga, se abre en Visual Studio.

Nota

Es posible que los registros de IntelliTrace contengan excepciones que el marco genera y maneja posteriormente. El código del marco interno genera estas excepciones como parte normal del inicio de un rol, por lo que puede omitirlas de forma segura.