Incorporación de Azure Application Insights mediante Servicios conectados de Visual Studio

Con Visual Studio, puede conectar cualquiera de lo siguiente a Azure Application Insights mediante la característica Servicios conectados:

  • Aplicación de consola de .NET Framework
  • Model-View-Controller (Modelo-Vista-Controlador) ASP.NET (MVC) (Esquema de trabajo .NET)
  • ASP.NET Core
  • .NET Core (incluida la aplicación de consola, WPF, Windows Forms y la biblioteca de clases)
  • Rol de trabajo de .NET Core
  • Azure Functions
  • Aplicación de la Plataforma universal de Windows
  • Xamarin
  • Cordova

La funcionalidad del servicio conectado agrega todo el código de conexión y las referencias necesarios al proyecto y modifica los archivos de configuración de forma adecuada.

Nota

Este tema se aplica a Visual Studio para Windows. En Visual Studio para Mac, vea Servicios conectados en Visual Studio para Mac.

Requisitos previos

Conexión a Azure Application Insights mediante Servicios conectados

  1. Abra el proyecto en Visual Studio.

  2. En el Explorador de soluciones, haga clic con el botón derecho en el nodo Servicios conectados y, en el menú contextual, seleccione Agregar servicio conectado.

  3. En la pestaña Servicios conectados, seleccione el icono + de Dependencias de servicio.

    Screenshot showing

  4. En la página Agregar dependencia, seleccione Azure Application Insights.

    Screenshot showing

    Si aún no ha iniciado sesión en su cuenta de Azure, hágalo ahora. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita.

  5. En la pantalla Configure Azure Application Insights (Configurar Azure Application Insights), elija un componente de Azure Application Insights y seleccione Siguiente.

    Si necesita crear un componente, vaya al siguiente paso. De lo contrario, vaya al paso 7.

    Screenshot showing

  6. Para crear un componente de Application Insights:

    1. Seleccione Crear un componente de Application Insights en la parte inferior de la pantalla.

    2. Rellene la pantalla Application Insights: Crear y seleccione Crear.

      Screenshot showing

    3. Cuando se muestre la pantalla Configure Azure Application Insights (Configurar Azure Application Insights), el nuevo componente aparecerá en la lista. Elija el nuevo componente en la lista y seleccione Siguiente.

  7. Escriba un nombre de clave de instrumentación (o elija el valor predeterminado) y seleccione si quiere la cadena de conexión almacenada en un archivo de secretos local o en Azure Key Vault.

    Screenshot showing

  8. En la pantalla Resumen de cambios se muestran todas las modificaciones que se realizarán en el proyecto si completa el proceso. Si los cambios parecen correctos, seleccione Finalizar.

    Screenshot showing

  9. La conexión aparece en la sección Dependencias de servicio de la pestaña Servicios conectados.

    Screenshot showing

Conexión a Azure Application Insights mediante Servicios conectados

Nota:

Para los proyectos de .NET Framework, la interfaz de usuario de Servicios conectados es ligeramente diferente. Para ver las diferencias, compare esta información con la versión de esta página para Visual Studio 2019.

  1. Abra el proyecto en Visual Studio.

  2. En el Explorador de soluciones, haga clic con el botón derecho en el nodo Servicios conectados y, en el menú contextual, seleccione Agregar para abrir el menú de servicios disponibles.

    Screenshot showing Connected Services context menu options.

  3. Elija Azure Application Insights. Aparece la página Conectarse a la dependencia. Debería ver dos opciones, una para un emulador local, el SDK de Application Insights (local) y otra para conectarse al servicio Azure Application Insights en directo. Si empieza por el emulador local, puede reducir el costo y simplificar los primeros pasos del desarrollo. Si desea migrar al servicio en directo más adelante, repita estos pasos y seleccione la otra opción.

    Screenshot showing Application Insights choices.

    Si decide usar el SDK de Application Insights de forma local, haga clic en Siguiente para ver la pantalla Resumen de cambios, en la que figura cómo se está modificando el proyecto. Se agrega una referencia de paquete NuGet al proyecto y se agrega el código de conexión del emulador local al proyecto.

    Si quiere conectarse al servicio de Azure, siga con el paso siguiente o, si aún no ha iniciado sesión, acceda a su cuenta de Azure antes de continuar. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita.

  4. En la pantalla Configure Azure Application Insights (Configurar Azure Application Insights), elija un componente de Azure Application Insights y seleccione Siguiente.

    Si necesita crear un componente, vaya al siguiente paso. De lo contrario, vaya al paso 7.

    Screenshot showing

  5. Para crear un componente de Application Insights:

    1. Seleccione Crear un componente de Application Insights en la parte inferior de la pantalla.

    2. Rellene la pantalla Application Insights: Crear y seleccione Crear.

      Screenshot showing

    3. Cuando se muestre la pantalla Configure Azure Application Insights (Configurar Azure Application Insights), el nuevo componente aparecerá en la lista. Elija el nuevo componente en la lista y seleccione Siguiente.

  6. Escriba un nombre de clave de instrumentación (o elija el valor predeterminado) y seleccione si quiere la cadena de conexión almacenada en un archivo de secretos local o en Azure Key Vault.

    Screenshot showing

  7. En la pantalla Resumen de cambios se muestran todas las modificaciones que se realizarán en el proyecto si completa el proceso. Si los cambios parecen correctos, seleccione Finalizar.

    Screenshot showing

  8. En Explorador de soluciones, haga doble clic en el nodo Servicios conectados para abrir la pestaña Servicios conectados. La conexión aparece en la sección Dependencias del servicio:

    Screenshot showing

    Si hace clic en los tres puntos que hay junto a la dependencia que agregó, puede ver varias opciones, como Conectar para volver a abrir el asistente y cambiar la conexión. También puede hacer clic en los tres puntos situados en la parte superior derecha de la ventana para ver las opciones para iniciar dependencias locales, cambiar la configuración, etc.

  9. Abra el archivo de código de inicio (Program.cs en Templates) y observe que se ha agregado una línea similar a la siguiente:

    builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
    

Pasos siguientes

Para proyectos de ASP.NET Core, vea cómo puede habilitar la supervisión de una aplicación en Application Insights para aplicaciones de ASP.NET Core.

Para proyectos de ASP.NET, consulte Configuración de Application Insights para un sitio web de ASP.NET.

Los vínculos le llevan a la sección de los artículos que viene después de los pasos de configuración iniciales, que ya ha realizado.