İşlem Arama ve Tanılama

İşlem araması, sayfa görünümleri, özel durumlar veya web istekleri gibi tek tek telemetri öğelerini bulmak ve keşfetmek için kullandığınız Application Insights özelliğidir. Ayrıca kodladığınız günlük izlemelerini ve olaylarını da görüntüleyebilirsiniz.

Verileriniz üzerinde daha karmaşık sorgular için Log Analytics'i kullanın.

Arama'yı nerede görüyorsunuz?

Arama'yı Azure portalında veya Visual Studio'da bulabilirsiniz.

Azure portalında

İşlem aramasını uygulamanızın Application Insights Genel Bakış sekmesinden açabilirsiniz. Soldaki menüde Araştır'ın altında Ara'yı da seçebilirsiniz.

Sunucu istekleri, sayfa görünümleri ve kodladığınız özel olaylar gibi telemetri öğelerinin listesini görmek için Olay türleri açılan menüsüne gidin. Sonuçlar listesinin en üstünde zaman içindeki olay sayısını gösteren bir özet grafik bulunur.

Yeni olaylar almak için açılan menüden geri dönün veya Yenile'yi seçin.

Visual Studio’da

Visual Studio'da bir Application Insights Arama penceresi de vardır. Hata ayıkladığınız uygulama tarafından oluşturulan telemetri olaylarını görüntülemek için en kullanışlıdır. Ancak azure portalında yayımlanan uygulamanızdan toplanan olayları da gösterebilir.

Visual Studio'da Application Insights Arama penceresini açın:

Application Insights Arama penceresinde web portalına benzer özellikler bulunur:

bir isteği veya sayfa görünümünü açtığınızda İşlemi İzle sekmesi kullanılabilir. "İşlem", tek bir istek veya sayfa görünümüyle ilişkili olayların dizisidir. Örneğin, bağımlılık çağrıları, özel durumlar, izleme günlükleri ve özel olaylar tek bir işlemin parçası olabilir. İşlemi İzle sekmesi, istek veya sayfa görünümüne göre bu olayların zamanlamasını ve süresini grafik olarak gösterir.

Tek tek öğeleri inceleme

Anahtar alanlarını ve ilgili öğeleri görmek için herhangi bir telemetri öğesini seçin.

Uçtan uca işlem ayrıntıları görünümü açılır.

Olay türlerini filtreleme

Olay türleri açılan menüsünü açın ve görmek istediğiniz olay türlerini seçin. Filtreleri daha sonra geri yüklemek istiyorsanız Sıfırla'yı seçin.

Olay türleri şunlardır:

• İzleme: TrackTrace, log4Net, NLog ve System.Diagnostic.Trace çağrılarını içeren tanılama günlükleri .
• İstek: Sunucu uygulamanız tarafından alınan sayfalar, betikler, görüntüler, stil dosyaları ve veriler gibi HTTP istekleri. Bu olaylar, istek ve yanıta genel bakış grafiklerini oluşturmak için kullanılır.
• Sayfa Görünümü: Sayfa görünümü raporları oluşturmak için kullanılan web istemcisi tarafından gönderilen telemetri.
• Özel Olay: Kullanımı izlemek için çağrısı TrackEvent() eklediyseniz, bunları burada arayabilirsiniz.
• Özel durum: Sunucudaki yakalanmayan özel durumlar ve kullanarak TrackException()günlüğe kaydettiğiniz özel durumlar.
• Bağımlılık: Sunucu uygulamanızdan REST API'leri veya veritabanları gibi diğer hizmetlere yapılan çağrılar ve istemci kodunuzdan AJAX çağrıları.
• Kullanılabilirlik: Kullanılabilirlik testlerinin sonuçları

Özellik değerlerine göre filtreleme

Olayları özelliklerinin değerlerine göre filtreleyebilirsiniz. Kullanılabilir özellikler, seçtiğiniz olay türlerine bağlıdır. Başlamak için Filtre'yi seçin.

Belirli bir özelliğin değer seçmesi, tüm değerleri seçmeyle aynı etkiye sahiptir. Bu özellikte filtrelemeyi kapatır.

Filtre değerlerinin sağındaki sayılarda, geçerli filtrelenmiş kümede kaç yineleme olduğunu gösterdiğine dikkat edin.

Aynı özelliğe sahip olayları bulma

