Aracılığıyla paylaş


Application Insights telemetri verileri modeli

Application Insights , uygulamanızın ve altyapınızın performansı ve kullanımı hakkında içgörüler sağlamak için web uygulamanızdan Azure portalına telemetri gönderir. Telemetri verilerini daha iyi anlamanıza ve düzenlemenize yardımcı olmak için verileri ayrı türler halinde kategorilere ayırırız.

Telemetri veri modeli standartlaştırılmıştır ve platformdan ve dilden bağımsız izleme oluşturmayı mümkün hale getirir. Temel senaryoları desteklemek için modeli basit ve ince tutmaya ve şemanın gelişmiş kullanım için genişletilmesine izin vermek için çalışıyoruz.

Application Insights tarafından toplanan veriler bu tipik uygulama yürütme düzenini modeller:

Application Insights telemetri veri modelini gösteren diyagram.

1availabilityResults varsayılan olarak kullanılamaz ve kullanılabilirlik testlerinin ayarlanmasını gerektirir.
2customEvents ve customMetrics yalnızca özelleştirilmiş araçlar ile kullanılabilir.

Not

Application Insights, eski nedenlerden dolayı günlükleri traces tabloda depolar. Dağıtılmış izlerin yayılma alanları requests ve dependencies tablolarında depolanır. Herhangi bir karışıklığı önlemek için bunu gelecek bir sürümde çözmeyi planlıyoruz.

Telemetri türleri

Uygulamanızın yürütülmesini izlemek için aşağıdaki telemetri türleri kullanılır. Azure İzleyici OpenTelemetry Distro ve Application Insights JavaScript SDK'sı aşağıdakileri toplar:

Telemetri türü Tablo adı
(Application İzleme Bilgileri)
Tablo adı
(Log Analitiği)
Açıklama
Kullanılabilirlik availabilityResults AppAvailabilityResults Düzenli aralıklarla web istekleri göndererek ve uygulama yanıt vermiyorsa veya yanıt süresi çok yavaşsa sizi uyararak uygulamanızın kullanılabilirliğini ve yanıt hızını izler.
Tarayıcı zamanlaması browserTimings AppBrowserTimings Sayfa yükleme süreleri ve ağ süreleri dahil olmak üzere web sayfalarının performansını ölçer.
Bağımlılık dependencies AppDependencies Uygulamanızdan REST API veya SQL veritabanı gibi bir dış hizmete veya depolamaya yapılan çağrıları izler ve bu çağrıların süresini ve başarısını ölçer.
Etkinlik customEvents AppEvents Kullanım desenlerini analiz etmek için genellikle uygulamanızdaki kullanıcı etkileşimlerini ve düğme tıklamaları veya sipariş kullanıma alma işlemleri gibi diğer önemli oluşumları yakalamak için kullanılır.
Özel durum exceptions AppExceptions Hataların giderilmesi ve anlaşılması için önemli olan hata bilgilerini yakalar.
Ölçüm performanceCounters

customMetrics
AppPerformanceCounters

AppMetrics
Performans sayaçları, uygulama ve sistem performansının CPU kullanımı ve bellek tüketimi gibi çeşitli yönleri hakkında sayısal veriler sağlar.

Ayrıca özel ölçümler, uygulamanıza özgü belirli ölçümleri tanımlamanıza ve izlemenize olanak tanıyarak özel performans göstergelerini izleme esnekliği sağlar.
Sayfa görünümü pageViews AppPageViews Kullanıcılar tarafından görüntülenen sayfaları izler ve uygulamanızdaki kullanıcı gezintisi ve etkileşimi hakkında içgörüler sağlar.
İstek requests AppRequests Uygulamanız tarafından alınan istekleri kayda alarak işlem kimliği, süre ve başarılı ya da başarısız olma durumu gibi ayrıntıları sağlar.
İzleme traces AppTraces Özel tanılama iletileri veya izleme deyimleri gibi uygulamaya özgü olayları günlüğe kaydeder. Bu, uygulama davranışını zaman içinde hata ayıklamak ve izlemek için kullanışlıdır.

Önemli

Uygulama telemetrisini hem Application Insights'tan hem de Log Analytics'ten sorgulayabilirsiniz (önerilir), ancak tablo ve alan adları farklıdır. Bu ayrım, örneğin Log Analytics adlandırma kuralından önce oluşturulan özel sorgulara sahip müşteri panolarının düzgün çalışmaya devam etmesini sağlamak için geriye dönük uyumluluğu korur.

Azure portalında alan adlarını karşılaştırmak için Application Insights>Günlükleri'ni açın, bir sorgu çalıştırın ve telemetri öğesinin (örneğin, 1234a5b6c7de8f90) kopyasını kopyalayınId. Ardından tarayıcınızda yeni bir sekme açın, Log Analytics Günlükleri'ne> gidin, KQL moduna geçin ve sorguyu çalıştırın:

