Application Insights’tan telemetriyi dışarı aktarma

Telemetrinizi standart saklama süresinden daha uzun süre tutmak istiyor musunuz? Yoksa özel bir şekilde işlemek mi istiyorsunuz? Sürekli dışarı aktarma bu amaç için idealdir. Application Insights portalında gördüğünüz olaylar Azure'da JSON biçiminde depolama alanına aktarılabilir. Buradan verilerinizi indirebilir ve işlemek için ihtiyacınız olan kodu yazabilirsiniz.

Önemli

• 29 Şubat 2024'te klasik Application Insights'ın kullanım dışı kalmasıyla sürekli dışarı aktarma da kullanım dışı kalacaktır.
• Çalışma alanı tabanlı bir Application Insights kaynağına geçiş yaptığınızda, telemetri verilerini dışarı aktarmak için tanılama ayarlarını kullanmanız gerekir. Tüm çalışma alanı tabanlı Application Insights kaynaklarıtanılama ayarlarını kullanmalıdır.
• Tanılama ayarlarını dışarı aktarma maliyetleri artırabilir. Daha fazla bilgi için bkz . Tanılama ayarları tabanlı dışarı aktarma.

Sürekli dışarı aktarmayı ayarlamadan önce göz önünde bulundurmanız gereken bazı alternatifler vardır:

• Ölçümlerin veya arama sekmesinin en üstündeki Dışarı Aktar düğmesi, tabloları ve grafikleri Excel elektronik tablosuna aktarmanızı sağlar.
• Log Analytics , telemetri için güçlü bir sorgu dili sağlar. Ayrıca sonuçları dışarı aktarabilir.
• Verilerinizi Power BI'da keşfetmek istiyorsanız, çalışma alanı tabanlı bir kaynağa geçiş yaptıysanız sürekli dışarı aktarma kullanmadan bunu yapabilirsiniz.
• Veri Erişimi REST API'si telemetrinize program aracılığıyla erişmenizi sağlar.
• PowerShell aracılığıyla sürekli dışarı aktarma için kuruluma da erişebilirsiniz.

Sürekli dışarı aktarma işlemi verilerinizi depolama alanına kopyaladıktan sonra da istediğiniz kadar kalabilir. Her zamanki saklama süresi boyunca Application Insights'ta kullanılabilir.

Desteklenen bölgeler

Sürekli dışarı aktarma aşağıdaki bölgelerde desteklenir:

• Güneydoğu Asya
• Orta Kanada
• Orta Hindistan
• Kuzey Avrupa
• Güney Birleşik Krallık
• Doğu Avustralya
• Doğu Japonya
• Güney Kore - Orta
• Orta Fransa
• Doğu Asya
• Batı ABD
• Orta ABD
• Doğu ABD 2
• Orta Güney ABD
• Batı ABD 2
• Güney Afrika - Kuzey
• Orta Kuzey ABD
• Güney Brezilya
• Kuzey İsviçre
• Güneydoğu Avustralya
• Batı Birleşik Krallık
• Orta Batı Almanya
• Batı İsviçre
• Orta Avustralya 2
• Orta BAE
• Güneydoğu Brezilya
• Orta Avustralya
• Kuzey BAE
• Doğu Norveç
• Batı Japonya

Not

Sürekli dışarı aktarma, 23 Şubat 2021'den önce yapılandırılmışsa Doğu ABD ve Batı Avrupa'daki uygulamalar için çalışmaya devam edecektir. Yeni sürekli dışarı aktarma kuralları, doğu ABD veya Batı Avrupa'daki herhangi bir uygulamada, uygulama ne zaman oluşturulduğundan bağımsız olarak yapılandırılamaz.

Sürekli dışarı aktarma gelişmiş depolama yapılandırması

Sürekli dışarı aktarma aşağıdaki Azure Depolama özelliklerini veya yapılandırmalarını desteklemez :

• Azure Blob Depolama ile Azure Sanal Ağ/Azure Depolama güvenlik duvarlarının kullanımı.
• Azure Data Lake Storage 2. Nesil.

Sürekli dışarı aktarma oluşturma

Not

Bir uygulama günde 3 TB'tan fazla veri dışarı aktaramaz. Günde 3 TB'tan fazla dışarı aktarılırsa dışarı aktarma devre dışı bırakılır. Sınır olmadan dışarı aktarmak için tanılama ayarları tabanlı dışarı aktarmayı kullanın.

