Azure Uygulaması Hizmeti için uygulama izlemeye genel bakış

  • Makale

artık ASP.NET, ASP.NET Core, Java ve Azure Uygulaması Service üzerinde çalışan Node.js dayalı olarak web uygulamalarınızda izlemeyi etkinleştirmek her zamankinden daha kolay. Daha önce uygulamanızı el ile izlemeniz gerekiyordu, ancak en son uzantı/aracı artık varsayılan olarak App Service görüntüsünde yerleşiktir.

Application Insights’ı Etkinleştir

App Service'te barındırılan uygulamalar için izlemeyi etkinleştirmenin iki yolu vardır:

  • Otomatik yetkisiz erişim uygulaması izleme (Application Analizler Agent).

    Bu yöntem, etkinleştirilmesi en kolay yöntemdir ve kod değişikliği veya gelişmiş yapılandırma gerekmez. Genellikle "çalışma zamanı" izleme olarak adlandırılır. App Service için en azından bu izleme düzeyini etkinleştirmenizi öneririz. Belirli senaryonuza bağlı olarak, el ile izleme aracılığıyla daha gelişmiş izleme gerekip gerekmediğini değerlendirebilirsiniz.

    Otomatik izlemeyi etkinleştirdiğinizde, uygulama Analizler varsayılan bir ayarla (örnekleme de içerir) etkinleştirir. Azure Uygulaması Analizler: Örnekleme: Tüm Veriler %100 olarak ayarlamış olsanız bile bu ayar yoksayılır.

    Desteklenen otomatik dağıtım senaryolarının tam listesi için bkz . Desteklenen ortamlar, diller ve kaynak sağlayıcıları.

    Otomatik yetkisiz erişim izleme için aşağıdaki platformlar desteklenir:

  • Application Analizler SDK'sını yükleyerek uygulamayı kod aracılığıyla el ile izleme.

    Bu yaklaşım çok daha özelleştirilebilir ancak şu yaklaşımları gerektirir: .NET Core için SDK, .NET, Node.js, Python ve Java için tek başına bir aracı. Bu yöntem, paketlerin en son sürümüne yapılan güncelleştirmeleri kendiniz yönetmeniz gerektiği anlamına da gelir.

    Otomatik yetkisiz erişim izleme ile varsayılan olarak yakalanmayan olayları/bağımlılıkları izlemek için özel API çağrıları yapmanız gerekiyorsa, bu yöntemi kullanmanız gerekir. Daha fazla bilgi edinmek için bkz. Özel olaylar ve ölçümler için Uygulama Analizler API'si.

Hem otomatik yetkisiz erişim izleme hem de el ile SDK tabanlı izleme algılanırsa, .NET'te yalnızca el ile izleme ayarları kabul edilirken Java'da yalnızca otomatik yetkisiz erişim telemetriyi yayar. Bu uygulama, yinelenen verilerin gönderilmesini engellemektir.

Not

Snapshot Debugger ve Profiler yalnızca .NET ve .NET Core'da kullanılabilir.

Sürüm notları

Bu bölüm, Application Analizler ile çalışma zamanı izlemesi için Azure Web Apps Uzantısı sürüm notlarını içerir.

Uzantının hangi sürümünü kullandığınızı bulmak için adresine https://<yoursitename>.scm.azurewebsites.net/ApplicationInsightsgidin.

Sürüm notları

2.8.44

2.8.43

  • .NET/.NET Core, Java ve Node.js paketini farklı App Service Windows Site Uzantısına ayırın.

2.8.42

  • JAVA uzantısı: 2.5.1'den Java Agent 3.2.0'a yükseltildi.
  • Node.js uzantısı: AI SDK'sı 2.1.7'den 2.1.8'e güncelleştirildi. Kullanıcı ve Sistem tarafından atanan Microsoft Entra yönetilen kimlikleri için destek eklendi.
  • .NET Core: .NET Başlangıç Kancası kullanılarak bağımsız dağıtımlar ve .NET 6.0 desteği eklendi.

2.8.41

  • Node.js uzantısı: AI SDK'sı 2.1.3'ten 2.1.7'ye güncelleştirildi.
  • .NET Core: Destek dışı sürüm (2.1) kaldırıldı. Desteklenen sürümler 3.1 ve 5.0'dır.

2.8.40

  • JAVA uzantısı: 3.0.2'den Java Agent 3.1.1'e (GA) yükseltildi.
  • Node.js uzantısı: Yapay zeka SDK'sı 1.8.8'den 2.1.3'e güncelleştirildi.

2.8.39

  • .NET Core: .NET Core 5.0 desteği eklendi.

2.8.38

  • JAVA uzantısı: 2.5.1'den Java Agent 3.0.2'ye (GA) yükseltildi.
  • Node.js uzantısı: Yapay zeka SDK'sı 1.8.7'den 1.8.8'e güncelleştirildi.
  • .NET Core: Destek dışı sürümler kaldırıldı (2.0, 2.2, 3.0). Desteklenen sürümler 2.1 ve 3.1'dir.

2.8.37

  • AppSvc Windows uzantısı: .NET Core'un herhangi bir System.Diagnostics.DiagnosticSource.dll sürümüyle çalışmasını sağladı.

2.8.36

  • AppSvc Windows uzantısı: .NET Core'da yapay zeka SDK'sı ile birlikte çalışma etkinleştirildi.

2.8.35

  • AppSvc Windows uzantısı: .NET Core 3.1 desteği eklendi.

2.8.33

  • .NET, .NET core, Java ve Node.js aracıları ile Windows Uzantısı: Bağımsız bulutlar için destek. Bağlan ions dizeleri bağımsız bulutlara veri göndermek için kullanılabilir.