AppDependencies // Notice that table names are also different.
| where Id == "1234a5b6c7de8f90"

Tüm özelliklerini görüntülemek için her satırın solundaki üst karakteri seçerek her iki telemetri öğesini de genişletin.

Her telemetri öğesi, uygulama sürümü veya kullanıcı oturumu kimliği gibi bağlam bilgilerini içerebilir. Bağlam, farklı analiz senaryolarına olanak tanıyan, kesin olarak belirlenmiş bir alan kümesinden oluşur.

Örneğin, uygulama sürümü düzgün bir şekilde başlatıldığında Application Insights, yeniden dağıtımla ilişkili uygulama davranışındaki yeni desenleri algılayabilir. Benzer şekilde, kesintilerin veya sorunların kullanıcılar üzerindeki etkisini değerlendirmek için oturum kimliğini kullanabilirsiniz. Başarısız bağımlılıklar, hata izlemeleri veya kritik özel durumlarla ilişkili benzersiz oturum kimliklerinin sayısını hesaplayarak, kullanıcı etkisinin daha net bir resmini elde edebilirsiniz.

Application Insights telemetri modeli, telemetri öğelerinin ait oldukları işlemler ile bağıntısını da destekler. Örneğin, bir istek bir SQL Veritabanı çağrısı tetiklerse, hem istek hem de bağımlılık çağrısı tanılama verilerini içerebilir ve paylaşılan bağıntı bağlamı aracılığıyla bağlanabilir ve işlemin tam akışını izlemenize olanak tanır.

Bu makale, her telemetri türüne özgü alanları kapsar. Herhangi bir telemetri türü için kullanılabilir alanların (bağlam alanları dahil) tam listesini görüntülemek için ilgili her tablonun altında sağlanan bağlantıyı izleyin.

Kullanılabilirlik telemetrisi

Kullanılabilirlik telemetrisi, testlerin uygulamanın kullanılabilir ve duyarlı olduğunu doğrulamak için kullanıcı etkileşimlerinin benzetimini yaptığı yapay izleme içerir. Uygulamanızın kullanılabilirliğini dünyanın çeşitli noktalarından izlemek ve Application Insights'a kendi test bilgilerinizi göndermek için standart kullanılabilirlik testleri ayarlamanızı öneririz.

Kullanılabilirliğe özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
id Id Zaman içinde belirli hataları veya desenleri izlemeye yardımcı olabilecek tek tek test yürütmeleri arasındaki bağıntı için kullanılan kullanılabilirlik testi sonucunun benzersiz tanımlayıcısı. Daha fazla bilgi için bkz. Application Insights'ta telemetri bağıntısı.
name Name Kullanılabilirlik testinin adı. Test oluşturulurken tanımlanır (örneğin, "Giriş sayfası ping testi").
location Location Kullanılabilirlik testinin yürütüldiği coğrafi konum veya veri merkezi bölgesi (örneğin, Batı ABD, Kuzey Avrupa). Bölgesel kesintileri veya gecikme sorunlarını belirlemeye yardımcı olur.
success Success Bu alan, kullanılabilirlik testinin başarılı olup olmadığını gösterir. Bu, testin başarılı olduğu ve true başarısız olduğu anlamına gelen boole değeridirfalse.
message Message Testin sonucuyla ilgili ayrıntıları içeren açıklayıcı bir ileti. Genellikle özel durum ayrıntılarını veya hata yanıtlarını içerir.
duration Duration Kullanılabilirlik testinin yürütülmesi için geçen süre. Performansı ölçmeye ve yanıt süresi sorunlarını belirlemeye yardımcı olur. Süre genellikle milisaniye cinsinden ölçülür.

Kullanılabilir tüm alanların listesi için bkz. AppAvailabilityResults.

Tarayıcı zamanlama telemetrisi

Tarayıcılar Performans API'siyle sayfa yükleme eylemleri için ölçümleri kullanıma sunar. Application Insights, ilgili zamanlamaları standart tarayıcı ölçümlerinde birleştirerek bu ölçümleri basitleştirir.

Tarayıcı zamanlamasına özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
networkDuration NetworkDurationMs İstemci, web sitesi ana bilgisayar adını çözümlemek için DNS'ye ulaşır ve DNS, IP adresiyle yanıt verir.