1. Sol taraftaki Yapılandır'ın altında uygulamanızın Application Insights kaynağında Sürekli dışarı aktarma'yı açın ve Ekle'yi seçin.

2. Dışarı aktarmak istediğiniz telemetri veri türlerini seçin.

3. Verileri depolamak istediğiniz bir Azure Depolama hesabı oluşturun veya seçin. Depolama fiyatlandırma seçenekleri hakkında daha fazla bilgi için Fiyatlandırma sayfasına bakın.

   Dışarı Aktarma hedef>Depolama hesabıekle'yi> seçin. Ardından yeni bir mağaza oluşturun veya mevcut bir mağazayı seçin.

   Uyarı

   Varsayılan olarak, depolama konumu Application Insights kaynağınızla aynı coğrafi bölgeye ayarlanır. Farklı bir bölgede depolarsanız aktarım ücretlerine tabi olabilirsiniz.

4. Depolama alanında bir kapsayıcı oluşturun veya seçin.

Not

Dışarı aktarma işleminizi oluşturduktan sonra yeni alınan veriler Azure Blob Depolama akmaya başlar. Sürekli dışarı aktarma yalnızca sürekli dışarı aktarma etkinleştirildikten sonra oluşturulan veya alınan yeni telemetri verilerini iletir. Sürekli dışarı aktarma etkinleştirilmeden önce var olan veriler dışarı aktarılamaz. Sürekli dışarı aktarmayı kullanarak daha önce oluşturulmuş verileri geriye dönük olarak dışarı aktarmanın desteklenen bir yolu yoktur.

Veriler depolama alanında görüntülenmeden önce yaklaşık bir saat gecikme olabilir.

İlk dışarı aktarma işlemi tamamlandıktan sonra Blob Depolama kapsayıcınızda aşağıdaki yapıyı bulacaksınız. (Bu yapı, topladığınız verilere bağlı olarak değişir.)

Ad	Açıklama
Kullanılabilirlik	Kullanılabilirlik web testlerini raporlar.
Olay	TrackEvent() tarafından oluşturulan özel olaylar.
Özel durumlar	Sunucuda ve tarayıcıda özel durumları raporlar.
İletiler	TrackTrace ve günlük bağdaştırıcıları tarafından gönderilir.
Ölçümler	Ölçüm API çağrıları tarafından oluşturulur.
PerformanceCounters	Application Insights tarafından toplanan Performans Sayaçları.
İstekler	TrackRequest tarafından gönderildi. Standart modüller, sunucuda ölçülen sunucu yanıt süresini bildirmek için istekleri kullanır.

Sürekli dışarı aktarmayı düzenleme

Sürekli dışarı aktarma'yı seçin ve düzenlenecek depolama hesabını seçin.

Sürekli dışarı aktarmayı durdurma

Dışarı aktarmayı durdurmak için Devre dışı bırak'ı seçin. Etkinleştir'i yeniden seçtiğinizde dışarı aktarma işlemi yeni verilerle yeniden başlatılır. Dışarı aktarma devre dışı bırakıldığı sırada portala gelen verileri almazsınız.

Dışarı aktarmayı kalıcı olarak durdurmak için silin. Bunu yaptığınızda verileriniz depolama alanından silinmez.

Dışarı aktarma ekleyemiyor veya değiştiremiyor musunuz?

Dışarı aktarmaları eklemek veya değiştirmek için Sahip, Katkıda Bulunan veya Application Insights Katkıda Bulunanı erişim izinleriniz olmalıdır. Roller hakkında bilgi edinin.

Hangi olayları alıyorsunuz?

Dışarı aktarılan veriler, istemci IP adresinden eklenen konum verileriyle uygulamanızdan aldığımız ham telemetridir.

Örnekleme tarafından atılan veriler dışarı aktarılan verilere dahil değildir.

Diğer hesaplanan ölçümler dahil değildir. Örneğin, ortalama CPU kullanımını dışarı aktarmayız, ancak ortalamanın hesaplandığı ham telemetriyi dışarı aktarırız.

Veriler, ayarladığınız kullanılabilirlik web testlerinin sonuçlarını da içerir.

Not