Aynı özellik değerine sahip tüm öğeleri bulmak için, Arama kutusuna girin veya Filtre sekmesindeki özelliklere baktığınızda onay kutusunu seçin.

Verilerde arama

Özellik değerlerinden herhangi birinde terimleri arayabilirsiniz. Özellik değerleriyle özel olaylar yazarsanız bu özellik kullanışlıdır.

Daha kısa bir aralıktaki aramalar daha hızlı olduğundan bir zaman aralığı ayarlamak isteyebilirsiniz.

Alt dizeleri değil, tam sözcükleri arayın. Özel karakterleri içine almak için tırnak işaretlerini kullanın.

Aşağıdaki arama ifadelerini kullanabilirsiniz:

Örnekleme

Uygulamanız önemli telemetri verileri oluşturuyorsa ve ASP.NET SDK 2.0.0-beta3 veya sonraki bir sürümünü kullanıyorsa, uyarlamalı örnekleme yoluyla portala gönderilen birimi otomatik olarak azaltır. Bu modül olayların yalnızca temsili bir bölümünü gönderir. Grupla aynı istekle ilgili olayları seçer veya seçimini kaldırır ve ilgili olaylar arasında gezinmenizi sağlar.

Örnekleme hakkında bilgi edinin.

İş öğesi oluştur

GitHub'da veya Azure DevOps'ta herhangi bir telemetri öğesinden ayrıntıları içeren bir hata oluşturabilirsiniz.

Herhangi bir telemetri öğesini seçerek uçtan uca işlem ayrıntı görünümüne gidin. Ardından İş öğesi oluştur'u seçin.

Bu adımı ilk kez gerçekleştirdiğinizde, Azure DevOps kuruluşunuza ve projenize bir bağlantı yapılandırmanız istenir. Bağlantıyı İş Öğeleri sekmesinde de yapılandırabilirsiniz.

Application Insights'a daha fazla telemetri gönderme

Application Insights SDK'sı tarafından gönderilen kullanıma hazır telemetriye ek olarak şunları yapabilirsiniz:

• .NET veya Java'da sık kullandığınız günlük çerçevesinden günlük izlemelerini yakalayın. Bu, günlük izlemelerinizde arama yapabileceğiniz ve bunları sayfa görünümleri, özel durumlar ve diğer olaylarla ilişkilendirebileceğiniz anlamına gelir.

• Özel olayları, sayfa görünümlerini ve özel durumları göndermek için kod yazın.

Application Insights'a günlükleri ve özel telemetri verilerini göndermeyi öğrenin.

Sık sorulan sorular

Sık sorulan sorulara yanıtlar bulun.

Ne kadar veri tutulur?

Bkz. Sınırlar özeti.

Sunucu isteklerimde POST verilerini nasıl görebilirim?

POST verilerini otomatik olarak günlüğe kaydetmeyiz, ancak TrackTrace veya günlük çağrılarını kullanabilirsiniz. POST verilerini ileti parametresine yerleştirin. İletiyi, özelliklere göre filtreleyebileceğiniz gibi filtreleyemezsiniz, ancak boyut sınırı daha uzundur.

Azure İşlevi aramam neden sonuç döndürmüyor?

Azure İşlevleri URL sorgu dizelerini günlüğe kaydetmez.

Birleşik tanılama deneyimi, tüm Application Insights izlenen bileşenlerinizden gelen sunucu tarafı telemetri verilerini otomatik olarak tek bir görünümde ilişkilendirmektedir. Birden çok kaynağınız olması önemli değildir. Application Insights, temel alınan ilişkiyi algılar ve işlem yavaşlaması veya hatasına neden olan uygulama bileşenini, bağımlılığı veya özel durumu kolayca tanılamanıza olanak tanır.

Bileşen nedir?

Bileşenler, dağıtılmış veya mikro hizmet uygulamanızın bağımsız olarak dağıtılabilir parçalarıdır. Geliştiriciler ve operasyon ekipleri, bu uygulama bileşenleri tarafından oluşturulan kod düzeyinde görünürlüğe veya telemetriye erişime sahiptir.

• Bileşenler, sql ve olay hub'ları gibi ekibinizin veya kuruluşunuzun erişimi olmayabilir (kod veya telemetri) gibi "gözlemlenen" dış bağımlılıklardan farklıdır.
• Bileşenler herhangi bir sayıda sunucu, rol veya kapsayıcı örneğinde çalışır.
• Abonelikler farklı olsa bile bileşenler ayrı Application Insights izleme anahtarları olabilir. Bileşenler, tek bir Application Insights izleme anahtarına rapor veren farklı roller de olabilir. Yeni deneyim, nasıl ayarlandıklarından bağımsız olarak tüm bileşenlerle ilgili ayrıntıları gösterir.

