Application Insights Bağlayıcısı yönetim çözümü (Kullanım dışı)
Not
Kaynaklar arası sorguların desteğiyle, Application Insights Bağlayıcısı yönetim çözümü artık gerekli değildir. Azure ticari bulutu için 15 Ocak 2019'da resmi olarak kullanım dışı bırakılan OMS portalıyla birlikte Azure Market kullanım dışı bırakıldı ve kaldırıldı. Azure ABD Kamu bulutu için 30 Mart 2019'da kullanımdan kaldırılacaktır.
Mevcut bağlantılar 30 Haziran 2019'a kadar çalışmaya devam edecektir. OMS portalı kullanımdan kaldırıldığında, mevcut bağlantıları yapılandırmanın ve portaldan kaldırmanın bir yolu yoktur. Mevcut bağlantıları kaldırmak için PowerShell kullanmayla ilgili bir betik için aşağıdaki PowerShell ile bağlayıcıyı kaldırma bölümüne bakın.
Birden çok uygulama için Application Insights günlük verilerini sorgulama yönergeleri için bkz. Birden çok Azure İzleyici Application Insights kaynağını birleştirme. OMS portalının kullanımdan kaldırılması hakkında daha fazla bilgi için bkz. Azure'a geçiş OMS portalı.
Applications Insights Bağlayıcısı çözümü, performans sorunlarını tanılamanıza ve Application Insights ile izlendiğinde kullanıcıların uygulamanızla ne yaptığını anlamanıza yardımcı olur. Geliştiricilerin Application Insights'ta gördüğü uygulama telemetrisinin görünümleri Log Analytics'te kullanılabilir. Ancak Application Insights uygulamalarınızı Log Analytics ile tümleştirdiğinizde, işlem ve uygulama verilerinin tek bir yerde bulunmasıyla uygulamalarınızın görünürlüğü artar. Aynı görünümlere sahip olmak, uygulama geliştiricilerinizle birlikte çalışmanıza yardımcı olur. Ortak görünümler, hem uygulama hem de platform sorunlarını algılama ve çözme süresini azaltmaya yardımcı olabilir.
Çözümü kullandığınızda şunları yapabilirsiniz:
- Farklı Azure aboneliklerinde olsalar bile tüm Application Insights uygulamalarınızı tek bir yerde görüntüleme
- Altyapı verilerini uygulama verileriyle ilişkilendirme
- Günlük aramasında uygulama verilerini perspektiflerle görselleştirme
- Log Analytics verilerinden Azure portal Application Insights uygulamanıza özetleyin
Not
Azure ile etkileşim kurmak için Azure Az PowerShell modülünü kullanmanızı öneririz. Başlamak için bkz. Azure PowerShell'i yükleme. Az PowerShell modülüne nasıl geçeceğinizi öğrenmek için bkz. Azure PowerShell’i AzureRM’den Az’ye geçirme.
Bağlı kaynaklar
Diğer Log Analytics çözümlerinin çoğundan farklı olarak, aracılar tarafından Application Insights Bağlayıcısı için veri toplanmaz. Çözüm tarafından kullanılan tüm veriler doğrudan Azure'dan gelir.
| Bağlı Kaynak | Desteklenir | Description |
|---|---|---|
| Windows aracıları | No | Çözüm, Windows aracılarından bilgi toplamaz. |
| Linux aracıları | No | Çözüm, Linux aracılarından bilgi toplamaz. |
| SCOM yönetim grubu | No | Çözüm, bağlı bir SCOM yönetim grubundaki aracılardan bilgi toplamaz. |
| Azure depolama hesabı | No | Çözüm, Azure depolamadan bilgi toplamaz. |
Önkoşullar
- Application Insights Bağlayıcısı bilgilerine erişmek için bir Azure aboneliğiniz olmalıdır
- En az bir yapılandırılmış Application Insights kaynağınız olmalıdır.
- Application Insights kaynağının sahibi veya katkıda bulunanı olmanız gerekir.
Yapılandırma
- Azure marketten veya Çözüm Galerisi'nden Log Analytics çözümleri ekleme bölümünde açıklanan işlemi kullanarak Azure Web Apps Analytics çözümünü etkinleştirin.
- Azure portal göz atın. Application Insights'ı açmak için Tüm hizmetler'i seçin. Ardından Application Insights'ı arayın.
- Abonelikler'in altında Application Insights kaynaklarına sahip bir abonelik seçin ve ardından Ad'ın altında bir veya daha fazla uygulama seçin.
- Kaydet’e tıklayın.
Yaklaşık 30 dakika içinde veriler kullanılabilir duruma gelir ve Application Insights kutucuğu aşağıdaki görüntü gibi verilerle güncelleştirilir:
Göz önünde bulundurulması gereken diğer noktalar:
- Application Insights uygulamalarını yalnızca bir Log Analytics çalışma alanına bağlayabilirsiniz.
- Yalnızca Temel veya Kurumsal Application Insights kaynaklarını Log Analytics'e bağlayabilirsiniz. Ancak Log Analytics'in Ücretsiz katmanını kullanabilirsiniz.
Yönetim paketleri
Bu çözüm, bağlı yönetim gruplarına herhangi bir yönetim paketi yüklemez.
Çözümü kullanma
Aşağıdaki bölümlerde, uygulamalarınızdaki verileri görüntülemek ve bunlarla etkileşime geçmek için Application Insights panosunda gösterilen bölümleri nasıl kullanabileceğiniz açıklanmaktadır.
Application Insights Bağlayıcısı bilgilerini görüntüleme
Aşağıdaki bölümleri görmek için Application Insights kutucuğuna tıklayarak Application Insights panosunu açın.
Pano, tabloda gösterilen bölümleri içerir. Her bölümde, belirtilen kapsam ve zaman aralığı için bu bölümün ölçütlerine uyan en fazla 10 öğe listelenir. Bölümün alt kısmındaki Tümünü görüntüle'ye tıkladığınızda veya bölüm üst bilgisine tıkladığınızda tüm kayıtları döndüren bir günlük araması çalıştırabilirsiniz.
| Sütun | Açıklama |
|---|---|
| Uygulamalar - Uygulama sayısı | Uygulama kaynaklarındaki uygulama sayısını gösterir. Ayrıca uygulama adlarını ve her biri için uygulama kayıtlarının sayısını listeler. Günlük araması çalıştırmak için numaraya tıklayın ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by ApplicationName Konak başına uygulama kayıtlarını, telemetri türüne göre kayıtları ve türe göre tüm verileri (son güne göre) gösteren uygulama için günlük araması çalıştırmak için bir uygulama adına tıklayın. |
| Veri Hacmi – Veri gönderen konaklar | Veri gönderen bilgisayar konaklarının sayısını gösterir. Ayrıca bilgisayar konaklarını ve her konak için kayıt sayısını listeler. Günlük araması çalıştırmak için numaraya tıklayın ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by Host Konakta konak başına uygulama kayıtlarını, telemetri türüne göre kayıtları ve türe göre tüm verileri (son güne göre) gösteren bir günlük araması çalıştırmak için bilgisayar adına tıklayın. |
| Kullanılabilirlik – Webtest sonuçları | Başarılı veya başarısız olduğunu gösteren web testi sonuçları için halka grafiği gösterir. Günlük araması çalıştırmak için grafiğe tıklayın ApplicationInsights | where TelemetryType == "Availability" | summarize AggregatedValue = sum(SampledCount) by AvailabilityResult Sonuçlar, tüm testler için geçiş ve hata sayısını gösterir. Son dakika trafiği olan tüm Web Apps gösterir. Başarısız web testlerinin ayrıntılarını gösteren günlük aramasını görüntülemek için bir uygulama adına tıklayın. |
| Sunucu İstekleri – Saat başına istek sayısı | Çeşitli uygulamalar için saat başına sunucu isteklerinin çizgi grafiğini gösterir. Belirli bir noktaya yönelik istek alan ilk 3 uygulamayı görmek için grafikteki bir çizginin üzerine gelin. Ayrıca, istek alan uygulamaların listesini ve seçilen dönem için istek sayısını gösterir. Çeşitli uygulamalar için ApplicationInsights | where TelemetryType == "Request" | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) saat başına sunucu isteklerinin daha ayrıntılı bir çizgi grafiğini gösteren bir günlük araması çalıştırmak için grafiğe tıklayın. İstek listesini, zaman içindeki istekler için grafikleri ve istek süresi ile istek yanıt kodlarının listesini gösteren bir günlük araması çalıştırmak için ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true listedeki bir uygulamaya tıklayın. |
| Hatalar – Saat başına başarısız istek sayısı | Saat başına başarısız uygulama isteklerinin çizgi grafiğini gösterir. Belirli bir noktaya yönelik başarısız istekleri olan ilk 3 uygulamayı görmek için grafiğin üzerine gelin. Ayrıca, her biri için başarısız istek sayısına sahip uygulamaların listesini gösterir. Başarısız uygulama isteklerinin daha ayrıntılı bir çizgi grafiğini gösteren bir günlük araması çalıştırmak için ApplicationInsights | where TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) grafiğe tıklayın. Başarısız istekleri, zaman içindeki başarısız isteklerin grafiklerini ve istek süresini ve başarısız istek yanıt kodlarının listesini gösteren bir günlük araması çalıştırmak için ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true listedeki bir öğeye tıklayın. |
| Özel durumlar – Saat başına özel durumlar | Saat başına özel durumların çizgi grafiğini gösterir. Belirli bir noktaya özel durumlar içeren ilk 3 uygulamayı görmek için grafiğin üzerine gelin. Ayrıca, her biri için özel durumların sayısını içeren uygulamaların listesini gösterir. Özel durumların daha ayrıntılı bir bağlantı grafiğini gösteren bir günlük araması çalıştırmak için ApplicationInsights | where TelemetryType == "Exception" | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) grafiğe tıklayın. Özel durumların listesini, zaman içindeki özel durumların ve başarısız isteklerin grafiklerini ve özel durum türlerinin listesini gösteren bir günlük araması çalıştırmak için ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Exception" listedeki bir öğeye tıklayın. |
Günlük araması ile Application Insights perspektifini görüntüleme
Panodaki herhangi bir öğeye tıkladığınızda, aramada bir Application Insights perspektifinin gösterildiğini görürsünüz. Perspektif, seçilen telemetri türüne göre genişletilmiş bir görselleştirme sağlar. Bu nedenle görselleştirme içeriği farklı telemetri türleri için değişir.
Uygulamalar bölümünde herhangi bir yere tıkladığınızda varsayılan Uygulamalar perspektifini görürsünüz.
Perspektifte, seçtiğiniz uygulamaya genel bir bakış gösterilir.
Kullanılabilirlik bölümünde, web testi sonuçlarını ve ilgili başarısız istekleri görebileceğiniz farklı bir perspektif görünümü gösterilir.
Sunucu İstekleri veya Hatalar bölümlerinde herhangi bir yere tıkladığınızda, perspektif bileşenleri size isteklerle ilgili bir görselleştirme verecek şekilde değişir.
Özel Durumlar bölümünde herhangi bir yere tıkladığınızda, özel durumlara uyarlanmış bir görselleştirme görürsünüz.
Application Insights Bağlayıcısı panosundaki bir öğeye tıklamanıza bakılmaksızın, Arama sayfasının kendisinde Application Insights verilerini döndüren tüm sorgular Application Insights perspektifini gösterir. Örneğin, Application Insights verilerini görüntülüyorsanız, sorgu * aşağıdaki görüntü gibi perspektif sekmesini de gösterir:
Perspektif bileşenleri arama sorgusuna bağlı olarak güncelleştirilir. Bu, aşağıdakilerden verileri görmenizi sağlayan herhangi bir arama alanını kullanarak sonuçları filtreleyebileceğiniz anlamına gelir:
- Tüm uygulamalarınız
- Tek bir seçili uygulama
- Bir uygulama grubu
Azure portal bir uygulamada özetle
Application Insights Bağlayıcısı bölümleri, Azure portal kullandığınızda seçili Application Insights uygulamasına özetlemenizi sağlayacak şekilde tasarlanmıştır. Çözümü, uygulama sorunlarını gidermenize yardımcı olan üst düzey bir izleme platformu olarak kullanabilirsiniz. Bağlı uygulamalarınızdan herhangi birinde olası bir sorun gördüğünüzde Log Analytics aramasında bu sorunun detayına gidebilir veya doğrudan Application Insights uygulamasına dönebilirsiniz.
Özet için, her satırın sonunda görüntülenen üç noktaya (...) tıklayın ve Application Insights'ta Aç'ı seçin.
Not
Application Insights'ta aç seçeneği Azure portal kullanılamaz.
Örnek düzeltilen veriler
Application Insights telemetri trafiğini azaltmaya yardımcı olmak için örnekleme düzeltmesi sağlar. Application Insights uygulamanızda örneklemeyi etkinleştirdiğinizde, hem Application Insights'ta hem de Log Analytics'te depolanan daha az sayıda girdi elde edersiniz. Application Insights Bağlayıcısı sayfasında ve perspektiflerinde veri tutarlılığı korunurken, özel sorgularınız için örneklenen verileri el ile düzeltmeniz gerekir.
Günlük arama sorgusunda örnekleme düzeltmesi örneği aşağıda verilmiştir:
ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by TelemetryType
Örneklenen Sayı alanı tüm girişlerde bulunur ve girdinin temsil ettiği veri noktası sayısını gösterir. Application Insights uygulamanız için örneklemeyi açarsanız Örneklenen Sayı 1'den büyük olur. Uygulamanızın oluşturduğu gerçek girdi sayısını saymak için Örneklenen Sayı alanlarının toplamını alın.
Örnekleme yalnızca uygulamanızın oluşturduğu toplam girdi sayısını etkiler. RequestDuration veya AvailabilityDuration gibi ölçüm alanları için örneklemeyi düzeltmeniz gerekmez çünkü bu alanlar temsil edilen girişlerin ortalamasını gösterir.
Giriş verileri
Çözüm, bağlı Application Insights uygulamalarınızdan aşağıdaki telemetri veri türlerini alır:
- Kullanılabilirlik
- Özel durumlar
- İstekler
- Sayfa görünümleri – Çalışma alanınızın sayfa görünümlerini alması için uygulamalarınızı bu bilgileri toplayacak şekilde yapılandırmanız gerekir. Daha fazla bilgi için bkz. PageViews.
- Özel olaylar – Çalışma alanınızın özel olayları alması için uygulamalarınızı bu bilgileri toplayacak şekilde yapılandırmanız gerekir. Daha fazla bilgi için bkz . TrackEvent.
Veriler kullanılabilir duruma geldikçe Log Analytics tarafından Application Insights'tan alınır.
Çıktı verileri
Her giriş verisi türü için ApplicationInsights türünde bir kayıt oluşturulur. ApplicationInsights kayıtları aşağıdaki bölümlerde gösterilen özelliklere sahiptir:
Genel alanlar
| Özellik | Açıklama |
|---|---|
| Tür | ApplicationInsights |
| clientIP | |
| TimeGenerated | Kaydın zamanı |
| ApplicationID | Application Insights uygulamasının izleme anahtarı |
| ApplicationName | Application Insights uygulamasının adı |
| RoleInstance | Sunucu konağı kimliği |
| DeviceType | İstemci cihazı |
| ScreenResolution | |
| Kıta | İsteğin kaynaklandığı kıta |
| Ülke | İsteğin kaynaklandığı ülke/bölge |
| Eyaleti | İsteğin kaynaklandığı bölge, eyalet veya yerel ayar |
| Şehir | İsteğin kaynaklandığı şehir veya şehir |
| isSynthetic | İsteğin bir kullanıcı tarafından mı yoksa otomatik yöntemle mi oluşturulduğunu gösterir. True = otomatik yöntem veya false = kullanıcı oluşturuldu |
| Örnekleme Hızı | Portala gönderilen SDK tarafından oluşturulan telemetri yüzdesi. Aralık 0.0-100.0. |
| SampledCount | 100/(Örnekleme Hızı). Örneğin, 4 => %25 |
| Isauthenticated | Doğru veya yanlış |
| OperationID | Aynı işlem kimliğine sahip öğeler portalda İlgili Öğeler olarak gösterilir. Genellikle istek kimliği |
| ParentOperationID | Üst işlemin kimliği |
| OperationName | |
| SessionId | İsteğin oluşturulduğu oturumu benzersiz olarak tanımlamak için GUID |
| SourceSystem | ApplicationInsights |
Kullanılabilirliğe özgü alanlar
| Özellik | Açıklama |
|---|---|
| Telemetri Türü | Kullanılabilirlik |
| AvailabilityTestName | Web testinin adı |
| AvailabilityRunLocation | Http isteğinin coğrafi kaynağı |
| AvailabilityResult | Web testinin başarılı sonucunu gösterir |
| AvailabilityMessage | Web testine eklenen ileti |
| AvailabilityCount | 100/(Örnekleme Oranı). Örneğin, 4 => %25 |
| DataSizeMetricValue | 1.0 veya 0.0 |
| DataSizeMetricCount | 100/(Örnekleme Oranı). Örneğin, 4 => %25 |
| AvailabilityDuration | Web testi süresinin milisaniye cinsinden süresi |
| AvailabilityDurationCount | 100/(Örnekleme Oranı). Örneğin, 4 => %25 |
| AvailabilityValue | |
| AvailabilityMetricCount | |
| AvailabilityTestId | Web testi için benzersiz GUID |
| AvailabilityTimestamp | Kullanılabilirlik testinin tam zaman damgası |
| AvailabilityDurationMin | Örneklenen kayıtlar için bu alan, temsil edilen veri noktaları için en düşük web testi süresini (milisaniye) gösterir |
| AvailabilityDurationMax | Örneklenen kayıtlar için bu alan, temsil edilen veri noktaları için maksimum web testi süresini (milisaniye) gösterir |
| AvailabilityDurationStdDev | Örneklenen kayıtlar için bu alan, temsil edilen veri noktaları için tüm web testi süreleri (milisaniye) arasındaki standart sapması gösterir |
| AvailabilityMin | |
| AvailabilityMax | |
| AvailabilityStdDev |
Özel duruma özgü alanlar
| Tür | ApplicationInsights |
|---|---|
| Telemetri Türü | Özel durum |
| ExceptionType | Özel durumun türü |
| ExceptionMethod | Özel durumu oluşturan yöntem |
| ExceptionAssembly | Derleme, çerçeve ve sürümün yanı sıra ortak anahtar belirtecini içerir |
| ExceptionGroup | Özel durumun türü |
| ExceptionHandledAt | Özel durumu işleyen düzeyi gösterir |
| ExceptionCount | 100/(Örnekleme Oranı). Örneğin, 4 => %25 |
| ExceptionMessage | Özel durum iletisi |
| ExceptionStack | Özel durumun tam yığını |
| ExceptionHasStack | Özel durumun bir yığını varsa True |
İsteğe özgü alanlar
| Özellik | Açıklama |
|---|---|
| Tür | ApplicationInsights |
| Telemetri Türü | İstek |
| ResponseCode | İstemciye gönderilen HTTP yanıtı |
| RequestSuccess | Başarıyı veya başarısızlığı gösterir. True veya false. |
| RequestID | İsteği benzersiz olarak tanımlamak için kimlik |
| İstek Adı | GET/POST + URL tabanı |
| RequestDuration | İstek süresinin saniye cinsinden süresi |
| URL | Ana bilgisayar dahil olmayan isteğin URL'si |
| Host | Web sunucusu konağı |
| URLBase | İsteğin tam URL'si |
| ApplicationProtocol | Uygulama tarafından kullanılan protokol türü |
| RequestCount | 100/(Örnekleme Oranı). Örneğin, 4 => %25 |
| RequestDurationCount | 100/(Örnekleme Oranı). Örneğin, 4 => %25 |
| RequestDurationMin | Örneklenen kayıtlar için bu alan, temsil edilen veri noktaları için minimum istek süresini (milisaniye) gösterir. |
| RequestDurationMax | Örneklenen kayıtlar için bu alan, temsil edilen veri noktaları için maksimum istek süresini (milisaniye) gösterir |
| RequestDurationStdDev | Örneklenen kayıtlar için bu alan, temsil edilen veri noktaları için tüm istek süreleri (milisaniye) arasındaki standart sapması gösterir |
Örnek günlük aramaları
Bu çözümde panoda gösterilen bir dizi örnek günlük araması yoktur. Ancak, açıklamalı örnek günlük arama sorguları Application Insights Bağlayıcı bilgilerini görüntüleme bölümünde gösterilir.
Bağlayıcıyı PowerShell ile kaldırma
OMS portalı kullanımdan kaldırıldığında, mevcut bağlantıları yapılandırmanın ve portaldan kaldırmanın bir yolu yoktur. Mevcut bağlantıları aşağıdaki PowerShell betiğiyle kaldırabilirsiniz. Bu işlemi gerçekleştirmek için çalışma alanının sahibi veya katkıda bulunanı ve Application Insights kaynağının okuyucusu olmanız gerekir.
$Subscription_app = "App Subscription Name"
$ResourceGroup_app = "App ResourceGroup"
$Application = "Application Name"
$Subscription_workspace = "Workspace Subscription Name"
$ResourceGroup_workspace = "Workspace ResourceGroup"
$Workspace = "Workspace Name"
Connect-AzAccount
Set-AzContext -SubscriptionId $Subscription_app
$AIApp = Get-AzApplicationInsights -ResourceGroupName $ResourceGroup_app -Name $Application
Set-AzContext -SubscriptionId $Subscription_workspace
Remove-AzOperationalInsightsDataSource -WorkspaceName $Workspace -ResourceGroupName $ResourceGroup_workspace -Name $AIApp.Id
REST API çağrısı çağıran aşağıdaki PowerShell betiğini kullanarak uygulamaların listesini alabilirsiniz.
Connect-AzAccount
$Tenant = "TenantId"
$Subscription_workspace = "Workspace Subscription Name"
$ResourceGroup_workspace = "Workspace ResourceGroup"
$Workspace = "Workspace Name"
$AccessToken = "AAD Authentication Token"
Set-AzContext -SubscriptionId $Subscription_workspace
$LAWorkspace = Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroup_workspace -Name $Workspace
$Headers = @{
"Authorization" = "Bearer $($AccessToken)"
"x-ms-client-tenant-id" = $Tenant
}
$Connections = Invoke-RestMethod -Method "GET" -Uri "https://management.azure.com$($LAWorkspace.ResourceId)/dataSources/?%24filter=kind%20eq%20'ApplicationInsights'&api-version=2015-11-01-preview" -Headers $Headers
$ConnectionsJson = $Connections | ConvertTo-Json
Bu betik, Azure Active Directory'de kimlik doğrulaması için taşıyıcı kimlik doğrulama belirteci gerektirir. Bu belirteci alma yollarından biri , REST API belge sitesindeki bir makaleyi kullanmaktır. Deneyin'e tıklayın ve Azure aboneliğinizde oturum açın. Taşıyıcı belirtecini aşağıdaki görüntüde gösterildiği gibi İstek Önizlemesi'nden kopyalayabilirsiniz.
Günlük sorgusu kullanan uygulamaların listesini de alabilirsiniz:
ApplicationInsights | summarize by ApplicationName
Sonraki adımlar
- Application Insights uygulamalarınıza ilişkin ayrıntılı bilgileri görüntülemek için Günlük Araması'nı kullanın.