Uygulamanız çok fazla veri gönderiyorsa, örnekleme özelliği çalışabilir ve oluşturulan telemetrinin yalnızca bir bölümünü gönderebilir. Örnekleme hakkında daha fazla bilgi edinin.

Verileri inceleme

Depolama alanını doğrudan portalda inceleyebilirsiniz. En soldaki menüden Giriş'i seçin. Azure hizmetleri ifadesinin bulunduğu üst kısımda Depolama hesapları'nı seçin. Depolama hesabı adını seçin ve Genel Bakış sayfasında Hizmetler>Blobları'nı seçin. Son olarak kapsayıcı adını seçin.

Visual Studio'da Azure Depolama'yı incelemek içinBulut GezgininiGörüntüle'yi> seçin. Bu menü komutuna sahip değilseniz Azure SDK'yı yüklemeniz gerekir. Yeni Proje iletişim kutusunu açın, Visual C#/Cloud'u genişletin ve .NET için Microsoft Azure SDK Al'ı seçin.

Blob deponuzu açtığınızda, bir dizi blob dosyası içeren bir kapsayıcı görürsünüz. Application Insights kaynak adınızdan, izleme anahtarından ve telemetri türü, tarihi ve saatinden türetilen her dosyanın URI'sini görürsünüz. Kaynak adının tümü küçük harftir ve izleme anahtarı tireleri atlar.

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

Tarih ve saat UTC'dir ve telemetrinin oluşturulduğu saat değil depoya ne zaman depolandığıdır. Bu nedenle, verileri indirmek için kod yazarsanız veriler arasında doğrusal olarak hareket edebilir.

Yolun biçimi aşağıdadır:

$"{applicationName}_{instrumentationKey}/{type}/{blobDeliveryTimeUtc:yyyy-MM-dd}/{ blobDeliveryTimeUtc:HH}/{blobId}_{blobCreationTimeUtc:yyyyMMdd_HHmmss}.blob"

Konum:

• blobCreationTimeUtc blob'un iç hazırlama depolama alanında oluşturulduğu zamandır.
• blobDeliveryTimeUtc , blob'un dışarı aktarma hedef depolama alanına kopyalanma zamanıdır.

Veri biçimi

Veriler şu şekilde biçimlendirilir:

• Her blob, birden çok \nayrılmış satır içeren bir metin dosyasıdır. Yaklaşık yarım dakikalık bir zaman aralığında işlenen telemetriyi içerir.

• Her satır, istek veya sayfa görünümü gibi bir telemetri veri noktasını temsil eder.

• Her satır biçimlendirilmemiş bir JSON belgesidir. Satırları görüntülemek istiyorsanız, blobu Visual Studio'da açın veGelişmiş>Biçim DosyasınıDüzenle'yi> seçin.

  

Süreler, 10 000 değer çizgisi = 1 ms olan değer değerlerindedir. Örneğin, bu değerler tarayıcıdan istek göndermek için 1 ms, almak için 3 ms ve sayfayı tarayıcıda işlemek için 1,8 ms'lik bir zamanı gösterir:

"sendRequest": {"value": 10000.0},
"receiveRequest": {"value": 30000.0},
"clientProcess": {"value": 17970000.0}

Özellik türleri ve değerleri için ayrıntılı veri modeli başvurusu için bkz. Application Insights veri modelini dışarı aktarma.

Verileri işleme

Küçük bir ölçekte, verilerinizi ayırmak ve bir elektronik tabloda okumak için kod yazabilirsiniz. Örnek:

private IEnumerable<T> DeserializeMany<T>(string folderName)
{
   var files = Directory.EnumerateFiles(folderName, "*.blob", SearchOption.AllDirectories);
   foreach (var file in files)
   {
      using (var fileReader = File.OpenText(file))
      {
         string fileContent = fileReader.ReadToEnd();
         IEnumerable<string> entities = fileContent.Split('\n').Where(s => !string.IsNullOrWhiteSpace(s));
         foreach (var entity in entities)
         {
            yield return JsonConvert.DeserializeObject<T>(entity);
         }
      }
   }
}

Daha büyük bir kod örneği için bkz. Çalışan rolü kullanma.

Eski verilerinizi silme

Gerekirse depolama kapasitenizi yönetmek ve eski verileri silmek sizin sorumluluğunuzdadır.

Depolama anahtarınızı yeniden oluşturma

