Habilitación de Snapshot Debugger para aplicaciones de .NET en Azure App Service

Nota:

Si usa una versión preliminar de .NET Core o su aplicación hace referencia a un SDK de Application Insights (ya sea directa o indirectamente a través de un ensamblado dependiente), siga las instrucciones que se indican en Habilitar Snapshot Debugger para otros entornos para incluir el paquete NuGet Microsoft.ApplicationInsights.SnapshotCollector con la aplicación.

Actualmente, Snapshot Debugger admite aplicaciones ASP.NET y ASP.NET Core que se ejecutan en Azure App Service en planes de servicio de Windows.

Se recomienda ejecutar la aplicación en los niveles de servicio Básico o superior al usar Snapshot Debugger. Para la mayoría de las aplicaciones:

• Los niveles de servicio Gratuito y Compartido no tienen suficiente memoria ni espacio en disco para guardar las instantáneas.
• El nivel de Consumo no está disponible actualmente en Snapshot Debugger.

Aunque Snapshot Debugger se instaló previamente como parte del entorno de ejecución de App Services, es necesario activarlo si quiere obtener instantáneas para la aplicación de App Service. La instalación sin código de Snapshot Debugger sigue la directiva de compatibilidad de .NET Core.

Azure Portal

Puede habilitar Snapshot Debugger en Azure Portal después de implementar la aplicación web de .NET App Services.

1. Vaya a la aplicación web de App Services en Azure Portal.

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

   

3. Haga clic en Activar Application Insights.

   • Si tiene un recurso de Application Insights existente que prefiere usar, seleccione esa opción en Cambiar el recurso.

4. En Instrumentar la aplicación, seleccione la pestaña de .NET.

5. Cambie ambos conmutadores de Snapshot Debugger a Activado.

   

6. Snapshot Debugger ahora está habilitado.

Deshabilitación de Snapshot Debugger

Para deshabilitar Snapshot Debugger para el recurso de App Services:

1. Navegue a su App Service en el portal de Azure.

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

3. Cambie el conmutador Snapshot Debugger a Desactivado.

Azure Resource Manager

También puede habilitar Snapshot Debugger y .NET Profiler mediante la configuración de la aplicación en la plantilla de Azure Resource Manager. Por ejemplo:

{
  "apiVersion": "2023-12-01",
  "name": "[parameters('webSiteName')]",
  "type": "Microsoft.Web/sites",
  "location": "[resourceGroup().location]",
  "dependsOn": [
    "[variables('hostingPlanName')]"
  ],
  "tags": { 
    "[concat('hidden-related:', resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName')))]": "empty",
    "displayName": "Website"
  },
  "properties": {
    "name": "[parameters('webSiteName')]",
    "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName'))]"
  },
  "resources": [
    {
      "apiVersion": "2015-08-01",
      "name": "appsettings",
      "type": "config",
      "dependsOn": [
        "[parameters('webSiteName')]",
        "[concat('AppInsights', parameters('webSiteName'))]"
      ],
      "properties": {
        "APPINSIGHTS_INSTRUMENTATIONKEY": "[reference(resourceId('Microsoft.Insights/components', concat('AppInsights', parameters('webSiteName'))), '2014-04-01').InstrumentationKey]",
        // "Turn on" a Snapshot Debugger version
        "APPINSIGHTS_SNAPSHOTFEATURE_VERSION": "1.0.0",
        "DiagnosticServices_EXTENSION_VERSION": "~3",
        "ApplicationInsightsAgent_EXTENSION_VERSION": "~2"
      }
    }
  ]
},

Genere tráfico para la aplicación que pueda desencadenar una excepción. A continuación, espere de 10 a 15 minutos para que se empiecen a enviar instantáneas a la instancia de Application Insights.

Habilitación de Snapshot Debugger para otras regiones en la nube

Actualmente las únicas regiones que requieren modificaciones de puntos de conexión son Azure Government y Microsoft Azure operado por 21Vianet a través de la Application Insights Connection String.

Propiedad de cadena de conexión	Nube del Gobierno de EE. UU.	Nube de China
SnapshotEndpoint	https://snapshot.monitor.azure.us	https://snapshot.monitor.azure.cn

Para obtener más información sobre otras anulaciones de conexión, consulte la documentación de Application Insights.

Configuración de Snapshot Debugger

Habilitar la autenticación de Microsoft Entra para la incorporación de instantáneas

Nota:

Actualmente, Snapshot Debugger 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.

Snapshot Debugger admite la autenticación de Microsoft Entra para la ingesta de instantáneas. Para que se ingieran todas las instantáneas de su aplicación, es necesario que esta esté autenticada y proporcione la configuración de aplicación requerida al agente de Snapshot Debugger.

1. Agregue la identidad administrada que se autentica frente al recurso de Application Insights a su servicio de aplicaciones. Puede crear cualquiera de las siguientes opciones:

   • Una identidad administrada asignada por el sistema.
   • Una identidad administrada asignada por el usuario.

2. En el portal, Configure y active Microsoft Entra ID en el recurso de Application Insights.

3. Agregue la siguiente configuración de la aplicación. Esta configuración indica al agente de Snapshot Debugger qué identidad administrada debe usar:

   Para la identidad asignada por el sistema:

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

   Para la identidad asignada por el usuario:

   Configuración de aplicación	Value
   APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD;ClientID={id. de cliente de la identidad asignada por el usuario}

Escenarios no admitidos

Los siguientes escenarios muestran dónde no se admite Snapshot Collector.

Escenario	Efectos secundarios	Recomendación
Está usando el SDK de Snapshot Collector directamente en su aplicación (.csproj) y ha habilitado la opción avanzada Interop.	El SDK local de Application Insights (incluida la telemetría de Snapshot Collector) se ha perdido y, por lo tanto, no hay instantáneas disponibles. La aplicación podría bloquearse al inicio con System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor. Más información sobre la característica Interop de Application Insights.	Si usa la opción avanzada interoperabilidad, use la inserción del Snapshot Collector sin código (habilitada a través de Azure Portal).

Pasos siguientes

• Vea las instantáneas en Azure Portal.
• Solucionar problemas de Snapshot Debugger.