Habilitación de Profiler para .NET para aplicaciones de Azure App Service

  • Artículo

Application Insights Profiler para .NET viene preinstalado en el runtime de Azure App Service. Puede ejecutar Profiler en aplicaciones ASP.NET y ASP.NET Core que se ejecuten en App Service con el nivel de servicio Básico o uno superior.

Instalación sin código de Application Insights Profiler para .NET:

Para habilitar Profiler para .NET en Linux, vea las instrucciones de aplicaciones web de Azure en Linux de ASP.NET Core.

Requisitos previos

Comprobación de que la opción "Siempre activo" esté habilitada

  1. En Azure Portal, vaya a la instancia de App Service.

  2. En el menú de la izquierda, seleccione Configuración>Configuración.

    Captura de pantalla que muestra cómo seleccionar Configuración en el panel izquierdo.

  3. Seleccione la pestaña Configuración general.

  4. Compruebe que Siempre activo>Activado esté seleccionado.

    Nota:

    Si el control de alternancia Siempre activo está deshabilitado, actualice la aplicación web de App Service para que se ejecute en el nivel Básico o superior.

    Captura de pantalla que muestra la pestaña General en el panel Configuración donde se muestra que Siempre activo está habilitado.

  5. Seleccione Guardar si hizo cambios.

Habilitación de Application Insights y Profiler para .NET

Puede habilitar Profiler cuando:

Para Application Insights y App Service en la misma suscripción

Si el recurso de Application Insights está en la misma suscripción que la instancia de App Service:

  1. En el menú de la izquierda, seleccione Supervisión>Application Insights.

  2. En Application Insights, seleccione Habilitar.

  3. Compruebe que ha conectado un recurso de Application Insights a la aplicación.

    Captura de pantalla que muestra cómo habilitar Application Insights en la aplicación.

  4. Desplácese hacia abajo y seleccione la pestaña .NET o .NET Core, en función de la aplicación.

  5. Compruebe queNivel de colección>Recomendado está seleccionado.

  6. En Profiler, seleccione Activado.

    Si anteriormente ha seleccionado el nivel de colección Básico, la opción Profiler está deshabilitada.

  7. Seleccione Aplicar>Sí para confirmar.

    Captura de pantalla que muestra cómo habilitar Profiler en la aplicación.

Para Application Insights y App Service en distintas suscripciones

Si el recurso de Application Insights está en otra suscripción que no es la instancia de App Service, debe habilitar Profiler para .NET manualmente mediante la creación de la configuración de la aplicación para la instancia de App Service. Puede automatizar la creación de la configuración mediante una plantilla u otros medios. Esta es la configuración que necesita para habilitar Profiler.

Configuración de aplicación Value
APPINSIGHTS_INSTRUMENTATIONKEY iKey para el recurso de Application Insights
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Establezca estos valores mediante:

Habilitación de Profiler para .NET para nubes regionales

Actualmente, las únicas regiones que requieren modificaciones en el punto final son Azure Government y Microsoft Azure operado por 21Vianet.

Configuración de aplicación Nube del Gobierno de EE. UU. Nube de China
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Habilitación de la autenticación de Microsoft Entra para la ingesta de perfiles

Application Insights Profiler para .NET admite la autenticación de Microsoft Entra para la ingesta de perfiles. Para que se ingieran todos los perfiles de la aplicación, esta debe autenticarse y proporcionar la configuración de la aplicación necesaria para el agente de Profiler.

Profiler solo admite la autenticación de Microsoft Entra al hacer referencia y configurar Microsoft Entra ID mediante el SDK de Application Insights en la aplicación.

Para habilitar Microsoft Entra ID para la ingesta de perfiles:

  1. Cree y agregue la identidad administrada para autenticarse en el recurso de Application Insights en la instancia de App Service:

    1. Documentación de identidad administrada asignada por el sistema

    2. Documentación de identidad administrada asignada por el usuario

  2. Configure y habilite Microsoft Entra ID en el recurso de Application Insights.

  3. Agregue la siguiente configuración de la aplicación para que el agente de Profiler sepa qué identidad administrada usar.

    • Para la identidad asignada por el sistema:

      Configuración de aplicación Value
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    • Para la identidad asignada por el usuario:

      Configuración de aplicación Value
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Deshabilitación de Profiler para .NET

Para detener o reiniciar Profiler en una instancia de la aplicación individual:

  1. En Configuración en el panel izquierdo, seleccione WebJobs.

    Captura de pantalla que muestra cómo seleccionar trabajos web en el panel izquierdo.

  2. Seleccione la instancia de WebJob con el nombre ApplicationInsightsProfiler3.

  3. Seleccione Detener.

    Captura de pantalla que muestra cómo seleccionar detener para detener la instancia de webjob.

  4. Seleccione Sí para confirmar la acción.

Se recomienda tener habilitado el generador de perfiles en todas las aplicaciones para detectar cualquier problema de rendimiento lo antes posible.

Puede eliminar los archivos de Profiler al usar WebDeploy para implementar cambios en la aplicación web. Puede evitar la eliminación si se excluye la carpeta App_Data de la eliminación durante la implementación.

Pasos siguientes