Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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:
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 commandName gibi 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 , Error veya 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 performanceCounters
customMetrics
yerleş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 tekpageViews.duration
olaylarını günlüğe kaydeder. GeliştiricilerPageView
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 success
fail
ve belirli duration
bir öğesine sahip olabilir. kullanarak resultCode
baş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 measurements
kullanarak 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 false olarak 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 false ayarlayın.Web uygulamaları için Application Insights, yanıt kodu değerinden 400 küçük veya buna eşit 401 olduğ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 301 302 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.MMMMMM biç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
, NLog
ve 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 AuthenticatedUserIdTelemetryInitializer ile 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
- Sık sorulan soruları gözden geçirin (SSS): Telemetri veri modeli hakkında SSS
- Application Insights tarafından desteklenen platformlara göz atın.
- Azure İzleyici OpenTelemetry Distro kullanarak özel telemetri toplamayı öğrenin.
- Application Insights API'sini özel olaylar ve ölçümler için kullanmayı öğrenin.
- Telemetriyi genişletmeyi ve filtrelemeyi öğrenin.
- Veri modeline göre telemetri miktarını en aza indirmek için örneklemeyi kullanmayı öğrenin.