Depolamanızın anahtarını değiştirirseniz sürekli dışarı aktarma çalışmayı durdurur. Azure hesabınızda bir bildirim görürsünüz.

Sürekli Dışarı Aktarma sekmesini seçin ve dışarı aktarma işleminizi düzenleyin. Dışarı Aktarma Hedefi değerini düzenleyin, ancak aynı depolama alanını seçili bırakın. Onaylamak için Tamam’ı seçin.

Sürekli dışarı aktarma yeniden başlatılır.

Örnekleri dışarı aktarma

Dışarı aktarma örnekleri için bkz:

• Stream Analytics kullanarak SQL’ye aktarma
• Stream Analytics örneği 2

Daha büyük ölçeklerde, buluttaki HDInsight Hadoop kümelerini göz önünde bulundurun. HDInsight, büyük verileri yönetmek ve analiz etmek için çeşitli teknolojiler sağlar. Application Insights'tan dışarı aktarılan verileri işlemek için bunu kullanabilirsiniz.

Sık sorulan sorular

Bu bölümde sık sorulan soruların yanıtları sağlanır.

Grafiğin tek seferlik indirilmesini sağlayabilir miyim?

Bunu yapabilirsiniz. Sekmenin üst kısmında Verileri Dışarı Aktar'ı seçin.

Dışarı aktarmayı ayarladım, ancak mağazamda neden veri yok?

Dışarı aktarmayı ayarladıktan sonra Application Insights uygulamanızdan herhangi bir telemetri aldı mı? Yalnızca yeni veriler alırsınız.

Dışarı aktarmayı ayarlamaya çalıştım, ancak erişim neden reddedildi?

Hesap kuruluşunuza aitse Sahipler veya Katkıda Bulunanlar gruplarının üyesi olmanız gerekir.

Doğrudan kendi şirket içi mağazama aktarabilir miyim?

Hayır. Dışarı aktarma altyapımız şu anda yalnızca Azure Depolama ile çalışmaktadır.

Mağazama koyduğun veri miktarının herhangi bir sınırı var mı?

Hayır. Siz dışarı aktarmayı silene kadar verileri göndermeye devam edeceğiz. Blob Depolama için dış sınırlara ulaştıysak duracağız, ancak bu sınır çok büyük. Ne kadar depolama alanı kullandığınızı denetlemek size bağlı.

Depolamada kaç blob görmeli?

• Dışarı aktarmayı seçtiğiniz her veri türü için, veriler varsa dakikada bir yeni bir blob oluşturulur.
• Yüksek trafiğe sahip uygulamalar için ek bölüm birimleri ayrılır. Bu durumda her birim dakikada bir blob oluşturur.

Depolama alanımın anahtarını yeniden oluşturdum veya kapsayıcının adını değiştirdim, ancak dışarı aktarma işlemi neden çalışmıyor?

Dışarı aktarmayı düzenleyin ve Hedef sekmeyi dışarı aktar'ı seçin. Öncekiyle aynı depolama alanını seçili bırakın ve onaylamak için Tamam'ı seçin. Dışarı aktarma işlemi yeniden başlatılır. Değişiklik son birkaç gün içinde yapıldıysa verileri kaybetmezsiniz.

Dışarı aktarmayı duraklatabilir miyim?

Evet. Devre dışı bırak'ı seçin.

Kod örnekleri

• Stream Analytics örneği
• Stream Analytics kullanarak SQL'e aktarma
• Özellik türleri ve değerleri için ayrıntılı veri modeli başvurusu

Tanılama ayarları tabanlı dışarı aktarma

Ek özellikler sağladığından tanılama ayarlarını dışarı aktarma tercih edilir:

• Sanal ağlara, güvenlik duvarlarına ve özel bağlantılara sahip Azure Depolama hesapları.
• Azure Event Hubs'a aktarın.

Tanılama ayarlarını dışarı aktarma işlemi aşağıdaki yollarla sürekli dışarı aktarmadan farklıdır:

• Şema güncelleştirildi.
• Telemetri verileri toplu yüklemeler yerine geldikçe gönderilir.

Önemli

Depolama hesabı gibi hedefe yapılan çağrıların artması nedeniyle ek maliyetler tahakkuk edebilir.

Tanılama ayarlarını dışarı aktarmak için:

