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

Artículo
05/13/2021
Tiempo de lectura: 2 minutos

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

Habilitación de Snapshot Debugger

Para habilitar Snapshot Debugger en una aplicación, siga las instrucciones que se indican a continuación.

Si está ejecutando otro tipo de servicio de Azure, aquí encontrará instrucciones para habilitar Snapshot Debugger en otras plataformas compatibles:

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 y, luego, complete el resto de las instrucciones siguientes.

La instalación sin código de Application Insights Snapshot Debugger sigue la directiva de compatibilidad de .NET Core. Para más información sobre los entornos de ejecución admitidos, consulte Directiva de compatibilidad de .NET Core.

Snapshot Debugger se instaló previamente como parte del entorno de ejecución de App Services, pero es necesario activarlo si quiere obtener instantáneas para la aplicación de App Service.

Una vez que haya implementado una aplicación, siga los pasos que se indican a continuación para habilitar Snapshot Debugger:

Vaya al panel de control de Azure y busque la instancia de App Service.
Vaya a la página Configuración > Application Insights.
Siga las instrucciones que aparecen en la página para crear un nuevo recurso o seleccione un recurso de App Insights existente para supervisar la aplicación. También asegúrese de que los dos modificadores de Snapshot Debugger están activados.
Snapshot Debugger está habilitado con una configuración de aplicación de App Services.

Habilitación de Snapshot Debugger para otras nubes

Actualmente, las únicas regiones que requieren modificaciones de punto de conexión son Azure Government y Azure China, mediante la cadena de conexión de Application Insights.

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 otras invalidaciones de conexión, consulte la documentación de Application Insights.

Deshabilitación de Snapshot Debugger

Siga los mismos pasos que para Habilitación de Snapshot Debugger, pero cambie los dos modificadores de Snapshot Debugger al modo desactivado.

Recomendamos que tenga habilitado Snapshot Debugger en todas las aplicaciones para facilitar el diagnóstico de las excepciones de la aplicación.

Plantilla del Administrador de recursos de Azure

En el caso de una instancia de Azure App Service, puede establecer la configuración de la aplicación en la plantilla de Azure Resource Manager para habilitar Snapshot Debugger y Profiler. Para ello, consulte el fragmento de código de plantilla siguiente:

{
  "apiVersion": "2015-08-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]",
        "APPINSIGHTS_PROFILERFEATURE_VERSION": "1.0.0",
        "APPINSIGHTS_SNAPSHOTFEATURE_VERSION": "1.0.0",
        "DiagnosticServices_EXTENSION_VERSION": "~3",
        "ApplicationInsightsAgent_EXTENSION_VERSION": "~2"
      }
    }
  ]
},

Pasos siguientes

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.
Vea las instantáneas en Azure Portal.
Por ayuda para solucionar problemas de Snapshot Debugger, consulte la sección Solución de problemas de Snapshot Debugger.