Azure App Service .NET uygulamaları için Snapshot Debugger etkinleştirme

Makale
05/13/2021
Okumak için 2 dakika

Snapshot Debugger Şu anda Windows hizmet planları üzerinde Azure App Service çalışan ASP.NET ve ASP.NET Core uygulamalarını desteklemektedir.

Anlık görüntü hata ayıklayıcısı kullanırken uygulamanızı temel hizmet katmanında veya daha yüksek bir sürüme çalıştırmanızı öneririz.

Çoğu uygulama için, ücretsiz ve paylaşılan hizmet katmanlarında anlık görüntüleri kaydetmek için yeterli bellek veya disk alanı yoktur.

Snapshot Debugger etkinleştir

Bir uygulama için Snapshot Debugger etkinleştirmek üzere aşağıdaki yönergeleri izleyin.

Farklı bir Azure hizmeti türü çalıştırıyorsanız, desteklenen diğer platformlarda Snapshot Debugger etkinleştirme talimatları aşağıda verilmiştir:

Not

.NET Core 'un önizleme sürümünü kullanıyorsanız veya uygulamanız Application Insights SDK 'ya bir bağımlı derleme aracılığıyla doğrudan veya dolaylı olarak başvuruyorsa, diğer ortamların Microsoft. ApplicationInsights. SnapshotCollector NuGet paketini uygulamayla birlikte içermesini sağlamak Için Snapshot Debugger etkinleştirme yönergelerini izleyin ve ardından aşağıdaki yönergeleri tamamlayın.

Application Insights Snapshot Debugger birlikte yükleme, .NET Core destek ilkesini izler. Desteklenen çalışma zamanları hakkında daha fazla bilgi için bkz. .NET Core destek ilkesi.

Snapshot Debugger, App Services çalışma zamanının bir parçası olarak önceden yüklenir, ancak App Service uygulamanız için anlık görüntüler almak üzere açmanız gerekir.

Bir uygulamayı dağıttıktan sonra, anlık görüntü hata ayıklayıcısını etkinleştirmek için aşağıdaki adımları izleyin:

App Service için Azure Denetim Masası ' na gidin.
Ayarlar > Application Insights sayfasına gidin.
Uygulamanızı izlemek üzere yeni bir kaynak oluşturmak veya var olan bir Application Insights kaynağını seçmek için sayfadaki yönergeleri izleyin. Ayrıca Snapshot Debugger için her iki anahtar de bulunduğundan emin olun.
Snapshot Debugger artık bir App Services uygulama ayarı kullanılarak etkinleştirildi.

Diğer bulutlar için Snapshot Debugger etkinleştir

Şu anda yalnızca uç nokta değişiklikleri gerektiren bölgeler Azure Kamu ve Azure Çin Application Insights bağlantı dizesi aracılığıyla yapılır.

Bağlantı dizesi özelliği	ABD kamu bulutu	Çin bulutu
Anlık görüntü Tendpoint	`https://snapshot.monitor.azure.us`	`https://snapshot.monitor.azure.cn`

Diğer bağlantı geçersiz kılmaları hakkında daha fazla bilgi için bkz. Application Insights belgeleri.

Snapshot Debugger devre dışı bırak

Etkinleştirme Snapshot Debugger ile aynı adımları izleyin, ancak her iki anahtarı da Snapshot Debugger için kapalı olarak değiştirin.

Uygulama özel durumlarının tanılamayı kolaylaştırmak için tüm uygulamalarınızda Snapshot Debugger etkinleştirilmiş olması önerilir.

Azure Resource Manager şablonu

Azure App Service için, Azure Resource Manager şablonu içinde uygulama ayarlarını Snapshot Debugger ve profil oluşturucuyu etkinleştirmek üzere ayarlayabilirsiniz ve aşağıdaki şablon kod parçacığına bakın:

{
  "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"
      }
    }
  ]
},

Sonraki adımlar

Uygulamanıza bir özel durum tetikleyebilmesi için trafik oluşturun. Ardından, anlık görüntülerin Application Insights örneğine gönderilmesi için 10 ila 15 dakika bekleyin.
Azure portal anlık görüntüleri görüntüleyin.
Sorunları giderme Snapshot Debugger konusunda yardım için bkz. Snapshot Debugger sorun giderme.