1. Klasik Application Insights'ta Tanılama Ayarlarını etkinleştirin.
2. Veri dışarı aktarmanızı yapılandırma: Tanılama ayarları> Application Insights kaynağınızdanTanılama ayarı ekle'yi seçin.
3. Yeni veri dışarı aktarma işleminizin Sürekli Dışarı Aktarma ile aynı şekilde yapılandırıldığını doğrulayın

Dikkat

Tanılama günlüklerini Log Analytics çalışma alanında depolamak istiyorsanız, Application Insights'ta yinelenen verileri görmemek için göz önünde bulundurmanız gereken iki nokta vardır:

• Hedef Application Insights kaynağınızın temel aldığı Log Analytics çalışma alanıyla aynı olamaz.
• Application Insights kullanıcısının her iki çalışma alanına da erişimi olamaz. Log Analytics erişim denetimi modunuÇalışma alanı izinleri gerekiyor olarak ayarlayın. Azure rol tabanlı erişim denetimi aracılığıyla kullanıcının yalnızca Application Insights kaynağının temel aldığı Log Analytics çalışma alanına erişimi olduğundan emin olun.

Application Insights eksiksiz ve uçtan uca işlemler ve doğru uygulama haritaları sağlamak için Log Analytics çalışma alanları dahil, Application Insight kaynakları genelinde telemetri verilerine eriştiğinden, bu adımlar gereklidir. Tanılama günlükleri aynı tablo adlarını kullandığından, kullanıcının aynı verileri içeren birden çok kaynağa erişimi varsa yinelenen telemetri verileri görüntülenebilir.

Application Insights Dışarı Aktarma Veri Modeli

Bu tabloda , Application Insights SDK'larından portala gönderilen telemetrinin özellikleri listelenir. Bu özellikleri Sürekli Dışarı Aktarma'dan alınan veri çıkışında görürsünüz. Bunlar, Ölçüm Gezgini ve Tanılama Arama'daki özellik filtrelerinde de görünür.

Dikkat edilmesi gereken hususlar:

• [0] bu tablolarda, yolda dizin eklemeniz gereken bir nokta gösterilir; ama her zaman 0 değildir.
• Süreler mikrosaniyenin onda biri cinsindendir, bu nedenle 100000000 == 1 saniyedir.
• Tarihler ve saatler UTC'dir ve ISO biçiminde verilir yyyy-MM-DDThh:mm:ss.sssZ

Örnek

// A server report about an HTTP request
{
  "request": [
    {
      "urlData": { // derived from 'url'
        "host": "contoso.org",
        "base": "/",
        "hashTag": ""
      },
      "responseCode": 200, // Sent to client
      "success": true, // Default == responseCode<400
      // Request id becomes the operation id of child events
      "id": "fCOhCdCnZ9I=",  
      "name": "GET Home/Index",
      "count": 1, // 100% / sampling rate
      "durationMetric": {
        "value": 1046804.0, // 10000000 == 1 second
        // Currently the following fields are redundant:
        "count": 1.0,
        "min": 1046804.0,
        "max": 1046804.0,
        "stdDev": 0.0,
        "sampledValue": 1046804.0
      },
      "url": "/"
    }
  ],
  "internal": {
    "data": {
      "id": "7f156650-ef4c-11e5-8453-3f984b167d05",
      "documentVersion": "1.61"
    }
  },
  "context": {
    "device": { // client browser
      "type": "PC",
      "screenResolution": { },
      "roleInstance": "WFWEB14B.fabrikam.net"
    },
    "application": { },
    "location": { // derived from client ip
      "continent": "North America",
      "country": "United States",
      // last octagon is anonymized to 0 at portal:
      "clientip": "168.62.177.0",
      "province": "",
      "city": ""
    },
    "data": {
      "isSynthetic": true, // we identified source as a bot
      // percentage of generated data sent to portal:
      "samplingRate": 100.0,
      "eventTime": "2016-03-21T10:05:45.7334717Z" // UTC
    },
    "user": {
      "isAuthenticated": false,
      "anonId": "us-tx-sn1-azr", // bot agent id
      "anonAcquisitionDate": "0001-01-01T00:00:00Z",
      "authAcquisitionDate": "0001-01-01T00:00:00Z",
      "accountAcquisitionDate": "0001-01-01T00:00:00Z"
    },
    "operation": {
      "id": "fCOhCdCnZ9I=",
      "parentId": "fCOhCdCnZ9I=",
      "name": "GET Home/Index"
    },
    "cloud": { },
    "serverDevice": { },
    "custom": { // set by custom fields of track calls
      "dimensions": [ ],
      "metrics": [ ]
    },
    "session": {
      "id": "65504c10-44a6-489e-b9dc-94184eb00d86",
      "isFirst": true
    }
  }
}