İşlem tanılama deneyimi

Bu görünümün dört önemli bölümü vardır:

• sonuç listesi
• bileşenler arası işlem grafiği
• bu işlemle ilgili tüm telemetri verilerinin zaman sırası listesi
• seçili telemetri öğesi için ayrıntılar bölmesi

Bileşenler arası işlem grafiği

Bu grafik, bileşenler arasında istekler ve bağımlılıklar sırasında yatay çubuklar içeren bir zaman çizelgesi sağlar. Toplanan tüm özel durumlar da zaman çizelgesinde işaretlenir.

• Bu grafikteki üst satır giriş noktasını temsil eder. Bu işlemde çağrılan ilk bileşene gelen istektir. Süre, işlemin tamamlanması için geçen toplam süredir.
• Dış bağımlılıklara yapılan tüm çağrılar, bağımlılık türünü temsil eden simgelere sahip basit, sıralanamayan satırlardır.
• Diğer bileşenlere yapılan çağrılar daraltılabilir satırlardır. Her satır, bileşende çağrılan belirli bir işleme karşılık gelir.
• Varsayılan olarak, seçtiğiniz istek, bağımlılık veya özel durum yan tarafta görünür. Ayrıntılarını görmek için herhangi bir satırı seçin.

Bu İşlem Kimliğine sahip tüm telemetri

Bu bölümde, bu işlemle ilgili tüm telemetri verilerinin zaman dizisindeki düz liste görünümü gösterilir. Ayrıca, işlem grafiğinde görüntülenmemiş özel olayları ve izlemeleri de gösterir. Bu listeyi belirli bir bileşen veya çağrı tarafından oluşturulan telemetriye göre filtreleyebilirsiniz. Bu listedeki herhangi bir telemetri öğesini seçerek ilgili ayrıntıları yan tarafta görebilirsiniz.

Seçili telemetrinin ayrıntıları

Bu daraltılabilir bölme, işlem grafiğinden veya listeden seçilen öğelerin ayrıntılarını gösterir. Toplanan tüm standart öznitelikleri tüm listeler. Tüm özel öznitelikler standart küme altında ayrı olarak listelenir. İzlemeyi kopyalama seçeneği elde etmek için Çağrı Yığını izleme penceresinin altındaki üç nokta düğmesini (...) seçin. Profil oluşturucu izlemelerini açma ve Hata ayıklama anlık görüntüsünü açma, ilgili ayrıntı bölmelerinde kod düzeyi tanılamaları gösterir.

Sonuçlarda ara

Bu daraltılabilir bölme, filtre ölçütlerine uyan diğer sonuçları gösterir. Yukarıdaki üç bölümün ilgili ayrıntılarını güncelleştirmek için herhangi bir sonuç seçin. Örnekleme herhangi bir bileşende etkin olsa bile tüm bileşenlerde mevcut olan ayrıntılara sahip olma olasılığı en yüksek örnekleri bulmaya çalışıyoruz. Bu örnekler öneri olarak gösterilir.

Profil Oluşturucu ve Anlık Görüntü Hata Ayıklayıcısı

Application Insights Profiler veya Snapshot Debugger , performans ve hata sorunlarının kod düzeyinde tanılamalarına yardımcı olur. Bu deneyimle, tek bir seçimle herhangi bir bileşenden Profil Oluşturucu izlemelerini veya anlık görüntülerini görebilirsiniz.

Profiler'ı çalıştıramıyorsanız ile iletişime geçin serviceprofilerhelp@microsoft.com.

Snapshot Debugger'ı çalıştıramıyorsanız, ile iletişime geçin snapshothelp@microsoft.com.

Sık sorulan sorular

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

Neden grafikte tek bir bileşen görüyorum ve diğer bileşenler herhangi bir ayrıntı olmadan yalnızca dış bağımlılıklar olarak gösterilsin?

Olası nedenler:

