Adició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
- 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)
- Rol de trabajo de .NET Core
- Comprobación de
- Aplicación de la Plataforma universal de Windows
- Xamarin
- Córdoba
La funcionalidad del servicio conectado agrega todas las referencias necesarias y el código de conexión al proyecto y modifica los archivos de configuración correctamente.
Prerrequisitos
- 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
Abra el proyecto en Visual Studio.
En Explorador de Soluciones, haga clic con el botón derecho en el nodo Servicios conectados y, en el menú contextual, seleccione Agregar servicio conectado.
En la pestaña Servicios conectados, seleccione el icono + de Dependencias de servicio.
Si no ve el nodo Servicios conectados, elija Proyecto>Servicios conectados>Agregar.
En la página Agregar dependencia, seleccione Azure Application Insights.
Si aún no ha iniciado sesión, inicie sesión en su cuenta de Azure. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita de .
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 nuevo componente, vaya al paso siguiente. De lo contrario, vaya al paso 7.
Para crear un componente de Application Insights:
Seleccione Crear un nuevo componente de Application Insights en la parte inferior de la pantalla.
Rellene la pantalla Application Insights: Crear y seleccione Crear.
Cuando se muestra la pantalla Configurar Azure Application Insights, el nuevo componente aparece en la lista. Seleccione el nuevo componente de la lista y seleccione Siguiente.
Escriba un nombre de clave de instrumentación o elija el valor predeterminado y elija si desea la cadena de conexión almacenada en un archivo de secretos locales o en Azure Key Vault.
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.
La conexión aparece en la sección Dependencias de servicio de la pestaña Servicios conectados.
Conexión a Azure Application Insights mediante servicios conectados
Nota
En el caso de los proyectos de .NET Framework, la interfaz de usuario de servicios conectados es ligeramente diferente. Para ver las diferencias, compare con la versión Visual Studio 2019 de esta página.
Abra el proyecto en Visual Studio.
En 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.
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. Puede reducir el costo y simplificar el desarrollo anticipado empezando por el emulador local. Puede migrar al servicio activo más adelante repitiendo estos pasos y eligiendo la otra opción.
Si decide usar el SDK de Application Insights localmente, haga clic en Siguiente para ver la pantalla Resumen de cambios , que muestra 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 para el emulador local al proyecto.
Si desea conectarse al servicio de Azure, continúe con el paso siguiente o, si aún no ha iniciado sesión, inicie sesión en su cuenta de Azure antes de continuar. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita de .
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 nuevo componente, vaya al paso siguiente. De lo contrario, vaya al paso 7.
Para crear un componente de Application Insights:
Seleccione Crear un nuevo componente de Application Insights en la parte inferior de la pantalla.
Rellene la pantalla Application Insights: Crear y seleccione Crear.
Cuando se muestra la pantalla Configurar Azure Application Insights, el nuevo componente aparece en la lista. Seleccione el nuevo componente de la lista y seleccione Siguiente.
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 una 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.
Haga clic en Configuración adicionaly elija si desea la cadena de conexión almacenada en un archivo de secretos local o en Azure Key Vault.
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.
En el 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 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 las dependencias locales, cambiar la configuración y mucho más.
Abra el archivo de código de inicio (Program.cs en plantillas) 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, obtenga información sobre cómo habilitar la supervisión de la aplicación en Application Insights para aplicaciones ASP.NET Core.
Para proyectos de ASP.NET, vea Configurar Application Insights para su sitio web de ASP.NET.
Los vínculos le llevan a la sección de los artículos después de los pasos de configuración iniciales, que ya ha hecho.