Bağlam

Tüm telemetri türlerine bir bağlam bölümü eşlik edilir. Bu alanların tümü her veri noktasıyla birlikte iletilmez.

Yol	Tür	Notlar
context.custom.dimensions [0]	object [ ]	Özel özellikler parametresi tarafından ayarlanan anahtar-değer dize çiftleri. Anahtar maksimum uzunluğu 100, değerler maksimum uzunluk 1024. 100'den fazla benzersiz değer, özelliği aranabilir ancak segmentlere ayırma için kullanılamaz. ikey başına en fazla 200 tuş.
context.custom.metrics [0]	object [ ]	Özel ölçümler parametresi ve TrackMetrics tarafından ayarlanan anahtar-değer çiftleri. Anahtar maksimum uzunluğu 100, değerler sayısal olabilir.
context.data.eventTime	string	UTC
context.data.isSynthetic	boolean	İstek bir bottan veya web testinden geliyor gibi görünüyor.
context.data.samplingRate	sayı	Portala gönderilen SDK tarafından oluşturulan telemetri yüzdesi. Aralık 0.0-100.0.
context.device	object	İstemci cihazı
context.device.browser	string	IE, Chrome, ...
context.device.browserVersion	string	Chrome 48.0, ...
context.device.deviceModel	string
context.device.deviceName	string
context.device.id	string
context.device.locale	string	en-GB, de-DE, ...
context.device.network	string
context.device.oemName	string
context.device.os	string
context.device.osVersion	string	Konak işletim sistemi
context.device.roleInstance	string	Sunucu konağı kimliği
context.device.roleName	string
context.device.screenResolution	string
context.device.type	string	Bilgisayar, Tarayıcı, ...
context.location	object	'den clientiptüretilmiştir.
context.location.city	string	biliniyorsa , 'den clientiptüretilir
context.location.clientip	string	Son sekizgen 0 olarak anonimleştirilmiştir.
context.location.continent	string
context.location.country	string
context.location.province	string	Eyalet veya il
context.operation.id	string	Aynı operation id öğeye sahip öğeler portalda İlgili Öğeler olarak gösterilir. Genellikle .request id
context.operation.name	string	url veya istek adı
context.operation.parentId	string	İç içe yerleştirilmiş ilgili öğelere izin verir.
context.session.id	string	Id aynı kaynaktan bir işlem grubu. İşlem yapılmadan 30 dakikalık bir süre oturumun sonuna işaret eder.
context.session.isFirst	boolean
context.user.accountAcquisitionDate	string
context.user.accountId	string
context.user.anonAcquisitionDate	string
context.user.anonId	string
context.user.authAcquisitionDate	string	Kimliği Doğrulanmış Kullanıcı
context.user.authId	string
context.user.isAuthenticated	boolean
context.user.storeRegion	string
internal.data.documentVersion	string
internal.data.id	string	Unique id Bir öğe Application Insights'a alındığında atanan

Ekinlikler

TrackEvent() tarafından oluşturulan özel olaylar.

Yol	Tür	Notlar
olay [0] sayısı	tamsayı	100/(örnekleme oranı). Örneğin 4 => %25.
olay [0] adı	string	Olay adı. Maksimum uzunluk 250.
event [0] url	string
olay [0] urlData.base	string
olay [0] urlData.host	string

Özel durumlar

Sunucuda ve tarayıcıda özel durumları raporlar.

