Application Insights telemetri verileri modeli

  • Makale

Uygulama Analizler, uygulamanızın performansını ve kullanımını analiz edebilmeniz için web uygulamanızdan Azure portalına 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 Analizler tarafından toplanan veriler bu tipik uygulama yürütme düzenini modeller.

Diagram that shows an Application Insights telemetry data model.

Uygulamanızın yürütülmesini izlemek için aşağıdaki telemetri türleri kullanılır. Web uygulaması çerçevesinin Application Analizler 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 Analizler web SDK'sı, web uygulamanızın aldığı her HTTP isteği için otomatik olarak bir İstek telemetrisi öğesi oluşturur.

    bir işlem , bir isteği işleyen yürütme iş parçacıklarından oluşur. Ayrıca, bir web işinde veya düzenli aralıklarla verileri işleyen 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 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.

Uygulama Analizler özel telemetri için üç veri türü sağlar:

  • İzleme: veya gibi Log4Net tanıdık 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: Genellikle kullanım düzenlerini analiz etmek için hizmetinizle kullanıcı etkileşimini yakalamak için kullanılır.
  • Ölçüm: Düzenli 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, Uygulama Analizler 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.

Uygulama Analizler 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. Bu telemetri öğelerini istek telemetrisine geri bağlayan bağıntı bağlamını ayarlayabilirsiniz.

Şema geliştirmeleri

Uygulama Analizler veri modeli, uygulama telemetrinizi modellemenin temel ama güçlü bir yoludur. 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.

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

İste

Uygulama Analizler 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 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.

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ştirme veya destek sağlamayacağız. Yeni özelliklerden yararlanmak için bağlantı dizesi geçiş.

Veri Akışı Adı

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 http GET /values/{id} yöntemini ve URL yolu şablonunu temsil eder.

Application Analizler 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.

Maksimum uzunluk: 1.024 karakter

Kimlik

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. Uygulama Analizler telemetri bağıntısı.

Maksimum uzunluk: 128 karakter

URL

URL, tüm sorgu dizesi parametrelerini içeren istek URL'sidir.

Maksimum uzunluk: 2.048 karakter

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. Uygulama Analizler telemetri bağıntısı.

Maksimum uzunluk: 1.024 karakter

Duration

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

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ı 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 Analizler, 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 Uygulama Analizler 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.

Ö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

Dependency

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

Veri Akışı Adı

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.

Kimlik

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. Uygulama Analizler telemetri bağıntısı.

Veri

Bu alan, bu bağımlılık çağrısı tarafından başlatılan komutdur. Tüm sorgu parametrelerine sahip SQL deyimi ve HTTP URL'si örnek olarak 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 konak adresi verilebilir. Daha fazla bilgi için bkz. Uygulama Analizler telemetri bağıntısı.

Duration

İstek süresi biçimindedir DD.HH:MM:SS.MMMMMM. Gün içinde olmalı 1000 .

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

Özel durum

Uygulama Analizler'nde özel durum örneği, izlenen uygulamanın yürütülmesi sırasında oluşan işlenen 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 düzeyidir. Değer , , Information, WarningErrorveya 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 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

İzleme

Application Analizler'daki izleme telemetrisi, aranan metin olan -style 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.

Mesaj

İ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 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

Etkinlik

Uygulamanızda gerçekleşen bir olayı temsil etmek için olay telemetri öğeleri (Uygulama Analizler) 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, olaylar isteklerle bağıntılı olabilir veya olmayabilir. Düzgün kullanıldığında, olay telemetrisi isteklerden veya izlemelerden daha önemlidir. Olaylar iş telemetrisini temsil eder ve ayrı, daha az agresif örneklemeye tabi olmalıdır.

Veri Akışı Adı

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.

Maksimum uzunluk: 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 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

Metric

Uygulama Analizler 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.

Uygulama Analizler 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 Açıklama
\Processor(_Total)\% Processor Time Çalışma devam ediyor... Toplam makine CPU'su.
\Memory\Available Bytes Çalışma devam ediyor... 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 Çalışma devam ediyor... Uygulamayı barındıran işlemin CPU'sunu seçin.
\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... Bir uygulama tarafından işlenen isteklerin oranı.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec Çalışma devam ediyor... Bir 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şlemeyi bekleyen istek sayısı.

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