• Diğer bileşenler Application Insights ile izleniyor mu?
• En son kararlı Application Insights SDK'sını kullanıyorlar mı?
• Bu bileşenler ayrı Application Insights kaynaklarıysa erişiminiz olduğunu doğrulayın. Erişiminiz varsa ve bileşenler en son Application Insights SDK'larıyla izleniyorsa sağ üst köşedeki geri bildirim kanalı aracılığıyla bize bildirin.

Bağımlılıklar için yinelenen satırlar görüyorum. Bu davranış bekleniyor mu?

Şu anda giden bağımlılık çağrısını gelen istekten ayrı olarak gösteriyoruz. Genellikle iki çağrı, ağ gidiş dönüş nedeniyle yalnızca süre değerinin farklı olmasıyla aynı görünür. Baştaki simge ve süre çubuklarının benzersiz stili, aralarında ayrımlara yardımcı olur. Bu veri sunumu kafa karıştırıcı mı? Bize geri bildiriminizi gönderin!

Farklı bileşen örnekleri arasında saat dengesizliklerine ne dersin?

Zaman çizelgeleri, işlem grafiğindeki saat dengesizliklerine göre ayarlanır. Ayrıntılar bölmesinde veya Log Analytics'i kullanarak tam zaman damgalarını görebilirsiniz.

Yeni deneyimde ilgili öğe sorgularının çoğu neden eksik?

Bu davranış, tasarım gereğidir. Tüm bileşenlerde ilgili tüm öğeler, üst ve alt bölümlerde sol tarafta zaten kullanılabilir durumdadır. Yeni deneyimde, sol tarafın kapsamadığı iki ilgili öğe vardır: bu olaydan beş dakika öncesine ve sonrasına ve kullanıcı zaman çizelgesine ait tüm telemetri.

Application Insights JavaScript SDK'sını kullanırken işlem başına daha az olay görmenin bir yolu var mı?

İşlem tanılama deneyimi, tüm telemetriyi bir İşlem Kimliğini paylaşan tek bir işlemde gösterir. Varsayılan olarak, JavaScript için Application Insights SDK'sı her benzersiz sayfa görünümü için yeni bir işlem oluşturur. Tek sayfalı bir uygulamada (SPA) yalnızca bir sayfa görünümü olayı oluşturulur ve oluşturulan tüm telemetri için tek bir İşlem Kimliği kullanılır. Sonuç olarak, birçok olay aynı işlemle ilişkilendirilebilir.

Bu senaryolarda, SPA'nızda gezinti için otomatik olarak yeni işlemler oluşturmak için Otomatik Yol İzleme'yi kullanabilirsiniz. URL yolu her güncelleştirildiğinde (mantıksal sayfa görünümü gerçekleşir) sayfa görünümünün oluşturulması için enableAutoRouteTracking'i açmanız gerekir. İşlem Kimliğini el ile yenilemek istiyorsanız çağrısı yapın appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId(). Bir PageView olayının el ile tetiklenmesi de İşlem Kimliğini sıfırlar.

İşlem ayrıntısı süreleri neden üst istek süresine eklenmiyor?

Gantt grafiğinde açıklanmamış zaman, izlenen bağımlılık kapsamında olmayan süredir. Dış çağrılar otomatik olarak veya el ile izlenmediğinden bu sorun oluşabilir. Bunun nedeni, dış çağrı yerine geçen sürenin işlemde olmasıdır.

Tüm çağrılar izlendiyse, işlem sırasında harcanan sürenin olası kök nedenidir. İşlemi tanılamak için kullanışlı bir araç, Application Insights profil oluşturucusdur.

Azure portalında Application Insights'ta gezinirken veri alınırken hata oluştu iletisini görürsem ne olur?

Bu hata, tarayıcının gerekli bir API'ye çağrı yapamadığını veya API'nin bir hata yanıtı döndürdüğünü gösterir. Davranışı gidermek için bir tarayıcı InPrivate penceresi açın ve çalışan tarayıcı uzantılarını devre dışı bırakın, ardından portal davranışını yine de yeniden oluşturup oluşturamadığını belirleyin. Portal hatası oluşmaya devam ederse, diğer tarayıcılarla veya diğer makinelerle test etmeyi deneyin, API çağrılarının başarısız olduğu istemci makinesinden DNS veya ağ ile ilgili diğer sorunları araştırın. Portal hatası devam ederse ve daha fazla araştırma gerekiyorsa, beklenmeyen portal davranışını yeniden oluştururken bir tarayıcı ağ izlemesi toplayın ve ardından Azure portalından bir destek olayı açın.