Yol	Tür	Notlar
basicException [0] derlemesi	string
basicException [0] sayısı	tamsayı	100/(örnekleme oranı). Örneğin 4 => %25.
basicException [0] exceptionGroup	string
basicException [0] exceptionType	string
basicException [0] failedUserCodeMethod	string
basicException [0] failedUserCodeAssembly	string
basicException [0] handledAt	string
basicException [0] hasFullStack	boolean
basicException [0] id	string
basicException [0] yöntemi	string
basicException [0] iletisi	string	Özel durum iletisi. Maksimum uzunluk 10k.
basicException [0] outerExceptionMessage	string
basicException [0] outerExceptionThrownAtAssembly	string
basicException [0] outerExceptionThrownAtMethod	string
basicException [0] outerExceptionType	string
basicException [0] outerId	string
basicException [0] parsedStack [0] derlemesi	string
basicException [0] parsedStack [0] fileName	string
basicException [0] parsedStack [0] düzeyi	tamsayı
basicException [0] parsedStack [0] satırı	tamsayı
basicException [0] parsedStack [0] yöntemi	string
basicException [0] yığını	string	Maksimum uzunluk 10k
basicException [0] typeName	string

İletileri İzle

TrackTrace ve günlük bağdaştırıcıları tarafından gönderilir.

Yol	Tür	Notlar
message [0] loggerName	string
ileti [0] parametreleri	string
ileti [0] ham	string	Günlük iletisi, maksimum uzunluk 10k.
ileti [0] önem derecesiLevel	string

Uzak bağımlılık

TrackDependency tarafından gönderildi. Sunucudaki bağımlılıklara yapılan çağrıların ve tarayıcıdaki AJAX çağrılarının performansını ve kullanımını raporlamak için kullanılır.

Yol	Tür	Notlar
remoteDependency [0] zaman uyumsuz	boolean
remoteDependency [0] baseName	string
remoteDependency [0] commandName	string	Örneğin, "home/index"
remoteDependency [0] sayısı	tamsayı	100/(örnekleme oranı). Örneğin 4 => %25.
remoteDependency [0] dependencyTypeName	string	HTTP, SQL, ...
remoteDependency [0] durationMetric.value	sayı	Çağrıdan bağımlılığına göre yanıtın tamamlanmasına kadar olan süre
remoteDependency [0] id	string
remoteDependency [0] adı	string	Url. Maksimum uzunluk 250.
remoteDependency [0] resultCode	string	HTTP bağımlılığından
remoteDependency [0] başarılı	boolean
remoteDependency [0] türü	string	Http, Sql,...
remoteDependency [0] url	string	Maksimum uzunluk 2000
remoteDependency [0] urlData.base	string	Maksimum uzunluk 2000
remoteDependency [0] urlData.hashTag	string
remoteDependency [0] urlData.host	string	Maksimum uzunluk 200

İstekler

TrackRequest tarafından gönderildi. Standart modüller, sunucuda ölçülen sunucu yanıt süresini raporlamak için bunu kullanır.

Yol	Tür	Notlar
istek [0] sayısı	tamsayı	100/(örnekleme oranı). Örneğin: 4 => %25.
request [0] durationMetric.value	sayı	İsteğin yanıta varma süresi. 1e7 == 1s
istek [0] id	string	Operation id
request [0] name	string	GET/POST + url tabanı. Maksimum uzunluk 250
request [0] responseCode	tamsayı	İstemciye gönderilen HTTP yanıtı
istek [0] başarılı	boolean	Varsayılan == (responseCode < 400)
request [0] url	string	Konak dahil değil
request [0] urlData.base	string
request [0] urlData.hashTag	string
request [0] urlData.host	string

Sayfa Görünümü Performansı

Tarayıcı tarafından gönderilir. İsteği başlatan kullanıcıdan tamamlandı (zaman uyumsuz AJAX çağrıları hariç) görüntülemeye kadar bir sayfayı işleme süresini ölçer.

Bağlam değerleri istemci işletim sistemi ve tarayıcı sürümünü gösterir.

Yol	Tür	Notlar
clientPerformance [0] clientProcess.value	tamsayı	HTML alma işleminin sonundan sayfayı görüntülemeye kadar olan süre.
clientPerformance [0] adı	string
clientPerformance [0] networkConnection.value	tamsayı	Ağ bağlantısı kurmak için geçen süre.
clientPerformance [0] receiveRequest.value	tamsayı	İsteğin gönderilmesinin bitiminden HTML'nin yanıt olarak alınmasına kadar olan süre.
clientPerformance [0] sendRequest.value	tamsayı	HTTP isteğini göndermek için geçen süre.
clientPerformance [0] total.value	tamsayı	İsteğin gönderilmesinden sayfayı görüntülemeye kadar olan süre.
clientPerformance [0] url	string	Bu isteğin URL'si
clientPerformance [0] urlData.base	string
clientPerformance [0] urlData.hashTag	string
clientPerformance [0] urlData.host	string
clientPerformance [0] urlData.protocol	string

