Application Insights telemetri verileri modeli

Application Insights, uygulamanızın performansını ve kullanımını analiz edebilmeniz için web uygulamanızdan Azure portal telemetri gönderir. Telemetri modeli standartlaştırılmıştır, bu nedenle platform ve dilden bağımsız izleme oluşturmak mümkündür.

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

Uygulamanızın yürütülmesini izlemek için aşağıdaki telemetri türleri kullanılır. Web uygulaması çerçevesinin Application Insights SDK'sı şu üç türü otomatik olarak toplar:

• İstek: Uygulamanız tarafından alınan bir isteği günlüğe kaydetmek için oluşturulur. Örneğin, Application Insights web SDK'sı web uygulamanızın aldığı her HTTP isteği için otomatik olarak bir İstek telemetrisi öğesi oluşturur.

  İşlem, isteği işleyen yürütme iş parçacıklarından oluşur. Ayrıca, bir web işinde veya verileri düzenli aralıklarla işleyen bir işlevde "uyandırma" gibi diğer işlem türlerini izlemek için kod da yazabilirsiniz . Her işlemin bir kimliği vardır. Kimlik, uygulamanız isteği işlerken oluşturulan tüm telemetri verilerini gruplandırmak için kullanılabilir. Her işlem başarılı veya başarısız olur ve bir süreye sahiptir.

• Özel durum: Genellikle bir işlemin başarısız olmasına neden olan bir özel durumu temsil eder.

• Bağımlılık: Uygulamanızdan REST API veya SQL gibi bir dış hizmete veya depolamaya yapılan çağrıyı temsil eder. ASP.NET'de SQL'e yapılan bağımlılık çağrıları tarafından System.Datatanımlanır. HTTP uç noktalarına yapılan çağrılar tarafından System.Nettanımlanır.

Application Insights özel telemetri için üç veri türü sağlar:

• İzleme: veya gibi Log4Net size tanıdık gelen bir izleme çerçevesi kullanarak tanılama günlüğünü uygulamak için doğrudan veya System.Diagnosticsbir bağdaştırıcı aracılığıyla kullanılır.
• Olay: Kullanım desenlerini analiz etmek için genellikle hizmetinizle kullanıcı etkileşimini yakalamak için kullanılır.
• Ölçüm: Periyodik skaler ölçümleri raporlamak için kullanılır.

Her telemetri öğesi, uygulama sürümü veya kullanıcı oturumu kimliği gibi bağlam bilgilerini tanımlayabilir. Bağlam, belirli senaryoların engelini kaldıran kesin olarak belirlenmiş bir alan kümesidir. 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.

Bir kesintiyi veya kullanıcılar üzerindeki bir sorunu hesaplamak için oturum kimliğini kullanabilirsiniz. Belirli bir başarısız bağımlılık, hata izleme veya kritik özel durum için oturum kimliği değerlerinin ayrı sayısını hesaplamak, etkiyi iyi anlamanıza neden olur.

Application Insights telemetri modeli, telemetriyi parçası olduğu işlemle ilişkilendirmenin bir yolunu tanımlar. Örneğin, bir istek SQL Veritabanı çağrısı yapabilir ve tanılama bilgilerini kaydedebilir. Bunu istek telemetrisine geri bağlayan telemetri öğeleri için bağıntı bağlamını ayarlayabilirsiniz.

Şema geliştirmeleri

Application Insights veri modeli, uygulama telemetrinizi modellemenin temel ama güçlü bir yoludur. Temel senaryoları desteklemek ve şemanın gelişmiş kullanım için genişletilmesine izin vermek için modeli basit ve ince tutmaya çalışıyoruz.

Veri modeli veya şema sorunlarını ve önerilerini bildirmek için GitHub depomuzu kullanın.

İstek

Application Insights'taki bir istek 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 öğesini source tanımlayabilirsiniz. Kod yürütme işlemi veya fail ile success sonuçlanabilir 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.

Not

31 Mart 2025’te izleme anahtarı alımı desteği sona erecektir. İzleme anahtarı alımı çalışmaya devam edecek, ancak artık özellik için güncelleştirmeler veya destek sağlamayacağız. Yeni özelliklerden yararlanmak için bağlantı dizelerine geçiş.

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 id değer olmadan gibi GET /values/{id} HTTP 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ütmesine neden olsalar bile ayrı sayılır GET /home/INDEX . Bunun nedeni URL'lerin genel olarak büyük/küçük harfe duyarlı olmasıdır. Büyük harfle yazılan URL'lerde tüm 404 hataların olup olmadığını görmek isteyebilirsiniz. blog gönderisinde ASP.NET web SDK'sı tarafından istek adı koleksiyonu hakkında daha fazla bilgi edinebilirsiniz.