Veri Akışı Adı

Bu alan, Uygulama Analizler 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.

Sayı

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.

Maks

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ğ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 ö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

PageView

PageView telemetrisi (Uygulama Analizler) bir uygulama kullanıcısı izlenen uygulamanın yeni bir sayfasını açtığında 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.

Not

  • Varsayılan olarak, Uygulama Analizler SDK'ları her tarayıcı web sayfası yükleme eyleminde tek olayları PageView günlüğe kaydeder ve tarayıcı zamanlaması ile pageViews.durationdoldurulur. Geliştiriciler trackPageView API çağrısını kullanarak olayların ek izlenmesini PageViewgeniş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.

Uygulama Analizler'de tarayıcıyı ölçme

Modern tarayıcılar Performans API'siyle sayfa yükleme eylemleri için ölçümleri kullanıma sunar. Uygulama Analizler, ilgili zamanlamaları bu işleme zamanı tanımları tarafından tanımlandığı şekilde 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ışması gerçekleştirir.

  • İ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 sahiptir ve içeriği tarayıcıda işleyip DOM'yi yüklemesi gerekir.

  • browserTimings/networkDuration = #1 + #2

  • browserTimings/sendDuration = #3

  • browserTimings/receiveDuration = #4

  • browserTimings/processingDuration = #5

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

  • pageViews/duration

Screenshot that shows the Metrics page in Application Insights showing graphic displays of metrics data for a web application.

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.

Uygulama sürümü

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.

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. Uygulama Analizler istemci IP'sinden coğrafi konum bilgilerini ayıklar ve sonra bu bilgileri kesilir. İstemci IP'sini kullanıcı tarafından tanımlanabilir bilgiler olarak kullanamazsınız.

Maksimum uzunluk: 46

Cihaz türü

Başlangıçta bu alan, uygulamanın kullanıcısının kullandığı cihazın türünü belirtmek için kullanılmıştır. Bugün, 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ı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.

Maksimum uzunluk: 128

Üst işlem kimliği

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

Maksimum uzunluk: 128

Operasyon 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ı 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.

Maksimum uzunluk: 1.024

İşlemin sentetik kaynağı

Bu alan, yapay kaynağın adıdır. Uygulamadan alınan bazı telemetriler yapay trafiği temsil edebilir. Web sitesini, site kullanılabilirlik testlerini veya Uygulama Analizler SDK'sı 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ıyla ilgilidir. Bir hizmetten telemetri gönderildiğinde, oturum bağlamı hizmette işlemi başlatan kullanıcıyla ilgilidir.

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

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

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 Uygulama Analizler 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.

Maksimum uzunluk: 1.024

Hesap Kodu

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

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ına 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'ın ö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. Düğümlerin standart algılamasını geçersiz kılmak için bunu kullanın.

Maksimum uzunluk: 256

Sık sorulan sorular

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

İzleme kampanyasının etkisini nasıl ölçebilirim?

PageView Telemetrisi URL içerir ve Kusto'da bir regex işlevi kullanarak UTM parametresini ayrıştırabilirsiniz.

Bazen, kullanıcı veya kuruluş tarayıcı ayarlarında Kullanıcı Aracısı göndermeyi devre dışı bırakırsa bu veriler eksik veya yanlış olabilir. UA Ayrıştırıcısı kayıt defteri tüm cihaz bilgilerini içermeyebilir. Veya Uygulama Analizler en son güncelleştirmeleri benimsememiş olabilir.

Özel bir ölçüm neden hatasız başarılı olur ama günlük gösterilmez?

Dize değerleri kullanıyorsanız bu durum oluşabilir. Yalnızca sayısal değerler özel ölçümlerle çalışır.

Sonraki adımlar

Özel olaylar ve ölçümler için Uygulama Analizler API'sini kullanmayı öğrenin, örneğin:

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

Daha fazlasını öğrenin: