Share via

Azure Uygulaması Hizmeti'nde .NET uygulamaları için Snapshot Debugger'i etkinleştirme

  • Makale

Snapshot Debugger şu anda Windows hizmet planlarında Azure Uygulaması Hizmetinde çalışan ASP.NET ve ASP.NET Core uygulamalarını desteklemektedir.

Dekont

Snapshot Debugger kullanırken uygulamanızı Temel hizmet katmanında veya daha yüksek bir katmanda ç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. Tüketim katmanı şu anda Snapshot Debugger için kullanılamıyor.

Anlık Görüntü Hata Ayıklayıcısını Etkinleştirme

Snapshot Debugger, App Services çalışma zamanının bir parçası olarak önceden yüklenmiştir, ancak App Service uygulamanızın anlık görüntülerini almak için bu özelliği açmanız gerekir. Bir uygulamada Snapshot Debugger'ı etkinleştirmek için aşağıdaki yönergeleri izleyin:

Dekont

.NET Core'un önizleme sürümünü kullanıyorsanız veya uygulamanız Application Analizler SDK'sına başvurursa (bağımlı bir derleme aracılığıyla doğrudan veya dolaylı olarak), NuGet paketini uygulamaya dahil Microsoft.ApplicationInsights.SnapshotCollector etmek için diğer ortamlar için Snapshot Debugger'ı etkinleştirme yönergelerini izleyin.

Dekont

Application Analizler Snapshot Debugger'ın kodsuz yüklemesi .NET Core destek ilkesini izler. Desteklenen çalışma zamanları hakkında daha fazla bilgi için bkz . .NET Core Destek İlkesi.

.NET uygulamanızı dağıttıktan sonra:

  1. App Service'iniz için Azure denetim masasına gidin.

  2. Ayarlar> Uygulama Analizler sayfasına gidin.

    Screenshot showing the Enable App Insights on App Services portal.

  3. Yeni bir kaynak oluşturmak için sayfadaki yönergeleri izleyin veya uygulamanızı izlemek için mevcut bir Uygulama Analizler kaynağı seçin.

  4. Anlık Görüntü Hata Ayıklayıcısı'na geç ayarı Açık olarak değiştirilir.

    Screenshot showing how to add App Insights site extension.

  5. Anlık Görüntü Hata Ayıklayıcısı artık bir App Services Uygulama Ayarı kullanılarak etkinleştirilmiştir.

    Screenshot showing App Setting for Snapshot Debugger.

Farklı türde bir Azure hizmeti çalıştırıyorsanız, desteklenen diğer platformlarda Snapshot Debugger'ı etkinleştirme yönergeleri aşağıdadır:

Diğer bulutlar için Snapshot Debugger'i etkinleştirme

Şu anda uç nokta değişiklikleri gerektiren tek bölgeler Azure Kamu ve 21Vianet tarafından Application Analizler Bağlan ion String aracılığıyla sağlanan Microsoft Azure'dır.

Bağlan ion Dizesi Özelliği ABD Kamu Bulutu Çin Bulutu
SnapshotEndpoint 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. Uygulama Analizler belgeleri.

Anlık görüntü alımı için Microsoft Entra kimlik doğrulamasını etkinleştirme

Uygulama Analizler Snapshot Debugger, anlık görüntü alımı için Microsoft Entra kimlik doğrulamasını destekler. Bu, uygulamanızın tüm anlık görüntülerinin alınması için uygulamanızın kimliğinin doğrulanması ve Snapshot Debugger aracısına gerekli uygulama ayarlarını sağlaması gerektiği anlamına gelir.

Bugün itibarıyla Snapshot Debugger yalnızca uygulamanızdaki Application Analizler SDK'sını kullanarak Microsoft Entra Id'ye başvurup yapılandırdığınızda Microsoft Entra kimlik doğrulamasını destekler.

Anlık görüntü alımı için Microsoft Entra Id'yi açmak için:

  1. Uygulama Analizler kaynağınızda kimlik doğrulaması yapmak için kullanmak istediğiniz yönetilen kimliği oluşturun ve App Service'inize ekleyin.

    1. Sistem Tarafından Atanan Yönetilen kimlik için aşağıdaki belgelere bakın.

    2. Kullanıcı Tarafından Atanan Yönetilen kimlik için aşağıdaki belgelere bakın.

  2. Uygulama Analizler kaynağınızda Microsoft Entra Id'yi yapılandırın ve açın. Daha fazla bilgi için aşağıdaki belgelere bakın

  3. Snapshot Debugger aracısına hangi yönetilen kimliğin kullanılacağını bildirmek için kullanılan aşağıdaki uygulama ayarını ekleyin:

Sistem Tarafından Atanan Kimlik için:

Uygulama Ayarı Değer
APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AD

Kullanıcı Tarafından Atanan Kimlik için:

Uygulama Ayarı Değer
APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AD; ClientID={Kullanıcı Tarafından Atanan Kimliğin İstemci Kimliği}

Anlık Görüntü Hata Ayıklayıcısını Devre Dışı Bırak

Snapshot Debugger'ı devre dışı bırakmak için etkinleştirme adımlarını yineleyin. Ancak Anlık Görüntü Hata Ayıklayıcısı'nı Kapalı olarak değiştirin.

Azure Resource Manager şablonu

Azure Uygulaması Hizmeti için Azure Resource Manager şablonunda uygulama ayarlarını ayarlayarak Snapshot Debugger ve Profiler'ı etkinleştirebilirsiniz. Örnek:

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

Desteklenmeyen Senaryolar

Anlık Görüntü Toplayıcı'nın desteklenmediği senaryoları aşağıda bulabilirsiniz:

Senaryo Yan Etkiler Öneri
Anlık Görüntü Toplayıcı SDK'sını uygulamanızda doğrudan (.csproj) kullanıyorsunuz ve gelişmiş "Birlikte Çalışma" seçeneğini etkinleştirdiniz. Yerel Uygulama Analizler SDK'sı (Anlık Görüntü Toplayıcı telemetrisi dahil) kaybolur ve anlık görüntü kullanılamaz.
Uygulamanız başlangıçta ile kilitlenebilir System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor.
Uygulama Analizler özelliği "Birlikte Çalışma" hakkında daha fazla bilgi edinin.		 Gelişmiş "Birlikte Çalışma" seçeneğini kullanıyorsanız kodsuz Anlık Görüntü Toplayıcı ekleme özelliğini kullanın (Azure portalı aracılığıyla etkinleştirilir).

Sonraki adımlar