Azure Service Fabric, bulut hizmeti ve sanal makinelerde .net uygulamaları için Snapshot Debugger etkinleştirme

ASP.NET veya ASP.NET çekirdek uygulamanız Azure App Service çalıştırıyorsa, Application Insights portalı sayfası aracılığıyla Snapshot Debugger etkinleştirmenizönemle önerilir. bununla birlikte, uygulamanız özelleştirilmiş bir Snapshot Debugger yapılandırması veya .net core 'un önizleme sürümünü gerektiriyorsa, bu yönergeyi Application Insights portalı sayfasında etkinleştirmeyeyönelik yönergelere ek olarak gelmelidir.

uygulamanız Azure Service Fabric, bulut hizmeti, sanal makineler veya şirket içi makinelerde çalışıyorsa, aşağıdaki yönergelerin kullanılması gerekir.

ASP.NET uygulamalar için anlık görüntü toplamayı yapılandırma

1. henüz yapmadıysanız web uygulamanızda Application Insights etkinleştirin.

2. uygulamanıza Microsoft. applicationınsights. snapshotcollector NuGet paketini ekleyin.

3. Gerekirse, ApplicationInsights.configeklenen Snapshot Debugger yapılandırma özelleştirildi. Varsayılan Snapshot Debugger yapılandırması çoğunlukla boştur ve tüm ayarlar isteğe bağlıdır. Varsayılan yapılandırmaya bir yapılandırma eşdeğerini gösteren bir örnek aşağıda verilmiştir:

   <TelemetryProcessors>
       <Add Type="Microsoft.ApplicationInsights.SnapshotCollector.SnapshotCollectorTelemetryProcessor, Microsoft.ApplicationInsights.SnapshotCollector">
       <!-- The default is true, but you can disable Snapshot Debugging by setting it to false -->
       <IsEnabled>true</IsEnabled>
       <!-- Snapshot Debugging is usually disabled in developer mode, but you can enable it by setting this to true. -->
       <!-- DeveloperMode is a property on the active TelemetryChannel. -->
       <IsEnabledInDeveloperMode>false</IsEnabledInDeveloperMode>
       <!-- How many times we need to see an exception before we ask for snapshots. -->
       <ThresholdForSnapshotting>1</ThresholdForSnapshotting>
       <!-- The maximum number of examples we create for a single problem. -->
       <MaximumSnapshotsRequired>3</MaximumSnapshotsRequired>
       <!-- The maximum number of problems that we can be tracking at any time. -->
       <MaximumCollectionPlanSize>50</MaximumCollectionPlanSize>
       <!-- How often we reconnect to the stamp. The default value is 15 minutes.-->
       <ReconnectInterval>00:15:00</ReconnectInterval>
       <!-- How often to reset problem counters. -->
       <ProblemCounterResetInterval>1.00:00:00</ProblemCounterResetInterval>
       <!-- The maximum number of snapshots allowed in ten minutes.The default value is 1. -->
       <SnapshotsPerTenMinutesLimit>3</SnapshotsPerTenMinutesLimit>
       <!-- The maximum number of snapshots allowed per day. -->
       <SnapshotsPerDayLimit>30</SnapshotsPerDayLimit>
       <!-- Whether or not to collect snapshot in low IO priority thread. The default value is true. -->
       <SnapshotInLowPriorityThread>true</SnapshotInLowPriorityThread>
       <!-- Agree to send anonymous data to Microsoft to make this product better. -->
       <ProvideAnonymousTelemetry>true</ProvideAnonymousTelemetry>
       <!-- The limit on the number of failed requests to request snapshots before the telemetry processor is disabled. -->
       <FailedRequestLimit>3</FailedRequestLimit>
       </Add>
   </TelemetryProcessors>
   

4. anlık görüntüler yalnızca Application Insights bildirilen özel durumlarla toplanır. Bazı durumlarda (örneğin, .NET platformunun daha eski sürümleri), portalda anlık görüntülerle özel durumları görmek için özel durum toplamayı yapılandırmanız gerekebilir.

ASP.NET Core 2,0 veya üstünü kullanarak uygulamalar için anlık görüntü toplamayı yapılandırma

1. henüz yapmadıysanız, ASP.NET Core web uygulamanızda Application Insights etkinleştirin.

   Not

   Uygulamanızın Microsoft. ApplicationInsights. AspNetCore paketinin sürüm 2.1.1 veya daha yeni bir sürüme başvurduğundan emin olun.

2. uygulamanıza Microsoft. applicationınsights. snapshotcollector NuGet paketini ekleyin.

