Inicio de la supervisión de la aplicación web ASP.NETStart monitoring your ASP.NET Web Application

Con Azure Application Insights puede supervisar fácilmente la disponibilidad, el rendimiento y el uso de su aplicación web.With Azure Application Insights, you can easily monitor your web application for availability, performance, and usage. También puede identificar y diagnosticar errores en la aplicación rápidamente sin tener que esperar a que un usuario informe de ellos.You can also quickly identify and diagnose errors in your application without waiting for a user to report them. Con la información que recopile de Application Insights sobre el rendimiento y la eficacia de la aplicación, puede tomar decisiones informadas para hacer el mantenimiento de la aplicación y mejorarla.With the information that you collect from Application Insights about the performance and effectiveness of your app, you can make informed choices to maintain and improve your application.

En esta guía de inicio rápido se muestra cómo agregar Application Insights a una aplicación web ASP.NET existente y empezar a analizar las estadísticas en vivo, que es solo uno de los distintos métodos que puede usar para analizar la aplicación.This quickstart shows how to add Application Insights to an existing ASP.NET web application and start analyzing live statistics, which is just one of the various methods you can use to analyze your application. Si no tiene una aplicación web ASP.NET, puede seguir el artículo de Inicio rápido de creación de aplicaciones web ASP.NET para crear una.If you do not have an ASP.NET web application, you can create one following the Create an ASP.NET Web App quickstart.

PrerequisitesPrerequisites

Para completar esta guía de inicio rápido:To complete this quickstart:

  • Instale Visual Studio 2019 con las cargas de trabajo siguientes:Install Visual Studio 2019 with the following workloads:
    • ASP.NET y desarrollo webASP.NET and web development
    • Desarrollo de AzureAzure development

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Habilitación de Application InsightsEnable Application Insights

  1. Abra el proyecto en Visual Studio 2019.Open your project in Visual Studio 2019.

  2. Seleccione Configurar Application Insights desde el menú Proyecto.Select Configure Application Insights from the Project menu. Visual Studio agregará el SDK de Application Insights a la aplicación.Visual Studio adds the Application Insights SDK to your application.

    Importante

    El proceso para agregar Application Insights varía según el tipo de plantilla de ASP.NET.The process to add Application Insights varies by ASP.NET template type. Si usa la plantilla Vacía o Aplicación móvil de Azure , seleccione Proyecto > Agregar telemetría de Application Insights.If you are using the Empty or Azure Mobile App template select Project > Add Application Insights Telemetry. Para las demás plantillas de ASP.NET, consulte las instrucciones del paso anterior.For all other ASP.NET templates consult the instructions in the step above.

  3. Haga clic en Iniciar (en versiones anteriores de Visual Studio, haga clic en el botón Inicio gratis ).Click Get Started (earlier versions of Visual Studio have a Start Free button instead).

    Adición de Application Insights a Visual Studio

  4. Seleccione su suscripción y haga clic en Registrarse.Select your subscription and click Register.

  5. Seleccione Proyecto > Administrar paquetes NuGet > Origen de paquete: Nuget.org > Actualizar para actualizar los paquetes del SDK de Application Insights a la versión estable más reciente.Select Project > Manage NuGet Packages > Package source: nuget.org > Update the Application Insights SDK packages to the latest stable release.

  6. Para ejecutar la aplicación, seleccione Iniciar depuración desde el menú Depurar o presionando la tecla F5.Run your application by either selecting Start Debugging from the Debug menu or by pressing the F5 key.

Confirmación de la configuración de la aplicaciónConfirm app configuration

Application Insights recopila datos de telemetría para la aplicación, independientemente de dónde se ejecute.Application Insights gathers telemetry data for your application regardless of where it's running. Siga estos pasos para empezar a ver los datos.Use the following steps to start viewing this data.

  1. Abra Application Insights haciendo clic en Ver -> Otras ventanas -> Búsqueda de Application Insights.Open Application Insights by clicking View -> Other Windows -> Application Insights Search. Se mostrará la telemetría de la sesión actual.You see the telemetry from your current session.

    Telemetría en Visual StudioTelemetry in Visual Studio

  2. Haga clic en la primera solicitud de la lista (en el ejemplo, GET Home/Index) para ver sus detalles.Click on the first request in the list (GET Home/Index in this example) to see the request details. Observe que, junto con otra información valiosa acerca de la solicitud, se incluye el código de estado y la hora de respuesta.Notice that the status code and response time are both included along with other valuable information about the request.

    Detalles de la respuesta en Visual Studio

Inicio de la supervisión en Azure PortalStart monitoring in the Azure portal