Maksimum uzunluk: 1.024 karakter

ID

Kimlik, bir istek çağrısı örneğinin tanımlayıcısıdır. İstek ve diğer telemetri öğeleri arasındaki bağıntı için kullanılır. Kimlik genel olarak benzersiz olmalıdır. Daha fazla bilgi için bkz. Application Insights'ta telemetri bağıntısı.

Maksimum uzunluk: 128 karakter

URL

URL, tüm sorgu dizesi parametrelerine sahip istek URL'sidir.

Maksimum uzunluk: 2.048 karakter

Kaynak

Kaynak, isteğin kaynağıdır. Örnek olarak çağıranın izleme anahtarı veya çağıranın IP adresi verilebilir. Daha fazla bilgi için bkz. Application Insights'ta telemetri bağıntısı.

Maksimum uzunluk: 1.024 karakter

Süre

İstek süresi olarak DD.HH:MM:SS.MMMMMMbiçimlendirilir. Pozitif ve günlerin 1000 altında olmalıdır. İstek telemetrisi işlemi başlangıç ve bitişle temsil ettiğinden bu alan gereklidir.

Yanıt kodu

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.

Maksimum uzunluk: 1.024 karakter

Başarılı

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ı olarak kabul edilir. Bir özel durum veya döndürülen hata sonuç kodu işlemi kesintiye uğratırsa, 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 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 url başvuranı analiz ederek bu bağlantılar aynı sitede bulunduğunda hata olarak işaretleyebilirsiniz. Ya da şirketin mobil uygulamasından erişildiğinde bunları hata olarak işaretleyebilirsiniz. Benzer şekilde ve 301302 yeniden yönlendirmeyi desteklemeyen istemciden erişildiğinde hata 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 grup 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 de geçerlidir 207 .

İstek sonuç kodu ve durum kodu hakkında daha fazla bilgiyi blog gönderisinde okuyabilirsiniz.

Ö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 üreten dağıtım yuvası veya sipariş numarası gibi telemetri-öğeye özgü özellik verilebilir.

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

Özel ölçümler

Özel ölçümlerin toplanması: 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 sihirbaz adımını tamamlayarak olay telemetrisini tamamlaması 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.

Maksimum anahtar uzunluğu: 150

Bağımlılık