3. StartupSnapshot Collector telemetri işlemcisini eklemek ve yapılandırmak için uygulamanızın sınıfını değiştirin.

   1. Microsoft. applicationınsights. snapshotcollector NuGet package version 1.3.5 veya üzeri kullanılıyorsa, aşağıdaki using deyimlerini öğesine ekleyin Startup.cs .

           using Microsoft.ApplicationInsights.SnapshotCollector;
      

      İçinde sınıfındaki ConfigureServices yönteminin sonuna aşağıdakileri ekleyin Startup Startup.cs .

           services.AddSnapshotCollector((configuration) => Configuration.Bind(nameof(SnapshotCollectorConfiguration), configuration));
      

   2. Microsoft. applicationınsights. snapshotcollector NuGet package version 1.3.4 veya below kullanılıyorsa, aşağıdaki using deyimlerini öğesine ekleyin Startup.cs .

      using Microsoft.ApplicationInsights.SnapshotCollector;
      using Microsoft.Extensions.Options;
      using Microsoft.ApplicationInsights.AspNetCore;
      using Microsoft.ApplicationInsights.Extensibility;
      

      Aşağıdaki SnapshotCollectorTelemetryProcessorFactory sınıfı Startup sınıfına ekleyin.

      class Startup
      {
          private class SnapshotCollectorTelemetryProcessorFactory : ITelemetryProcessorFactory
          {
              private readonly IServiceProvider _serviceProvider;
      
              public SnapshotCollectorTelemetryProcessorFactory(IServiceProvider serviceProvider) =>
                  _serviceProvider = serviceProvider;
      
              public ITelemetryProcessor Create(ITelemetryProcessor next)
              {
                  var snapshotConfigurationOptions = _serviceProvider.GetService<IOptions<SnapshotCollectorConfiguration>>();
                  return new SnapshotCollectorTelemetryProcessor(next, configuration: snapshotConfigurationOptions.Value);
              }
          }
          ...
      

      SnapshotCollectorConfiguration SnapshotCollectorTelemetryProcessorFactory Başlangıç ardışık düzenine ve hizmetlerini ekleyin:

         // This method gets called by the runtime. Use this method to add services to the container.
         public void ConfigureServices(IServiceCollection services)
         {
             // Configure SnapshotCollector from application settings
             services.Configure<SnapshotCollectorConfiguration>(Configuration.GetSection(nameof(SnapshotCollectorConfiguration)));
      
             // Add SnapshotCollector telemetry processor.
             services.AddSingleton<ITelemetryProcessorFactory>(sp => new SnapshotCollectorTelemetryProcessorFactory(sp));
      
             // TODO: Add other services your application needs here.
         }
      }
      

4. Gerekirse, appSettings. json ' a bir SnapshotCollectorConfiguration bölümü ekleyerek Snapshot Debugger yapılandırmasını özelleştirdiniz. Snapshot Debugger yapılandırmasındaki tüm ayarlar isteğe bağlıdır. Varsayılan yapılandırmaya bir yapılandırma eşdeğerini gösteren bir örnek aşağıda verilmiştir:

   {
     "SnapshotCollectorConfiguration": {
       "IsEnabledInDeveloperMode": false,
       "ThresholdForSnapshotting": 1,
       "MaximumSnapshotsRequired": 3,
       "MaximumCollectionPlanSize": 50,
       "ReconnectInterval": "00:15:00",
       "ProblemCounterResetInterval":"1.00:00:00",
       "SnapshotsPerTenMinutesLimit": 1,
       "SnapshotsPerDayLimit": 30,
       "SnapshotInLowPriorityThread": true,
       "ProvideAnonymousTelemetry": true,
       "FailedRequestLimit": 3
     }
   }
   

Diğer .NET uygulamaları için anlık görüntü toplamayı yapılandırma

1. uygulamanız zaten Application Insights ile görüntülenmemişse, Application Insights etkinleştirerek ve izleme anahtarını ayarlayarakçalışmaya başlayın.

2. uygulamanıza Microsoft. applicationınsights. snapshotcollector NuGet paketini ekleyin.

3. anlık görüntüler yalnızca Application Insights bildirilen özel durumlarla toplanır. Kodunuzu raporlamak için kodunuzda değişiklik yapmanız gerekebilir. Özel durum işleme kodu uygulamanızın yapısına bağlıdır, ancak aşağıda bir örnek verilmiştir:

   TelemetryClient _telemetryClient = new TelemetryClient();
   
   void ExampleRequest()
   {
       try
       {
           // TODO: Handle the request.
       }
       catch (Exception ex)
       {
           // Report the exception to Application Insights.
           _telemetryClient.TrackException(ex);
   
           // TODO: Rethrow the exception if desired.
       }
   }
   

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.