2.8.31

  • ASP.NET Core aracısı, Uygulama Analizler SDK'sı ile ilgili bir sorunu düzeltir. Çalışma zamanı yanlış sürümünü System.Diagnostics.DiagnosticSource.dllyüklediyse, kodsuz uzantı uygulamayı kilitlenmez ve geri döner. Sorunu düzeltmek için, müşterilerin depo gözü klasöründen kaldırması System.Diagnostics.DiagnosticSource.dll veya ayarlayarak ApplicationInsightsAgent_EXTENSIONVERSION=2.8.24uzantının eski sürümünü kullanması gerekir. Aksi takdirde uygulama izleme etkinleştirilmez.

2.8.26

  • ASP.NET Core aracısı: Güncelleştirilmiş Uygulama Analizler SDK'sı ile ilgili sorun düzeltildi. Application Analizler.dll zaten bin klasöründe varsa aracı yüklenmeye AiHostingStartup çalışmaz. Derleme<AiHostingStartup> aracılığıyla yansımayla ilgili sorunları çözer. GetTypes().
  • Bilinen sorunlar: Dll'nin DiagnosticSource başka bir sürümü yüklenirse özel durum System.IO.FileLoadException: Could not load file or assembly 'System.Diagnostics.DiagnosticSource, Version=4.0.4.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' oluşabilir. Örneğin yayımlama klasöründe varsa System.Diagnostics.DiagnosticSource.dll bu durum oluşabilir. Azaltma olarak, uygulama hizmetlerinde uygulama ayarlarını ayarlayarak uzantının önceki sürümünü kullanın: Application Analizler Agent_EXTENSIONVERSION=2.8.24.

2.8.24

  • 2.8.21'in yeniden paketlenmiş sürümü.

2.8.23

  • ASP.NET Core 3.0 kodsuz izleme desteği eklendi.
  • ASP.NET Core SDK'sı 2.1, 2.2 ve 3.0 çalışma zamanı sürümleri için 2.8.0'a güncelleştirildi. .NET Core 2.0'ı hedefleyen uygulamalar SDK'nın 2.1.1 sürümünü kullanmaya devam ediyor.

2.8.14

  • .NET Core 2.1, 2.2'yi hedefleyen uygulamalar için ASP.NET Core SDK sürümü 2.3.0'dan en son sürüme (2.6.1) güncelleştirildi. .NET Core 2.0'ı hedefleyen uygulamalar SDK'nın 2.1.1 sürümünü kullanmaya devam ediyor.

2.8.12

  • ASP.NET Core 2.2 uygulamaları için destek.

  • ASP.NET Core uzantısında, uygulama SDK ile önceden izlendiğinde bile SDK eklenmesine neden olan bir hata düzeltildi. 2.1 ve 2.2 uygulamalarında uygulama klasöründe Application Analizler.dll bulunması artık uzantının kapanmasına neden oluyor. 2.0 uygulamaları için uzantı yalnızca Application Analizler bir UseApplicationInsights() çağrıyla etkinleştirildiğinde geri döner.

  • ASP.NET Core uygulamaları için tamamlanmamış HTML yanıtı için kalıcı düzeltme. Bu düzeltme artık .NET Core 2.2 uygulamalarında çalışacak şekilde genişletilmiştir.

  • ASP.NET Core uygulamalarıAPPINSIGHTS_JAVASCRIPT_ENABLED=false appsetting () için JavaScript ekleme özelliğini kapatma desteği eklendi. ASP.NET çekirdek için JavaScript eklemesi, açıkça kapatılmadığı sürece varsayılan olarak "Geri Çevir" modundadır. (Geçerli davranışı korumak için varsayılan ayar yapılır.)

  • ikey mevcut olmasa bile eklemeye neden olan ASP.NET Core uzantısı hatası düzeltildi.

  • TELEmetride yanlış SDK sürümüne neden olan SDK sürüm ön eki mantığındaki bir hata düzeltildi.

  • Telemetrinin nasıl toplandığını belirlemek için ASP.NET Core uygulamaları için SDK sürümü ön eki eklendi.

  • Önceden yüklenmiş uzantının sürümünün doğru şekilde gösterilmesi için SCM- Uygulama Analizler sayfası düzeltildi.

2.8.10

  • ASP.NET Core uygulamaları için tamamlanmamış HTML yanıtı için düzeltme.

Sık sorulan sorular

Bu bölüm, sık sorulan soruların yanıtlarını sağlar.

Uygulama Analizler projemde neleri değiştiriyor?

Ayrıntılar projenin türüne bağlıdır. Web uygulaması için:

  • Bu dosyaları projenize ekler:
    • ApplicationInsights.config
    • ai.js
  • Şu NuGet paketlerini yükler:
    • Uygulama Analizler API'si: Çekirdek API
    • Web Uygulamaları için Uygulama Analizler API'si: Sunucudan telemetri göndermek için kullanılır
    • JavaScript Uygulamaları için Uygulama Analizler API'si: İstemciden telemetri göndermek için kullanılır
  • Paketler şu derlemeleri içerir:
    • Microsoft.Application Analizler
    • Microsoft.Application Analizler. Platform
  • Öğeleri şu öğelere ekler:
    • Web.config
    • packages.config
  • (Yalnızca yeni projeler için, uygulama Analizler var olan bir projeye el ile eklersiniz.) Kod parçacıklarını uygulama Analizler kaynak kimliğiyle başlatmak için istemci ve sunucu koduna ekler. Örneğin, bir MVC uygulamasında kod, Views/Shared/_Layout.cshtml ana sayfasına eklenir.

Sonraki adımlar

App Service üzerinde çalışan .NET Core, .NET, Java, Nodejs veya Python uygulamanız için otomatik yetkisiz erişim uygulaması izlemeyi etkinleştirmeyi öğrenin.