İstemci, web sunucusuyla TCP ve ardından TLS el sıkışmalarını başlatır.
sendDuration SendDurationMs İstemci istek yükünü gönderir, sunucunun isteği yürütmesini bekler ve ilk yanıt paketini alır.
receiveDuration ReceiveDurationMs İstemci, yanıt yükünün kalan baytlarını web sunucusundan alır.
processingDuration ProcessingDurationMs İstemci artık tam yanıt yüküne sahip ve içeriği tarayıcıda işleyip DOM'u yüklemelidir.
totalDuration TotalDurationMs Tüm tarayıcı zamanlamalarının toplamı.

Kullanılabilir tüm alanların listesi için bkz. AppBrowserTimings.

Bağımlılık telemetrisi

Bağımlılık telemetri öğesi, izlenen bileşenin SQL veya HTTP uç noktası gibi uzak bir bileşenle etkileşimini temsil eder.

Bağımlılıklara özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
id Id Bu bağımlılık çağrısına karşılık gelen istek telemetri öğesiyle bağıntı için kullanılan bağımlılık çağrısı örneğinin benzersiz tanımlayıcısı. Daha fazla bilgi için bkz. Application Insights'ta telemetri bağıntısı.
target Target Bağımlılık çağrısının hedef sitesi. Örnek olarak sunucu adı ve konak adresi verilebilir. Daha fazla bilgi için bkz. Application Insights'ta telemetri bağıntısı.
type DependencyType Bağımlılık türü adı. Bağımlılıkların mantıksal gruplandırılması ve ve commandNamegibi resultCode diğer alanların yorumlanması için düşük kardinalite değerine sahiptir. Örnek olarak SQL, Azure tablosu ve HTTP verilebilir.
name Name Bu bağımlılık çağrısıyla başlatılan komutun adı. Düşük kardinalite değerine sahiptir. Örnek olarak saklı yordam adı ve URL yolu şablonu verilebilir.
data Data Başlatılan komut, bu bağımlılık çağrısı tarafından tetiklenmiştir. Tüm sorgu parametrelerine sahip SQL deyimi ve HTTP URL'si örnek olarak verilebilir.
success Success Bu alan, aramanın başarılı olup olmadığını gösterir. Bu, çağrının başarılı olduğu ve true başarısız olduğu anlamına gelen boole değeridirfalse.
resultCode ResultCode Bağımlılık çağrısının sonuç kodu. Örnek olarak SQL hata kodu ve HTTP durum kodu verilebilir.
duration DurationMs İstek süresi biçimindedir DD.HH:MM:SS.MMMMMM. Gün içinde olmalı 1000 .

Kullanılabilir tüm alanların listesi için bkz. AppDependencies.

Olay telemetrisi

Uygulamanızda gerçekleşen bir olayı temsil etmek için olay telemetri öğeleri oluşturabilirsiniz. Genellikle, düğme tıklaması veya sipariş ödemesi gibi bir kullanıcı etkileşimidir. Başlatma veya yapılandırma güncelleştirmesi gibi bir uygulama yaşam döngüsü olayı da olabilir.

Özel olay telemetrisi oluşturma hakkında daha fazla bilgi edinmek için .NET, Java, Node.jsve Python uygulamaları için Azure İzleyici OpenTelemetry ekleme ve değiştirme başlıklı bölüme bakın.

Olaya özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
name Name Düzgün gruplandırmaya ve yararlı ölçümlere izin vermek için uygulamanızı birkaç ayrı olay adı oluşturacak şekilde kısıtlayın. Örneğin, bir olayın oluşturulan her örneği için ayrı bir ad kullanmayın.

Kullanılabilir tüm alanların listesi için bkz. AppEvents.

Özel durum telemetrisi

Özel durum telemetri öğesi, izlenen uygulamanın yürütülmesi sırasında oluşan işlenen veya işlenmeyen bir özel durumu temsil eder.

Özel duruma özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
problemId ProblemId Özel durumun kodda nerede oluşturulduğunı tanımlar. Özel durum gruplandırma için kullanılır. Genellikle bir özel durum türü ile çağrı yığınındaki bir işlevin birleşimidir.
type ExceptionType Oluşan özel durum türü. Bu genellikle System.NullReferenceException veya System.InvalidOperationException gibi ad alanını ve sınıf adını içerir.
assembly Assembly Özel durumun fırlatıldığı derleme. Bu, özel durumdan sorumlu uygulamanın bileşenini saptamak için yararlıdır.
method Method Özel durumun oluşturulduğu derleme içindeki yöntem adı. Bu, kodun neresinde hata oluştuğu hakkında bağlamsal bilgiler sağlar.
outerType OuterType Geçerli özel durum başka bir özel durumun içinde iç içe yer alıyorsa, dış (sarmalayan) özel durumun türü. Bu, iç özel durumun oluştuğu bağlamı anlamak için yararlıdır ve hata sırasını izlemeye yardımcı olabilir.
outerMessage OuterMessage Bu ileti dış özel durumun insan tarafından okunabilir bir açıklamasını sağlar ve daha geniş kapsamlı sorunu anlamanıza yardımcı olabilir.
outerAssembly OuterAssembly Harici istisnanın köken aldığı derleme.
outerMethod OuterMethod Dış istisnanın yöntemi. Bu, harici istisnadaki başarısızlık noktası hakkında ayrıntılı bilgi sağlar.
severityLevel SeverityLevel İzleme önem düzeyi şu değerlerden biri olabilir: Verbose, Information, Warning, Errorveya Critical.
details Details Özel durum iletisi ve çağrı yığını gibi özel durum bilgilerini içerir.