Sayfa Görüntülemeleri

trackPageView() veya stopTrackPage tarafından gönderildi

Yol	Tür	Notlar
görünüm [0] sayısı	tamsayı	100/(örnekleme oranı). Örneğin 4 => %25.
görünüm [0] durationMetric.value	tamsayı	değer isteğe bağlı olarak trackPageView() veya startTrackPage() - stopTrackPage() ile ayarlanır. clientPerformance değerleriyle aynı değildir.
görünüm [0] adı	string	Sayfa başlığı. Maksimum uzunluk 250
görünüm [0] url	string
view [0] urlData.base	string
view [0] urlData.hashTag	string
view [0] urlData.host	string

Kullanılabilirlik

Kullanılabilirlik web testlerini raporlar.

Yol	Tür	Notlar
kullanılabilirlik [0] availabilityMetric.name	string	availability
kullanılabilirlik [0] availabilityMetric.value	sayı	1.0 veya 0.0
kullanılabilirlik [0] sayısı	tamsayı	100/(örnekleme oranı). Örneğin 4 => %25.
kullanılabilirlik [0] dataSizeMetric.name	string
availability [0] dataSizeMetric.value	tamsayı
kullanılabilirlik [0] durationMetric.name	string
kullanılabilirlik [0] durationMetric.value	sayı	Test süresi. 1e7==1s
kullanılabilirlik [0] iletisi	string	Hata tanılama
kullanılabilirlik [0] sonucu	string	Başarılı/Başarısız
kullanılabilirlik [0] runLocation	string	Http req coğrafi kaynağı
availability [0] testName	string
kullanılabilirlik [0] testRunId	string
kullanılabilirlik [0] testTimestamp	string

Ölçümler

TrackMetric() tarafından oluşturulur.

Ölçüm değeri context.custom.metrics[0] içinde bulunur

Örnek:

{
  "metric": [ ],
  "context": {
  ...
    "custom": {
      "dimensions": [
        { "ProcessId": "4068" }
      ],
      "metrics": [
        {
          "dispatchRate": {
            "value": 0.001295,
            "count": 1.0,
            "min": 0.001295,
            "max": 0.001295,
            "stdDev": 0.0,
            "sampledValue": 0.001295,
            "sum": 0.001295
          }
        }
      ]  
    }
  }
}

Ölçüm değerleri hakkında

Hem ölçüm raporlarında hem de başka bir yerdeki ölçüm değerleri standart bir nesne yapısıyla bildirilir. Örnek:

"durationMetric": {
  "name": "contoso.org",
  "type": "Aggregation",
  "value": 468.71603053650279,
  "count": 1.0,
  "min": 468.71603053650279,
  "max": 468.71603053650279,
  "stdDev": 0.0,
  "sampledValue": 468.71603053650279
}

Şu anda bu durum gelecekte değişebilse de, standart SDK modüllerinden bildirilen tüm değerlerde count==1 ve yalnızca name ve value alanları yararlıdır. Farklı olabilecek tek durum, diğer parametreleri ayarladığınız kendi TrackMetric çağrılarınızı yazmanız olabilir.

Diğer alanların amacı, portala gelen trafiği azaltmak için ölçümlerin SDK'da toplanmasına izin vermektir. Örneğin, her ölçüm raporunu göndermeden önce birkaç ardışık okumanın ortalamasını alabilirsiniz. Ardından en düşük, en yüksek, standart sapma ve toplam değeri (toplam veya ortalama) hesaplar ve sayıyı raporun temsil ettiği okuma sayısına ayarlarsınız.

Yukarıdaki tablolarda min, max, stdDev ve sampledValue gibi nadiren kullanılan alan sayısını atladık.

Ölçümleri önceden toplama yerine telemetri hacmini azaltmanız gerekiyorsa örneklemeyi kullanabilirsiniz.

Süre

Aksi belirtilmediği durumlar dışında, süreler bir mikrosaniyenin onda biri cinsinden gösterilir, böylece 10000000.0 1 saniye anlamına gelir.

Ayrıca bkz.

• Uygulama Bilgileri
• Sürekli Dışarı Aktarma
• Kod örnekleri