Adición de Application Insights con servicios conectados de Visual Studio

Con Visual Studio, puede conectar diferentes tipos de servicios y aplicaciones a Application Insights mediante la característica Servicios conectados . La funcionalidad agrega todas las referencias necesarias y el código de conexión al proyecto y modifica los archivos de configuración correctamente. Puede optar por conectarse al servicio de Application Insights activo que se ejecuta en Azure o usar un emulador local.

En este artículo se describe cómo conectar Application Insights a la aplicación mediante servicios conectados.

Prerrequisitos

Para completar los procedimientos de este artículo, se deben cumplir los siguientes requisitos previos:

• Visual Studio con la carga de trabajo de Azure instalada. Descargue Visual Studio ahora.

• Un proyecto que implementa un tipo de conexión admitido en Application Insights, por ejemplo:

  • Aplicación de consola de .NET Framework
  • modelo ASP.NET:View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (incluida la aplicación de consola, WPF, Windows Forms, biblioteca de clases)
  • Funciones de Azure
  • Aplicación de la Plataforma universal de Windows

• 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 Application Insights con servicios conectados

Para agregar Application Insights como servicio conectado a la aplicación, siga estos pasos:

1. Abra un proyecto en Visual Studio que admita una conexión con Application Insights. Para ver ejemplos de proyectos, consulte Requisitos previos.

   Nota

   En el caso de los proyectos de .NET Framework, la interfaz de usuario de servicios conectados de Visual Studio es diferente en todas las versiones. Para ver las diferencias, compare la vista actual de esta página con la versión de Visual Studio 2019 de la misma página.

2. Agregue el servicio conectado de Application Insights. Hay varias maneras de iniciar el proceso, por ejemplo:

   • Seleccione ProjectConnected ServicesAgregarAzure Application Insights.

   • Seleccione Project>Application Insights>Configurar Application Insights.

   • En el Explorador de soluciones, haga clic con el botón derecho en el nodo Servicios conectados del proyecto y seleccione Agregar>Azure Application Insights.

3. Se abre la pantalla Conectar a la dependencia. Tiene dos opciones para la conexión: use un emulador local o acceda al servicio activo en Azure. Para reducir el costo y simplificar el desarrollo anticipado, puede empezar con el emulador local. Más adelante, puede migrar al servicio activo repitiendo los pasos descritos en este procedimiento. Seleccione su preferencia de conexión y agregue la conexión siguiendo los pasos indicados.

   Tipo de conexión	Descripción	Procedimiento de conexión
   SDK de Application Insights (local)	Use un emulador local en lugar de conectarse a una instancia que se ejecuta en Azure.	Seleccione la opción y, a continuación, seleccione Siguiente. Continúe con el paso 6 y revise el resumen de los cambios planeados.
   Azure Application Insights	Conéctese al servicio de Application Insights activo que se ejecuta en Azure.	Según sea necesario, inicie sesión en su cuenta de Azure. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita de . Continúe con el paso siguiente de este procedimiento.

   

4. En la pantalla Conectar a Azure Application Insights - Seleccione una dependencia de servicio , elija si desea usar un componente existente o nuevo para la conexión:

   

   • Componente existente: para usar un componente de Application Insights existente, seleccione el componente de la lista y seleccione Siguiente. Continúe con el paso 5 y configure las opciones de conexión.

   • Nuevo componente: para crear un nuevo componente para la conexión:

     1. Seleccione + Crear nuevo.

     2. En la pantalla Application Insights: Crear nuevo , confirme los valores del campo, ajuste según sea necesario y, a continuación, seleccione Crear.

        

     3. La pantalla Conectar a Azure Application Insights - Seleccionar una dependencia de servicio se actualiza y el nuevo componente aparece en la lista. Seleccione el nuevo componente y seleccione Siguiente.

     4. En la pantalla Conectarse a Azure Application Insights - Proporcione opciones de configuración de conexión , compruebe la configuración de conexión. Acepte los valores predeterminados o escriba el nombre de configuración de conexión y la clave de instrumentación preferidos.

        

     Nota

     Para mejorar la seguridad, en Visual Studio 2022 17.12 y versiones posteriores, Visual Studio crea solo un nombre para la configuración de conexión. En versiones anteriores, Visual Studio crea la 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.

5. En la pantalla Proporcionar opciones de configuración de conexión , seleccione Configuración adicional en la parte inferior izquierda.

   La pantalla Conectarse a Azure Application Insights - Personalizar cómo se almacena la información de conexión se abre. Elija si desea almacenar la cadena de conexión en un archivo de secretos local y seleccione Siguiente:

   

6. En la pantalla Resumen de cambios se muestran las modificaciones planeadas para el proyecto.

   • Para una conexión de Azure Application Insights , los cambios incluyen actualizaciones del código y las propiedades del proyecto, referencias de paquetes NuGet, secretos de aplicación y el archivo appsettings.json .

   • Para una conexión del SDK de Application Insights (local), los cambios del proyecto incluyen una referencia de paquete NuGet agregada y un código de conexión para el emulador local.

   

   Compruebe los cambios del proyecto y seleccione Finalizar para completar el proceso.

   Se muestra un mensaje que indica una conexión correcta. Seleccione Cerrar para cerrar la ventana.

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

   

   • Para ver las acciones disponibles para una dependencia, seleccione Más opciones (...) para el elemento. Cuando la dependencia no está conectada, verá la opción Conectar . Cuando puede seleccionar esta opción, la pantalla Conectar a dependencia se vuelve a abrir, donde puede cambiar la configuración de dependencia y restablecer la conexión.

   • También puede seleccionar Más opciones (...) en la parte superior de la pestaña Servicios conectados para opciones para iniciar dependencias locales, cambiar la configuración y mucho más.

8. En el Explorador de soluciones, busque y abra el archivo Program.cs que contiene el código de inicio del proyecto. Observe la siguiente declaración, que se agrega para apoyar la conexión de dependencia.

   // Add services to the container
   builder.Services.AddApplicationInsightsTelemetry();
   

Contenido relacionado

• Habilitación de la supervisión de la aplicación con Application Insights para aplicaciones de ASP.NET Core
• Configuración de Application Insights para un sitio web de ASP.NET
• Más información sobre Application Insights en Azure Monitor