Kullanılabilir tüm alanların listesi için bkz. AppExceptions.

Ölçüm telemetrisi

Application Insights iki tür ölçüm telemetrisini destekler:

  • Tek bir ölçümünadı ve değeri vardır.
  • Önceden toplanmış ölçüm, 1 dakikalık toplama süresi içinde birden çok ölçüm alır.

Performans sayaçları

Performans sayaçları her zaman name ve value ile tek ölçüm metrikleridir, ancak ek alanlar category ve counter ile birlikte gelir ve Windows uygulamaları için instance de içerir.

Performans sayacına özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
name Name Application Insights portalında görmek istediğiniz ölçümün adı.
value Value Ölçüm için tek değer. Toplama için tek tek ölçümlerin toplamıdır.
category Category İlgili performans sayaçlarından oluşan bir grubu temsil eder (örneğin, Process).
counter Counter Bir kategori içinde ölçülen belirli performans ölçümünü belirtir (örneğin, IO Data Bytes/sec).
instance Instance Bir kategori içinde sayacın belirli bir oluşumunu tanımlar (örneğin, ??APP_WIN32_PROC??).

Kullanılabilir tüm alanların listesi için bkz. AppPerformanceCounters.

Ölçümler hakkında daha fazla bilgi edinmek için bkz. Application Insights'ta Ölçümler. Ölçümler REST API'si hakkında daha fazla bilgi için bkz Ölçümler - Getir.

Sistem ve işlem sayacı ölçümleri

.NET adı Açıklama
\Processor(_Total)\% Processor Time Toplam makine CPU'su.
\Memory\Available Bytes Bilgisayarda çalışan işlemler için kullanılabilen fiziksel bellek miktarını bayt cinsinden gösterir. Sıfırlanmış, boş ve bekleme bellek listelerinde yer alan miktarı toplanarak hesaplanır. Boş bellek kullanıma hazırdır. Sıfırlanmış bellek, sonraki işlemlerin önceki bir işlem tarafından kullanılan verileri görmesini önlemek için sıfırlarla doldurulmuş bellek sayfalarından oluşur. Bekleme belleği, bir işlemin çalışma kümesinden (fiziksel belleği) diske yönlendirilen ancak geri çağrılmaya devam edilebilen bellektir. Bkz. Bellek Nesnesi.
\Process(??APP_WIN32_PROC??)\% Processor Time Uygulamayı barındıran işlemin CPU'sunu seçin.
\Process(??APP_WIN32_PROC??)\Private Bytes Uygulamayı barındıran işlem tarafından kullanılan bellek.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec Uygulamayı barındıran işlem tarafından çalıştırılan G/Ç işlemlerinin oranı.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec Bir uygulama tarafından işlenen isteklerin oranı.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec Bir uygulama tarafından oluşan özel durumların oranı.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time Ortalama istek yürütme süresi.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue Kuyrukta işlemeyi bekleyen istek sayısı.

Özel özellikler

Özel özelliğin CustomPerfCounter ayarlandığı true ölçüm, ölçümün Windows performans sayacını temsil ettiğini gösterir. Bu ölçümler içine değil tabloya performanceCounterscustomMetricsyerleştirilir. Ayrıca, kategori, sayaç ve örnek adlarını ayıklamak için bu ölçümün adı ayrıştırılır.

Özel ölçümler

Özel ölçümler, standart ölçümler kapsamında olmayan içgörüler elde etmek için tanımladığınız ve topladığınız performans göstergeleri veya işletmeye özgü ölçümlerdir. Özel ölçümler hakkında daha fazla bilgi edinmek için bkz. Azure İzleyici'de özel ölçümler (önizleme).

