Compartir a través de


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

Conexión a Azure Application Insights mediante servicios conectados

  1. Abra el proyecto en Visual Studio.

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

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

    Captura de pantalla que muestra la pantalla

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

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

    Captura de pantalla que muestra la pantalla

    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 .

  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 nuevo componente, vaya al paso siguiente. De lo contrario, vaya al paso 7.

    Captura de pantalla que muestra la pantalla

  6. Para crear un componente de Application Insights:

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

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

      Captura de pantalla que muestra la pantalla

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

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

    Captura de pantalla que muestra la pantalla

  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.

    Captura de pantalla que muestra la pantalla

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

    Captura de pantalla que muestra la pantalla

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.

  1. Abra el proyecto en Visual Studio.

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

    Captura de pantalla que muestra las opciones del menú contextual servicios conectados.

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

    Captura de pantalla que muestra las opciones de Application Insights.

    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 .

  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 nuevo componente, vaya al paso siguiente. De lo contrario, vaya al paso 7.

    Captura de pantalla que muestra la pantalla

  5. Para crear un componente de Application Insights:

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

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

      Captura de pantalla que muestra la pantalla

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

  6. Escriba un nombre para la configuración de conexión y un nombre de clave de instrumentación o acepte los valores predeterminados.

    Captura de pantalla que muestra la pantalla

    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.

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

    Captura de pantalla que muestra la pantalla Conectar a Application Insights: configuración adicional.

  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.

    Captura de pantalla que muestra la pantalla

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

    Captura de pantalla que muestra la sección

    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.

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