Bağımlılık telemetrisi ( Application Insights'ta), izlenen bileşenin SQL veya HTTP uç noktası gibi uzak bir bileşenle etkileşimini temsil eder.

Name

Bu alan, bu bağımlılık çağrısıyla başlatılan komutun adıdır. Düşük kardinalite değerine sahiptir. Örnek olarak saklı yordam adı ve URL yolu şablonu verilebilir.

ID

Kimlik, bağımlılık çağrısı örneğinin tanımlayıcısıdır. Bu bağımlılık çağrısına karşılık gelen istek telemetri öğesiyle bağıntı için kullanılır. Daha fazla bilgi için bkz. Application Insights'ta telemetri bağıntısı.

Veriler

Bu alan, bu bağımlılık çağrısı tarafından başlatılan komutdur. Örnek olarak SQL deyimi ve tüm sorgu parametrelerine sahip HTTP URL'si verilebilir.

Tür

Bu alan, bağımlılık türü adıdır. Bağımlılıkların mantıksal gruplandırılması ve ve resultCodegibi commandName diğer alanların yorumlanması için düşük kardinalite değerine sahiptir. Örnek olarak SQL, Azure tablosu ve HTTP verilebilir.

Hedef

Bu alan, bağımlılık çağrısının hedef sitesidir. Örnek olarak sunucu adı ve ana bilgisayar adresi verilebilir. Daha fazla bilgi için bkz. Application Insights'ta telemetri bağıntısı.

Süre

İstek süresi biçimindedir DD.HH:MM:SS.MMMMMM. Günlerin altında 1000 olmalı.

Sonuç kodu

Bu alan, bağımlılık çağrısının sonuç kodudur. Örnek olarak SQL hata kodu ve HTTP durum kodu verilebilir.

Başarılı

Bu alan, başarılı veya başarısız bir çağrının göstergesidir.

Ö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 üreten dağıtım yuvası veya sipariş numarası gibi telemetri-öğeye özgü özellik verilebilir.

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

Özel ölçümler

Özel ölçümlerin toplanması: 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 sihirbaz adımını tamamlayarak olay telemetrisini tamamlaması 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.

Maksimum anahtar uzunluğu: 150

Özel durum

Application Insights'ta özel durum örneği, izlenen uygulamanın yürütülmesi sırasında oluşan işlenmiş veya işlenmeyen bir özel durumu temsil eder.

Sorun Kimliği

Sorun kimliği, ö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.

Maksimum uzunluk: 1.024 karakter

Önem derecesi

Bu alan, izleme önem derecesi düzeyidir. Değer , , InformationWarning, Errorveya CriticalolabilirVerbose.

Özel durum ayrıntıları

(Genişletilecek)

Ö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 üreten dağıtım yuvası veya sipariş numarası gibi telemetri-öğeye özgü özellik verilebilir.

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

Özel ölçümler

Özel ölçümlerin toplanması: 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 sihirbaz adımını tamamlayarak olay telemetrisini tamamlaması 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.

Maksimum anahtar uzunluğu: 150

İzleme

Application Insights'taki izleme telemetrisi, aranan metin stili izleme deyimlerini temsil ederprintf. Log4Net, NLogve diğer metin tabanlı günlük dosyası girişleri bu tür örneklere çevrilir. İzlemenin genişletilebilirlik olarak ölçümleri yoktur.

Message

İletiyi izleme.

Maksimum uzunluk: 32.768 karakter

Önem derecesi

İzleme önem düzeyi.

Değerler:Verbose, Information, Warning, Errorve Critical

Ö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 üreten dağıtım yuvası veya sipariş numarası gibi telemetri-öğeye özgü özellik verilebilir.

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

Olay

Uygulamanızda gerçekleşen bir olayı temsil etmek için olay telemetri öğeleri ( Application Insights'ta) 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.

Olaylar, eşanlamlı olarak isteklerle bağıntılı olabilir veya olmayabilir. Düzgün kullanılırsa, olay telemetrisi isteklerden veya izlemelerden daha önemlidir. Olaylar iş telemetrisini temsil eder ve ayrı, daha az agresif örneklemeye tabi olmalıdır.

Name

Olay adı: 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.

Uzunluk üst sınırı: 512 karakter

Ö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 üreten dağıtım yuvası veya sipariş numarası gibi telemetri-öğeye ö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 aldığı 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çümler, bu ölçümleri içeren telemetri öğesiyle örneklemeye tabi tutulur. Değeri diğer telemetri türlerinden bağımsız olan bir ölçümü izlemek için ölçüm telemetrisini kullanın.

Maksimum anahtar uzunluğu: 150

Ölçüm

Application Insights iki tür ölçüm telemetrisini destekler: tek ölçüm ve önceden toplanmış ölçüm. Tek ölçüm yalnızca bir ad ve değerdir. Önceden toplanmış ölçüm, toplama aralığındaki ölçümün en düşük ve en yüksek değerini ve standart sapması belirtir.

Önceden toplanmış ölçüm telemetrisi, toplama süresinin bir dakika olduğunu varsayar.

Application Insights birçok iyi bilinen ölçüm adını destekler. Bu ölçümler tabloya performanceCounters yerleştirilir.

Aşağıdaki tabloda sistem ve işlem sayaçlarını temsil eden ölçümler gösterilmektedir.

.NET adı	Platformdan bağımsız ad	Description
\Processor(_Total)\% Processor Time	Çalışma devam ediyor...	Toplam makine CPU's.
\Memory\Available Bytes	Çalışma devam ediyor...	Bilgisayarda çalışan işlemler için kullanılabilir fiziksel bellek miktarını bayt cinsinden gösterir. Sıfırlanmış, boş ve hazır bekleyen bellek listelerinde yer alan miktarı toplanarak hesaplanır. Boş bellek kullanıma hazı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 dolu 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	Çalışma devam ediyor...	Uygulamayı barındıran işlemin CPU'sunu.
\Process(??APP_WIN32_PROC??)\Private Bytes	Çalışma devam ediyor...	Uygulamayı barındıran işlem tarafından kullanılan bellek.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Çalışma devam ediyor...	Uygulamayı barındıran işlem tarafından çalıştırılan G/Ç işlemlerinin oranı.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Çalışma devam ediyor...	Uygulama tarafından işlenen isteklerin oranı.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Çalışma devam ediyor...	Uygulama tarafından oluşan özel durumların oranı.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Çalışma devam ediyor...	Ortalama istek yürütme süresi.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Çalışma devam ediyor...	Kuyrukta işleme için bekleyen istek sayısı.

Ölçümler REST API'si hakkında daha fazla bilgi için bkz . Ölçümler - Alma.

Name

Bu alan, Application Insights portalında ve kullanıcı arabiriminde görmek istediğiniz ölçümün adıdır.

Değer

Bu alan, ölçü için tek değerdir. Toplama için tek tek ölçümlerin toplamıdır.

Count

Bu alan, toplanan ölçümün ölçüm ağırlığıdır. Ölçüm için ayarlanmamalıdır.

Min

Bu alan, toplanan ölçümün en düşük değeridir. Ölçüm için ayarlanmamalıdır.

En yüksek değer

Bu alan, toplanan ölçümün en büyük değeridir. Ölçüm için ayarlanmamalıdır.

Standart sapma

Bu alan, toplanan ölçümün standart sapmasıdır. Ölçüm için ayarlanmamalıdır.

Özel özellikler

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

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

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

PageView

Bir uygulama kullanıcısı izlenen uygulamanın yeni bir sayfasını açtığında PageView telemetrisi ( Application Insights'ta) günlüğe kaydedilir. Page Bu bağlamda, geliştirici tarafından uygulama sekmesi veya ekran olarak tanımlanan mantıksal bir birimdir ve tarayıcı web sayfası yükü veya yenileme eylemiyle ilişkili olması gerekmez. 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.

Not

• Varsayılan olarak, Application Insights SDK'ları tarayıcı zamanlamasıylapageViews.duration doldurulan her tarayıcı web sayfası yükleme eyleminde tek olayları PageView günlüğe kaydeder. Geliştiriciler trackPageView API çağrısını kullanarak olayların ek izleme süresini PageView uzatabilir.
• 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.

Application Insights'ta tarayıcıyı ölçmeUygörüler'de en iyi duruma getirme

Modern tarayıcılar Performans API'siyle sayfa yükleme eylemleri için ölçümleri kullanıma sunar. Application Insights, bu işleme zamanı tanımları tarafından tanımlandığı şekilde ilgili zamanlamaları standart tarayıcı ölçümlerinde birleştirerek bu ölçümleri basitleştirir:

• İstemci <--> DNS: İstemci, web sitesi ana bilgisayar adını çözümlemek için DNS'ye ulaşır ve DNS, IP adresiyle yanıt verir.

• İstemci <--> Web Sunucusu: İstemci TCP oluşturur ve ardından web sunucusuyla TLS el sıkışmaları oluşturur.

• İstemci <--> Web Sunucusu: İstemci istek yükünü gönderir, sunucunun isteği yürütmesini bekler ve ilk yanıt paketini alır.

• İstemci <--Web Sunucusu: İstemci, yanıt yükünün kalan baytlarını web sunucusundan alır.

• İstemci: İstemci artık tam yanıt yüküne sahip ve içeriği tarayıcıya işleyip DOM'yi yüklemesi gerekiyor.

• browserTimings/networkDuration = #1 + #2

• browserTimings/sendDuration = #3

• browserTimings/receiveDuration = #4

• browserTimings/processingDuration = #5

• browsertimings/totalDuration = #1 + #2 + #3 + #4 + #5

• pageViews/duration

  • Süre PageView , tarayıcının performans zamanlaması arabiriminden PerformanceNavigationTiming.durationalınıyor.

  • Kullanılabilir durumdaysa PerformanceNavigationTiming , bu süre kullanılır.

    Yoksa, kullanım dışı bırakılmışPerformanceTiming arabirim kullanılır ve ile arasındaki NavigationStartLoadEventEnd delta hesaplanır.

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

Bağlam

Her telemetri öğesinin türü kesin 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.

Uygulama sürümü

Uygulama bağlamı alanlarındaki bilgiler her zaman telemetriyi gönderen uygulama hakkındadır. 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.

Maksimum uzunluk: 1.024

İstemci IP adresi

Bu alan, istemci cihazının IP adresidir. 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 bu bilgileri kesilir. İstemci IP'sini tek başına kullanıcı tarafından tanımlanabilir bilgiler olarak kullanamazsınız.

Maksimum uzunluk: 46

Cihaz Türü

Başlangıçta bu alan, uygulama kullanıcısının kullandığı cihazın türünü belirtmek için kullanılmıştır. Bugün öncelikle JavaScript telemetrisini cihaz türüyle sunucu tarafı telemetrisinden cihaz türüyle BrowserPCayırt etmek için kullanılır.

Maksimum uzunluk: 64

İşlem Kimliği

Bu alan, kök işlemin benzersiz tanımlayıcısıdır. Bu tanımlayıcı, telemetriyi birden çok bileşen arasında gruplandırmanızı sağlar. Daha fazla bilgi için bkz . Telemetri bağıntısı. İşlem kimliğini istek veya sayfa görünümü oluşturur. Diğer tüm telemetri verileri bu alanı, istek veya sayfa görünümünü içeren değere ayarlar.

Maksimum uzunluk: 128

Üst işlem kimliği

Bu alan, telemetri öğesinin hemen üst öğesinin benzersiz tanımlayıcısıdır. Daha fazla bilgi için bkz . Telemetri bağıntısı.

Maksimum uzunluk: 128

İşlem adı

Bu alan, işlemin adıdır (grup). İşlem adını istek veya sayfa görünümü oluşturur. Diğer tüm telemetri öğeleri bu alanı, istek veya sayfa görünümünü içeren değer olarak 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.

Maksimum uzunluk: 1.024

İşlemin yapay kaynağı

Bu alan yapay kaynağın adıdır. Uygulamadan alınan bazı telemetri 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.

Maksimum uzunluk: 1.024

Oturum Kimliği

Oturum Kimliği, kullanıcının uygulamayla etkileşiminin örneğidir. Oturum bağlamı alanlarındaki bilgiler her zaman kullanıcı hakkındadır. Bir hizmetten telemetri gönderildiğinde, oturum bağlamı hizmette işlemi başlatan kullanıcı hakkındadır.

Maksimum uzunluk: 64

Anonim kullanıcı kimliği

Anonim kullanıcı kimliği (User.Id) 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ı hakkındadır.

Ö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.

Not

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 bir 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 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.

Maksimum uzunluk: 128

Kimliği doğrulanmış kullanıcı kimliği

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 telemetri verilerinin sorgulanmasına olanak tanır ( örnekleme yapılandırmalarına ve telemetri filtrelemeye tabidir).

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

Maksimum uzunluk: 1.024

Hesap Kimliği

Ç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 abonelik kimliği veya blog oluşturma platformunun blog adı verilebilir.

Maksimum uzunluk: 1.024

Bulut rolü

Bu alan, uygulamanın parçası olduğu rolün adıdır. Doğrudan Azure'daki rol adıyla eşler. Tek bir uygulamanın parçası olan mikro hizmetleri ayırt etmek için de kullanılabilir.

Maksimum uzunluk: 256

Bulut rolü örneği

Bu alan, uygulamanın çalıştığı örneğin adıdır. Örneğin, şirket içi için bilgisayar adı veya Azure için örnek adıdır.

Maksimum uzunluk: 256

İç: SDK sürümü

Daha fazla bilgi için bkz. SDK sürümü.

Maksimum uzunluk: 64

İç: Düğüm adı

Bu alan faturalama amacıyla kullanılan düğüm adını temsil eder. Standart düğüm algılamasını geçersiz kılmak için bunu kullanın.

Maksimum uzunluk: 256

Sonraki adımlar

Aşağıdakiler de dahil olmak üzere özel olaylar ve ölçümler için Application Insights API'sini kullanmayı öğrenin:

• Özel istek telemetrisi
• Özel bağımlılık telemetrisi
• Özel izleme telemetrisi
• Özel olay telemetrisi
• Özel ölçüm telemetrisi

Bağımlılık izlemeyi ayarlayın:

• .NET
• Java

Daha fazlasını öğrenin:

• Application Insights tarafından desteklenen platformlara göz atın.
• Standart bağlam özellikleri toplama yapılandırmasını gözden geçirin.
• Application Insights'ta .NET izleme günlüklerini keşfedin.
• Application Insights'ta Java izleme günlüklerini keşfedin.
• İşlev yürütmelerini izlemek için Application Insights ile yerleşik Azure İşlevleri tümleştirmesi hakkında bilgi edinin.
• Application Insights ile bir ASP.NET Core uygulamasını yapılandırmayı öğrenin.
• Application Insights ile web uygulamalarınızdaki özel durumları tanılamayı öğrenin.
• Telemetriyi genişletmeyi ve filtrelemeyi öğrenin.
• Veri modeline göre telemetri miktarını en aza indirmek için örneklemeyi kullanın.