Ya puede abrir Application Insights en Azure Portal para ver distintos detalles acerca de la aplicación en ejecución.You can now open Application Insights in the Azure portal to view various details about your running application.

  1. Expanda la carpeta Servicios conectados en el Explorador de soluciones y haga clic con el botón derecho en la carpeta Application Insights y, después, en Abrir portal de Application Insights.Expand the Connected Services folder (cloud and plug icon) in the Solution Explorer then right-click on the Application Insights folder and click Open Application Insights Portal. Se mostrará cierta información acerca de la aplicación, así como varias opciones.You see some information about your application and a variety of options.

    Captura de pantalla que muestra información sobre la aplicación en el portal de Application Insights.

  2. Haga clic en Mapa de aplicación para mostrar un diseño visual de las relaciones de dependencia entre los componentes de la aplicación.Click on Application map to get a visual layout of the dependency relationships between your application components. Cada componente muestra KPI como la carga, el rendimiento, errores y alertas.Each component shows KPIs such as load, performance, failures, and alerts.

    Mapa de aplicación

  3. Haga clic en el icono de análisis de aplicaciones. Captura de pantalla del icono de análisis de aplicaciones.Click on the App Analytics icon Screenshot of the App Analytics icon. Ver en registros (Analytics) en uno de los componentes de la aplicación.View in Logs (Analytics) on one of the application components. Se abrirá Registros (Analytics) , que proporciona un lenguaje de consulta avanzado para analizar todos los datos recopilados por Application Insights.This opens Logs (Analytics) , which provides a rich query language for analyzing all data collected by Application Insights. En este caso, se genera una consulta que representa el número de solicitudes en un gráfico.In this case, a query is generated for you that renders the request count as a chart. Puede escribir sus propias consultas para analizar otros datos.You can write your own queries to analyze other data.

    Análisis

  4. Haga clic en Live Metrics Stream a la izquierda Investigar.Click on Live Metrics Stream on the left under investigate. Se mostrarán estadísticas en vivo sobre la aplicación mientras se ejecuta.This shows live statistics about your application as it's running. Esto incluye información como el número de solicitudes entrantes, la duración de estas y los errores que se producen.This includes such information as the number of incoming requests, the duration of those requests, and any failures that occur. También puede inspeccionar las métricas de rendimiento crítico, como el procesador y la memoria.You can also inspect critical performance metrics such as processor and memory.

    Live Stream

    Si está listo para hospedar su aplicación en Azure, puede publicarla ahora.If you are ready to host your application in Azure, you can publish it now. Siga los pasos que se describen en la guía de inicio rápido para crear una aplicación web de ASP.NET.Follow the steps described in Create an ASP.NET Web App Quickstart.

  5. Si usa Visual Studio para agregar la supervisión de Application Insights, puede agregar automáticamente la supervisión de cliente.If you use Visual Studio to add Application Insights monitoring, you can automatically add client-side monitoring. Para agregar manualmente la supervisión de cliente a una aplicación, agregue el siguiente código de JavaScript a esta:To add client-side monitoring manually to an application add the following JavaScript to your application:

<!-- 
To collect user behavior analytics about your application, 
insert the following script into each page you want to track.
Place this code immediately before the closing </head> tag,
and before any other scripts. Your first data will appear 
automatically in just a few seconds.
-->
<script type="text/javascript">
var appInsights=window.appInsights||function(a){
  function b(a){c[a]=function(){var b=arguments;c.queue.push(function(){c[a].apply(c,b)})}}var c={config:a},d=document,e=window;setTimeout(function(){var b=d.createElement("script");b.src=a.url||"https://az416426.vo.msecnd.net/scripts/a/ai.0.js",d.getElementsByTagName("script")[0].parentNode.appendChild(b)});try{c.cookie=d.cookie}catch(a){}c.queue=[];for(var f=["Event","Exception","Metric","PageView","Trace","Dependency"];f.length;)b("track"+f.pop());if(b("setAuthenticatedUserContext"),b("clearAuthenticatedUserContext"),b("startTrackEvent"),b("stopTrackEvent"),b("startTrackPage"),b("stopTrackPage"),b("flush"),!a.disableExceptionTracking){f="onerror",b("_"+f);var g=e[f];e[f]=function(a,b,d,e,h){var i=g&&g(a,b,d,e,h);return!0!==i&&c["_"+f](a,b,d,e,h),i}}return c
  }({
      instrumentationKey:"<your instrumentation key>"
  });

window.appInsights=appInsights,appInsights.queue&&0===appInsights.queue.length&&appInsights.trackPageView();
</script>

Para más información, visite el repositorio de GitHub para nuestro SDK para JavaScript de código abierto.To learn more, visit the GitHub repository for our open-source JavaScript SDK.

Limpieza de recursosClean up resources

Cuando haya realizado las pruebas, puede eliminar el grupo de recursos y todos los recursos relacionados.When you are done testing, you can delete the resource group and all related resources. Para ello, siga estos pasos.To do so follow the steps below.

  1. En el menú izquierdo de Azure Portal, haga clic en Grupos de recursos y en myResourceGroup.From the left-hand menu in the Azure portal, click Resource groups and then click myResourceGroup.
  2. En la página del grupo de recursos, haga clic en Eliminar , escriba myResourceGroup en el cuadro de texto y haga clic en Eliminar.On your resource group page, click Delete , type myResourceGroup in the text box, and then click Delete.

Pasos siguientesNext steps

En este inicio rápido, ha habilitado la aplicación para que Azure Application Insights la supervise.In this quickstart, you’ve enabled your application for monitoring by Azure Application Insights. Continúe con las guías de inicio rápido para aprender a usarlo para supervisar las estadísticas y detectar problemas en la aplicación.Continue to the tutorials to learn how to use it to monitor statistics and detect issues in your application.