Özel ölçüme özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Tek ölçüm Önceden toplanmış ölçüt
name Name Bu alan, Application Insights portalında ve kullanıcı arabiriminde görmek istediğiniz ölçümün adıdır.
value Value Bu alan, ölçü için tek değerdir. Toplama için tek tek ölçümlerin toplamıdır. Önceden toplanmış ölçüm için Değer, Toplam'a eşittir.
Max Max Tek bir ölçüm ölçümü için Max değeri Değer'e eşittir. Bu alan, toplanan ölçümün en büyük değeridir. Ölçüm için ayarlanmamalıdır.
Min Min Tek bir ölçüm ölçümü için Min değeri Değer'e eşittir. Bu alan, toplanan ölçümün en düşük değeridir. Ölçüm için ayarlanmamalıdır.
Sum Sum Tek bir ölçüm ölçümü için Toplam değeri Değer'e eşittir. Toplanan ölçümün tüm değerlerinin toplamı. Ölçüm için ayarlanmamalıdır.
Count Count Tek bir ölçüm ölçümü için Count şeklindedir 1. 1 dakikalık toplama süresindeki ölçülerin sayısı. Ölçüm için ayarlanmamalıdır.

Kullanılabilir tüm alanların listesi için bkz. AppMetrics.

Not

Ortalamayı hesaplamak için Toplam'ıSayı'ya bölün.

Sayfa görüntüleme telemetrisi

Bir uygulama kullanıcısı izlenen uygulamanın yeni bir sayfasını açtığında sayfa görünümü telemetri verileri günlüğe kaydedilir. Page Bu bağlamda, geliştirici tarafından uygulama sekmesi veya ekran olarak tanımlanan ve bir tarayıcı web sayfası yükü veya yenileme eylemiyle bağıntılı olması gerekmeyen bir mantıksal birimdir.

