Depure sus aplicaciones con Azure Application Insights en Visual Studio

En Visual Studio (2015 y versiones posteriores), se pueden diagnosticar y analizar los problemas de rendimiento de las aplicaciones web, tanto en tiempo de depuración como en producción, mediante los datos de telemetría de Azure Application Insights.

Si ha creado la aplicación web de ASP.NET mediante Visual Studio 2017 o versiones posteriores, ya tiene el SDK de Application Insights. Si todavía no lo ha hecho, agregue Application Insights a su aplicación.

Para supervisar la aplicación cuando se encuentra activa en producción, normalmente verá la telemetría de Application Insights en Azure Portal, donde puede establecer alertas y aplicar eficaces herramientas de supervisión. Pero para la depuración, también puede buscar y analizar la telemetría en Visual Studio. Puede usar Visual Studio para analizar la telemetría desde su sitio de producción y desde los procesos de depuración que se ejecutan en el equipo de desarrollo. En este caso, puede analizar los procesos de depuración aunque todavía no haya configurado el SDK para enviar telemetría a Azure Portal.

Depure el proyecto

Ejecute la aplicación web en modo de depuración local mediante F5. Abra distintas páginas para generar telemetría.

En Visual Studio, puede ver un recuento de los eventos que el módulo Application Insights ha registrado en el proyecto.

In Visual Studio, the Application Insights button shows during debugging.

Haga clic en este botón para buscar la telemetría.

La ventana de búsqueda de Application Insights muestra los eventos que se han registrado. (Si inició sesión en Azure al configurar Application Insights, puede buscar los mismos eventos en Azure Portal).

Right-click the project and choose Application Insights, Search

Nota:

Después de seleccionar o anular la selección de filtros, haga clic en el botón de búsqueda al final del campo de búsqueda de texto.

La búsqueda de texto sin formato funciona en todos los campos de los eventos. Por ejemplo, buscar parte de la dirección URL de una página; o el valor de una propiedad, como la ciudad del cliente; o palabras específicas en un registro de seguimiento.

Haga clic en cualquier evento para ver sus propiedades con todo detalle.

Para las solicitudes a la aplicación web, puede hacer clic en el código.

Under Request Details, click through to the code

También puede abrir los elementos relacionados para ayudar a diagnosticar las solicitudes con errores o excepciones.

Under Request Details, scroll down to related items

Ver solicitudes con error y excepciones

Informes de excepciones en la ventana de búsqueda. (En algunos tipos anteriores de aplicaciones de ASP.NET, tendrá que configurar la supervisión de excepciones para ver las excepciones que el entorno administra).

Haga clic en una excepción para obtener un seguimiento de la pila. Si el código de la aplicación es abierto en Visual Studio, puede hacer clic para recorrer el seguimiento de la pila hasta dar con la línea correspondiente del código.

Screenshot shows the About object in a stack trace.

Ver resúmenes de solicitudes y excepciones en el código

En la línea de Code Lens, encima de cada método de controlador, puede ver un recuento de las solicitudes y excepciones registradas por Application Insights en las últimas 24 horas.

Screenshot shows an exception in a context dialog box.

Nota:

Code Lens muestra los datos de Application Insights solo si tiene configurada la aplicación para enviar telemetría al portal de Application Insights.

Más información acerca de Application Insights en Code Lens

Supervisión local

(Desde Visual Studio 2015 Update 2) Si no ha configurado el SDK para enviar datos de telemetría al portal de Application Insights (para que no haya ninguna clave de instrumentación en ApplicationInsights.config), la ventana diagnóstico muestra los datos de telemetría de la sesión de depuración más reciente.

Esto es conveniente si ya ha publicado una versión anterior de la aplicación. No quiere que los datos de telemetría de las sesiones de depuración se mezclen con los datos de telemetría en el portal de Application Insights de la aplicación publicada.

También es útil si tiene datos de telemetría personalizados que desea depurar antes de enviarlos al portal.

  • En primer lugar, configuré totalmente Application Insights para enviar los datos de telemetría al portal. Pero ahora me gustaría ver los datos de telemetría solo en Visual Studio.

    • En la configuración de la ventana de búsqueda, hay una opción para buscar diagnósticos locales, incluso si la aplicación envía datos de telemetría al portal.
    • Para detener el envío de datos de telemetría al portal, convierta en comentario la línea <instrumentationkey>... de ApplicationInsights.config. Cuando esté listo para enviar de nuevo datos de telemetría al portal, quite los comentarios.

Nota:

El 31 de marzo de 2025 finalizará la compatibilidad con la ingesta de claves de instrumentación. La ingesta de claves de instrumentación seguirá funcionando, pero la característica ya no recibirá actualizaciones ni soporte técnico. Transición a las cadenas de conexión para aprovechar las nuevas funcionalidades.

Pasos siguientes