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

Después de implementar la aplicación web de App Services de .NET:

1. Vaya a la aplicación de App Service 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. Vaya a la aplicación de App Service en Azure Portal.
2. En el menú de la izquierda, seleccione Configuración>Application Insights.
3. Cambie el conmutador Snapshot Debugger a Desactivado.

Azure Resource Manager

Puede establecer la configuración de la aplicación en la plantilla de Azure Resource Manager para habilitar Snapshot Debugger y Profiler. 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 más información sobre otros reemplazos de conexión, consulte la documentación de Application Insights.

Configuración de Snapshot Debugger

Habilitación de la autenticación de Microsoft Entra para la ingesta de instantáneas

Snapshot Debugger admite la autenticación de Microsoft Entra para la ingesta de instantáneas. Para que se ingieran todas las instantáneas de la aplicación, esta debe autenticarse y proporcionar la configuración de aplicación necesaria al agente Snapshot Debugger.

A partir de hoy, 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.

Para activar Microsoft Entra ID para la ingesta de instantáneas en el recurso de App Services:

1. Agregue la identidad administrada para autenticarse en el recurso de Application Insights en la instancia de App Service. Puede crear cualquiera de las siguientes opciones:

   • Agregar una identidad administrada asignada por el sistema.
   • Agregar una identidad administrada asignada por el usuario.

2. Configure y active Microsoft Entra ID en el recurso de Application Insights. Para más información, consulte la siguiente documentación.

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

A continuación puede encontrar los escenarios en los que Snapshot Collector no se admite:

Escenario	Efectos secundarios	Recomendación
Se usa el SDK de Snapshot Collector en la aplicación directamente (.csproj) y habilitado la opción avanzada "Interop".	Se pierde el SDK local de Application Insights (incluida la telemetría de Snapshot Collector) y 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 "Interop", use la inserción de 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.