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.

Requisitos previos

• Visual Studio con la carga de trabajo de Azure instalada
• Un proyecto de uno de los tipos admitidos
• Una cuenta de Azure. Si no tiene una cuenta de Azure, active las ventajas de Azure para suscriptores de Visual Studio o regístrese para obtener una evaluación gratuita.

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.

   

   Si no ve el nodo Servicios conectados, elija Proyecto>Servicios conectados>Agregar.

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.

   

   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.

   

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.

      

   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 para la configuración de conexión y un nombre de clave de instrumentación o acepte los valores predeterminados.

   

   Nota:

   Para mejorar la seguridad, en Visual Studio 17.12 y versiones posteriores, este paso crea un nombre de configuración de conexión; las versiones anteriores crean un cadena de conexión. Las cadenas de conexión almacenadas en el sistema de archivos local pueden provocar un riesgo de seguridad, si se exponen accidentalmente.

7. Haga clic en Configuración adicional y elija si desea que el cadena de conexión se almacene en un archivo de secretos local o en Azure Key Vault.

   

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.

   

9. 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:

   

   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.

10. 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.

Contenido relacionado

• Página del producto Azure Monitor
• Documentación de Azure Application Insights