Bu ayrım, sayfalar arasındaki geçişin tarayıcı sayfası eylemlerine bağlı olmadığı tek sayfalı uygulamalar (SPA' lar) bağlamında daha fazla anlaşılabilir. pageViews.duration, uygulamanın sayfayı kullanıcıya sunma süresidir.

Sayfa görünümüne özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
name Name Kullanıcı tarafından görüntülenen sayfanın adı (örneğin, "Home" veya "Shopping Cart").
url Url Görüntülenen sayfanın tam URL'si. Bu alan, uygulama genelinde trafiği ve kullanıcı davranışını analiz etmek için çok önemlidir.
duration DurationMs Süre PageView , tarayıcının performans zamanlaması arabirimindendir PerformanceNavigationTiming.duration.

Kullanılabilir durumdaysa PerformanceNavigationTiming , bu süre kullanılır. Değilse, kullanım dışı bırakılmışPerformanceTiming arayüz kullanılır ve NavigationStart ile LoadEventEnd arasındaki delta hesaplanır.

Geliştirici, özel PageView olayları günlüğe kaydederken trackPageView API çağrısını kullanarak bir süre değeri belirtir.

Kullanılabilir tüm alanların listesi için bkz. AppPageViews.

Not

  • Varsayılan olarak, Application Insights JavaScript SDK'sı her tarayıcı web sayfası yükleme eyleminde, PageView ile doldurulan tek pageViews.duration olaylarını günlüğe kaydeder. Geliştiriciler PageView kullanarak olayların ek izlenmesini genişletebilir.

  • Varsayılan günlük saklama süresi 30 gündür. daha uzun bir süre boyunca istatistikleri görüntülemek PageView istiyorsanız, ayarı ayarlamanız gerekir.

Telemetri isteği

İstek telemetrisi, uygulamanıza gelen HTTP istekleriyle ilgili bilgileri temsil eder. Bu tür telemetri, uygulamanızın web tabanlı hizmetlerinin performansını ve başarısını izlemenize yardımcı olur. İstek telemetri öğesi, uygulamanıza yönelik bir dış istek tarafından tetiklenen mantıksal yürütme sırasını temsil eder. Her istek yürütme benzersiz bir id tarafından tanımlanır ve url tüm yürütme parametrelerini içerir.

İstekleri mantıksal name olarak gruplandırabilir ve bu isteğin türünü source tanımlayabilirsiniz. Kod yürütme işlemi veya ile sonuçlanabilir successfail ve belirli durationbir öğesine sahip olabilir. kullanarak resultCodebaşarı ve başarısızlık yürütmelerini daha fazla gruplandırabilirsiniz. İstek telemetrisinin başlangıç saati zarf düzeyinde tanımlanır. İstek telemetrisi , özel properties ve measurementskullanarak standart genişletilebilirlik modelini destekler.

İsteğe özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
id Id İstek ve diğer telemetri öğeleri arasındaki bağıntı için kullanılan bir istek çağrısı örneğinin benzersiz tanımlayıcısı. Kimlik genel olarak benzersiz olmalıdır. Daha fazla bilgi için bkz. Application Insights'ta telemetri bağıntısı.
source Source Kaynak, isteğin kaynağıdır. Arayanın izleme anahtarı veya çağıranın IP adresi örnek olarak verilebilir. Daha fazla bilgi için bkz. Application Insights'ta telemetri bağıntısı.
name Name Bu alan isteğin adıdır ve isteği işlemek için alınan kod yolunu temsil eder. Düşük kardinalite değeri, isteklerin daha iyi gruplandırılmasını sağlar. HTTP istekleri için, gerçek GET /values/{id} değer olmadan http id yöntemini ve URL yolu şablonunu temsil eder.
Application Insights web SDK'sı harf olayı hakkında "olduğu gibi" bir istek adı gönderir. Kullanıcı arabiriminde gruplandırma büyük/küçük harfe duyarlıdır, bu nedenle GET /Home/Index genellikle aynı denetleyici ve eylem yürütme ile sonuçlanmalarına rağmen ayrı GET /home/INDEX olarak sayılır. Bunun nedeni, genel olarak URL'lerin büyük/küçük harfe duyarlı olmasıdır. Büyük harfle yazılan URL'ler için tüm 404 hataların olup olmadığını görmek isteyebilirsiniz. web SDK'sı ASP.NET istek adı koleksiyonu hakkında daha fazla bilgiyi blog gönderisinde okuyabilirsiniz.
url Url URL, tüm sorgu dizesi parametrelerini içeren istek URL'sidir.
success Success Başarılı, bir çağrının başarılı mı yoksa başarısız mı olduğunu gösterir. Bu alan gereklidir. bir istek açıkça olarak falseolarak ayarlı olmadığında başarılı olduğu kabul edilir. Bir özel durum veya döndürülen hata sonucu kodu işlemi kesintiye uğratdıysa, bu değeri olarak falseayarlayın.

Web uygulamaları için Application Insights, yanıt kodu değerinden 400 küçük veya buna eşit 401olduğunda bir isteği başarılı olarak tanımlar. Ancak, bu varsayılan eşlemenin uygulamanın semantiğiyle eşleşmediği durumlar vardır.

Yanıt kodu 404 normal akışın parçası olabilecek "kayıt yok" ifadesini gösterebilir. Ayrıca bağlantının bozuk olduğunu da gösterebilir. Bozuk bağlantılar için daha gelişmiş mantık uygulayabilirsiniz. Bozuk bağlantıları yalnızca bu bağlantılar aynı sitede bulunduğunda URL başvuranı analiz ederek hata olarak işaretleyebilirsiniz. Ya da şirketin mobil uygulamasından erişildiğinde hata olarak işaretleyebilirsiniz. Benzer şekilde ve 301302 yeniden yönlendirmeyi desteklemeyen istemciden erişildiğinde başarısız olduğunu gösterir.

Kısmen kabul edilen içerik 206 , genel bir isteğin başarısız olduğunu gösterebilir. Örneğin, bir Application Insights uç noktası tek bir istek olarak bir toplu telemetri öğesi alabilir. Toplu işteki bazı öğeler başarıyla işlenmediğinde döndürür 206 . Oranının 206 artması, araştırılması gereken bir sorunu gösterir. Benzer mantık, başarının ayrı yanıt kodlarının en kötüsü olabileceği Çoklu Durum için 207 de geçerlidir.
resultCode ResultCode Yanıt kodu, istek yürütme işleminin sonucudur. HTTP istekleri için HTTP durum kodudur. Diğer istek türleri için bir HRESULT değer veya özel durum türü olabilir.
duration DurationMs İstek süresi olarak DD.HH:MM:SS.MMMMMMbiçimlendirilir. Pozitif ve günlerin altında 1000 olmalıdır. İstek telemetrisi işlemi başlangıç ve bitiş ile temsil ettiğinden bu alan gereklidir.

Kullanılabilir tüm alanların listesi için bkz. AppRequests.

Telemetriyi izleme

İzleme telemetrisi, metin içinde aranan printf tarzı izleme ifadelerini temsil eder. Log4Net, NLogve diğer metin tabanlı günlük dosyası girişleri bu tür örneklere çevrilir. İzlemenin genişletilebilirlik olarak ölçümleri yoktur.

İzlemeye özgü alanlar:

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
message Message İletiyi izleme.
severityLevel SeverityLevel İzleme önem düzeyi.

Kullanılabilir tüm alanların listesi için bkz. AppTraces.

Not

için severityLevel değerler numaralandırılır ve platforma özeldir.

Özel özellikler ve ölçümler

Özel özellikler

Özel özelliklerin ad-değer koleksiyonu: Bu koleksiyon, standart telemetriyi özel boyutlar ile genişletmek için kullanılır. Örnek olarak telemetri oluşturan dağıtım yuvası veya sipariş numarası gibi telemetriye özgü özellik verilebilir.

  • Maksimum anahtar uzunluğu: 150
  • Maksimum değer uzunluğu: 8.192

Özel ölçümler

Özel ölçüm koleksiyonu: Telemetri öğesiyle ilişkili adlandırılmış ölçümleri raporlamak için bu koleksiyonu kullanın. Tipik kullanım örnekleri şunlardır:

  • Bağımlılık telemetri yükünün boyutu.
  • İstek telemetrisi tarafından işlenen kuyruk öğelerinin sayısı.
  • Müşterinin olay telemetrisini tamamlayan sihirbaz adımını tamamlamak için geçen süre.

Application Analytics'te özel ölçümleri sorgulayabilirsiniz:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Not

  • Özel ölçümler, ait oldukları telemetri öğesiyle ilişkilendirilir. Bu ölçümleri içeren telemetri öğesiyle örneklemeye tabi tutulurlar. Değeri diğer telemetri türlerinden bağımsız olan bir ölçümü izlemek için ölçüm telemetrisini kullanın.
  • Özel ölçümler için dize değerlerini kullanmayın. Yalnızca sayısal değerler desteklenir.

Maksimum anahtar uzunluğu: 150

Bağlam

Her telemetri öğesinin kesin olarak belirlenmiş bir bağlam alanı olabilir. Her alan belirli bir izleme senaryosu sağlar. Özel veya uygulamaya özgü bağlam bilgilerini depolamak için özel özellikler koleksiyonunu kullanın.

Alan adı
(Application İzleme Bilgileri)
Alan adı
(Log Analitiği)
Açıklama
account_ID user_AccountId Çok kiracılı uygulamalarda hesap kimliği, kullanıcının birlikte hareket yaptığı kiracı hesabı kimliği veya adıdır. Kullanıcı kimliği ve kimliği doğrulanmış kullanıcı kimliği yeterli olmadığında daha fazla kullanıcı segmentasyonu için kullanılır. Örnek olarak Azure portalının abonelik kimliği veya bloglama platformunun blog adı verilebilir.
application_Version AppVersion Uygulama bağlamı alanlarındaki bilgiler her zaman telemetriyi gönderen uygulamayla ilgilidir. Uygulama sürümü, uygulama davranışındaki eğilim değişikliklerini ve dağıtımlarla bağıntısını analiz etmek için kullanılır.
appId ResourceGUID Telemetriyi farklı uygulamalardan ayırt etmek için Application Insights kaynağınız için benzersiz bir tanımlayıcı.
appName Mevcut Değil Application Insights'ta appName ile _ResourceId aynıdır.
client_Browser ClientBrowser İstemci tarafından kullanılan web tarayıcısının adı.
client_City ClientCity Telemetri toplandığında istemcinin bulunduğu şehir (IP coğrafi konumuna göre).
client_CountryOrRegion ClientCountryOrRegion Telemetri toplandığında istemcinin bulunduğu ülke veya bölge (IP coğrafi konumuna göre).
client_IP ClientIP İstemci cihazının IP adresi. IPv4 ve IPv6 desteklenir. Bir hizmetten telemetri gönderildiğinde, konum bağlamı hizmette işlemi başlatan kullanıcıyla ilgilidir. Application Insights, istemci IP'sinden coğrafi konum bilgilerini ayıklar ve sonra keser. İstemci IP'sini kullanıcı tarafından tanımlanabilir bilgiler olarak kullanamazsınız.
client_OS ClientOS Telemetriyi oluşturan istemcinin işletim sistemini gösterir.
client_StateorProvince ClientStateOrProvince Telemetri toplandığında istemcinin bulunduğu eyalet veya bölge (IP coğrafi konumuna göre).
client_Type ClientType Telemetriyi gönderen istemci cihazının türünü açıklar (örneğin, Browser veya PC.)
cloud_RoleInstance AppRoleInstance Uygulamanın çalıştığı örneğin adı. Örneğin, şirket içi için bilgisayar adı veya Azure'ın örnek adıdır.
cloud_RoleName AppRoleName Uygulamanın parçası olduğu rolün adı. Doğrudan Azure'daki rol adına eşler. Tek bir uygulamanın parçası olan mikro hizmetleri ayırt etmek için de kullanılabilir.
iKey IKey Telemetri verilerini belirli bir Application Insights kaynağıyla ilişkilendirmek için kullanılan eski benzersiz tanımlayıcı.
itemId Mevcut Değil Belirli bir telemetri öğesinin benzersiz tanımlayıcısı.
itemCount ItemCount Tek bir telemetri olayıyla ilişkili oluşumların veya sayıların sayısı.
operation_Id OperationId Kök işlemin benzersiz tanımlayıcısı. Bu tanımlayıcı, telemetriyi birden çok bileşen arasında gruplandırmanıza olanak tanır. Daha fazla bilgi için bkz . Telemetri bağıntısı. İşlem kimliğini bir istek veya sayfa görünümü oluşturur. Diğer tüm telemetriler bu alanı içeren istek veya sayfa görünümünün değerine ayarlar.
operation_Name OperationName İşlemin adı (grup). İşlem adını istek veya sayfa görünümü oluşturur. Diğer tüm telemetri öğeleri bu alanı içeren istek veya sayfa görünümünün değerine ayarlar. İşlem adı, bir işlem grubu için tüm telemetri öğelerini bulmak için kullanılır (örneğin, GET Home/Index). Bu bağlam özelliği, bu sayfada oluşan tipik özel durumlar nelerdir? gibi soruları yanıtlamak için kullanılır.
operation_ParentId ParentId Telemetri öğesinin doğrudan üst öğesinin benzersiz tanımlayıcısı. Daha fazla bilgi için bkz . Telemetri bağıntısı.
operation_SyntheticSource SyntheticSource Yapay kaynağın adı. Uygulamadan alınan bazı telemetriler yapay trafiği temsil edebilir. Web sitesini, site kullanılabilirlik testlerini veya Application Insights SDK'sının kendisi gibi tanılama kitaplıklarından izlemeleri dizine alan web gezgini olabilir.
sdkVersion SDKVersion Telemetri verilerini gönderen Application Insights SDK sürümü. Daha fazla bilgi için bkz. SDK sürümü.
session_Id SessionId Oturum Kimliği, kullanıcının uygulamayla etkileşiminin örneğidir. Oturum bağlamı alanlarındaki bilgiler her zaman kullanıcıyla ilgilidir. Bir hizmetten telemetri gönderildiğinde, oturum bağlamı hizmette işlemi başlatan kullanıcıyla ilgilidir.
user_AuthenticatedId UserAuthenticatedId Kimliği doğrulanmış kullanıcı kimliği, anonim kullanıcı kimliğinin tersidir. Bu alan, kolay ada sahip kullanıcıyı temsil eder. Bu kimlik yalnızca ASP.NET Framework SDK'sının AuthenticatedUserIdTelemetryInitializerile varsayılan olarak toplanır.

Kimliği doğrulanmış kullanıcı kimliğini tarayıcılar ve cihazlar arasında kalıcı olarak tanımlayan bir değerle başlatmak için Application Insights SDK'sını kullanın. Bu şekilde, tüm telemetri öğeleri bu benzersiz kimlikle ilişkilendirilir. Bu kimlik, belirli bir kullanıcı için toplanan tüm telemetriler için sorgulamayı etkinleştirir ( örnekleme yapılandırmalarına ve telemetri filtrelemesine tabidir).

Benzersiz telemetri boyutları sağlamak ve oturum süresi boyunca kullanıcı etkinliği oluşturmak için kullanıcı kimliklerine oturum kimlikleriyle çapraz başvuru yapılabilir.
user_Id UserId Anonim kullanıcı kimliği, uygulamanın kullanıcısını temsil eder. Bir hizmetten telemetri gönderildiğinde, kullanıcı bağlamı hizmette işlemi başlatan kullanıcıyla ilgilidir.

Örnekleme , toplanan telemetri miktarını en aza indirmeye yönelik tekniklerden biridir. Örnekleme algoritması tüm bağıntılı telemetri verilerini örneklemeye veya dışarı aktarmaya çalışır. Örnekleme puanı oluşturmak için anonim kullanıcı kimliği kullanılır, bu nedenle anonim kullanıcı kimliği rastgele yeterli bir değer olmalıdır.

Anonim kullanıcı kimliklerinin sayısı, benzersiz uygulama kullanıcılarının sayısıyla aynı değildir. Anonim kullanıcı kimliklerinin sayısı genellikle daha yüksektir çünkü kullanıcı uygulamanızı farklı bir cihazda veya tarayıcıda her açtığında veya tarayıcı tanımlama bilgilerini temizleyişinde yeni bir benzersiz anonim kullanıcı kimliği ayrılır. Bu hesaplama aynı fiziksel kullanıcıların birden çok kez sayılmasıyla sonuçlanabilir.

Benzersiz telemetri boyutları sağlamak ve oturum süresi boyunca kullanıcı etkinliği oluşturmak için kullanıcı kimliklerine oturum kimlikleriyle çapraz başvuru yapılabilir.

Kullanıcı adını depolamak için anonim bir kullanıcı kimliği kullanmak, alanın kötüye kullanılmasıdır. Kimliği doğrulanmış bir kullanıcı kimliği kullanın.
_ResourceId _ResourceId Application Insights bileşeninin abonelik, kaynak grubu ve kaynak adını içeren tam Azure Kaynak Kimliği.

Sonraki adımlar