Compartir a través de


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:

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.

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

    • Seleccione ProjectAdministrar servicios conectados>Agregar una dependencia de servicio> de Azure 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. En la sección Servicios Conectados>Dependencias del Servicio, seleccione Agregar (símbolo más):

    Captura de pantalla que muestra la pantalla Agregar dependencia de servicio.

  4. Se abre la pantalla de "Agregar 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.

    Captura de pantalla que muestra la pantalla de Agregar Azure Application Insights.

    1. Para este ejercicio, seleccione Azure Application Insights para acceder al servicio activo en Azure.

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

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

    Captura de pantalla que muestra la pantalla del componente Conectar a Application Insights existente.

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

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

      Captura de pantalla que muestra la pantalla nuevo componente de Azure App Insights con resaltados para la lista de componentes existentes y la opción para crear un nuevo componente.

      1. Seleccione Crear un nuevo componente de Application Insights.

      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 Configurar Azure Application Insights - Seleccione una dependencia de servicio se actualiza y el nuevo componente aparece en la lista. Seleccione el nuevo componente y seleccione Siguiente.

  6. En la pantalla Configurar Azure Application Insights - Proporcione el nombre de la cadena de conexión, compruebe la configuración de conexión:

    Captura de pantalla que muestra la pantalla Proporcionar nombre de cadena de conexión.

    1. Acepte los valores de conexión predeterminados o escriba el nombre de la cadena de conexión y la clave de instrumentación preferidas.

    2. Elija si desea almacenar la cadena de conexión en un archivo de secretos local y seleccione Siguiente.

    Precaución

    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.

  7. En la pantalla Resumen de cambios se muestran las modificaciones planeadas para el proyecto. Los cambios incluyen actualizaciones del código y las propiedades del proyecto, las referencias de paquetes NuGet, los secretos de aplicación y el archivo appsettings.json .

    Captura de pantalla que muestra la pantalla Resumen de cambios para crear la conexión para la aplicación en versiones anteriores de Visual Studio.

    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.

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

    Captura de pantalla que muestra la nueva conexión que aparece en la sección Dependencias del servicio para el proyecto en versiones anteriores de Visual Studio.

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.
    1. Seleccione la opción y, a continuación, seleccione Siguiente.
    2. 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.
    1. 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 .
    2. Continúe con el paso siguiente de este procedimiento.

    Captura de pantalla que muestra las dos opciones para conectar la aplicación a Application Insights.

  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:

    Captura de pantalla que muestra la pantalla del componente Conectar a Azure Application Insights, donde se selecciona una dependencia de servicio para agregarla a la aplicació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.

        Captura de pantalla que muestra la pantalla Application Insights: Crear nuevo componente.

      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.

        Captura de pantalla que muestra la pantalla Conectarse a Azure Application Insights: proporcionar opciones de configuración de conexión.

      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:

    Captura de pantalla que muestra la pantalla Conectarse a Application Insights: personalizar cómo se almacena la información de conexión.

  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.

    Captura de pantalla que muestra la pantalla Resumen de cambios para crear la conexión para la aplicación.

    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 :

    Captura de pantalla que muestra la nueva conexión que aparece en la sección Dependencias del servicio del proyecto.

    • 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();