Canlı Ölçümler: 1 saniyelik gecikme süresiyle izleme ve tanılama

Application Analizler'daki Canlı Ölçümler'i (QuickPulse olarak da bilinir) kullanarak canlı, üretim içi web uygulamanızı izleyin. Hizmetinize herhangi bir rahatsızlık vermeden gerçek zamanlı olarak izlemek için ölçümleri ve performans sayaçlarını seçebilir ve filtreleyebilirsiniz. Örnek başarısız isteklerden ve özel durumlardan yığın izlemelerini de inceleyebilirsiniz. Profil Oluşturucu ve Anlık Görüntü Hata Ayıklayıcısı ile birlikte, Canlı Ölçümler canlı web siteniz için güçlü ve hiçvaziv olmayan bir tanılama aracı sağlar.

Not

Canlı Ölçümler yalnızca TLS 1.2'yi destekler. Daha fazla bilgi için bkz. Sorun giderme.

Canlı Ölçümler ile şunları yapabilirsiniz:

  • Performans ve hata sayılarını izleyerek yayınlanırken düzeltmeyi doğrulayın.
  • Test yüklemelerinin etkisini izleyin ve sorunları canlı olarak tanılayın.
  • İzlemek istediğiniz ölçümleri seçip filtreleyerek belirli test oturumlarına odaklanın veya bilinen sorunları filtreleyin.
  • Gerçekleşen özel durum izlemelerini alın.
  • En uygun KPI'leri bulmak için filtrelerle denemeler yapın.
  • Tüm Windows performans sayaçlarını canlı olarak izleyin.
  • Sorun yaşayan bir sunucuyu kolayca belirleyin ve tüm KPI/canlı akışı yalnızca o sunucuya filtreleyin.

Screenshot that shows the Live Metrics tab.

Canlı Ölçümler şu anda ASP.NET, ASP.NET Core, Azure İşlevleri, Java ve Node.js uygulamaları için desteklenmektedir.

Not

Canlı Ölçümler tarafından görüntülenen izlenen sunucu örneklerinin sayısı, uygulama için ayrılan gerçek örnek sayısından daha düşük olabilir. Bu uyuşmazlık, birçok modern web sunucusu kaynaklardan tasarruf etmek için belirli bir süre boyunca istek almayan uygulamaları kaldırır. Canlı Ölçümler yalnızca şu anda uygulamayı çalıştıran sunucuları saydığından, işlemi zaten kaldırmış olan sunucular bu toplama dahil edilmeyecektir.

Kullanmaya başlayın

Önemli

Uygulama Analizler etkinleştirmek için Azure portalında etkinleştirildiğinden ve uygulamanızın Application Analizler NuGet paketinin son sürümünü kullandığından emin olun. NuGet paketi olmadan Bazı telemetriLer Uygulama Analizler gönderilir, ancak bu telemetri Canlı Ölçümler'de gösterilmez.

  1. Canlı Ölçümleri etkinleştirmek için dile özgü yönergeleri izleyin:

  2. Azure portalında uygulamanızın Uygulama Analizler kaynağını açın. Ardından Canlı Akış'ı açın.

  3. Filtrelerinizde müşteri adları gibi hassas veriler kullanıyorsanız denetim kanalının güvenliğini sağlayın.

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

Herhangi bir .NET uygulaması için kod kullanarak Canlı Ölçümleri etkinleştirme

Not

Canlı Ölçümler, .NET uygulamaları için önerilen yönergeleri kullanarak eklediğinizde varsayılan olarak etkinleştirilir.

Canlı Ölçümleri el ile yapılandırmak için:

  1. NuGet paketini Microsoft.Application Analizler yükleyin. PerfCounterCollector.
  2. Aşağıdaki örnek konsol uygulaması kodu, Canlı Ölçümleri ayarlamayı gösterir:
using Microsoft.ApplicationInsights;
using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;

// Create a TelemetryConfiguration instance.
TelemetryConfiguration config = TelemetryConfiguration.CreateDefault();
config.InstrumentationKey = "INSTRUMENTATION-KEY-HERE";
QuickPulseTelemetryProcessor quickPulseProcessor = null;
config.DefaultTelemetrySink.TelemetryProcessorChainBuilder
    .Use((next) =>
    {
        quickPulseProcessor = new QuickPulseTelemetryProcessor(next);
        return quickPulseProcessor;
    })
    .Build();

var quickPulseModule = new QuickPulseTelemetryModule();

// Secure the control channel.
// This is optional, but recommended.
quickPulseModule.AuthenticationApiKey = "YOUR-API-KEY-HERE";
quickPulseModule.Initialize(config);
quickPulseModule.RegisterTelemetryProcessor(quickPulseProcessor);

// Create a TelemetryClient instance. It is important
// to use the same TelemetryConfiguration here as the one
// used to set up Live Metrics.
TelemetryClient client = new TelemetryClient(config);

// This sample runs indefinitely. Replace with actual application logic.
while (true)
{
    // Send dependency and request telemetry.
    // These will be shown in Live Metrics.
    // CPU/Memory Performance counter is also shown
    // automatically without any additional steps.
    client.TrackDependency("My dependency", "target", "http://sample",
        DateTimeOffset.Now, TimeSpan.FromMilliseconds(300), true);
    client.TrackRequest("My Request", DateTimeOffset.Now,
        TimeSpan.FromMilliseconds(230), "200", true);
    Task.Delay(1000).Wait();
}

Yukarıdaki örnek bir konsol uygulamasına yöneliktir, ancak aynı kod herhangi bir .NET uygulamasında kullanılabilir. Telemetriyi otomatik olarak almak için başka telemetri modülleri etkinleştirildiyse, bu modülleri başlatmak için kullanılan yapılandırmanın Canlı Ölçüm modülü için de kullanıldığından emin olmak önemlidir.

Canlı Ölçümler'in ölçüm gezgininden ve Log Analytics'ten farkı nedir?

Özellikler Canlı Akış Ölçüm gezgini ve Log Analytics
Gecikme süresi Bir saniye içinde görüntülenen veriler. Dakikalar içinde toplanır.
Bekletme yok Veriler grafik üzerindeyken devam eder ve sonra atılır. Veriler 90 gün boyunca saklanır.
İsteğe bağlı Veriler yalnızca Canlı Ölçümler bölmesi açıkken akışla aktarılır. SDK her yüklendiğinde ve etkinleştirildiğinde veriler gönderilir.
Ücretsiz Canlı Akış verileri için ücret alınmaz. Fiyatlandırmaya tabidir.
Örnekleme Seçilen tüm ölçümler ve sayaçlar iletilir. Hatalar ve yığın izlemeleri örneklenir. Olaylar örneklenebilir.
Denetim kanalı Filtre denetimi sinyalleri SDK'ya gönderilir. Bu kanalın güvenliğini sağlamanızı öneririz. İletişim, portala tek yönlüdür.

Ölçümlerinizi seçme ve filtreleme

Bu özellikler ASP.NET, ASP.NET Core ve Azure İşlevleri (v2) ile kullanılabilir.

Portaldan herhangi bir Uygulama Analizler telemetrisine rastgele filtreler uygulayarak özel KPI'yi canlı olarak izleyebilirsiniz. Grafiklerden herhangi birinin üzerine fareyle geçtiğinizi gösteren filtre denetimini seçin. Aşağıdaki grafik, URL ve Süre özniteliklerinde filtreler içeren özel bir İstek sayısı KPI'sı çizer. Filtrelerinizi, herhangi bir zamanda belirttiğiniz ölçütlerle eşleşen canlı telemetri akışını gösteren akış önizlemesi bölümüyle doğrulayın.

Screenshot that shows the Filter request rate.

Count değerinden farklı bir değeri izleyebilirsiniz. Seçenekler, istekler, bağımlılıklar, özel durumlar, izlemeler, olaylar veya ölçümler gibi herhangi bir Uygulama Analizler telemetrisi olabilecek akış türüne bağlıdır. Ayrıca kendi özel ölçümünüzü de kullanabilirsiniz.

Screenshot that shows the Query Builder on Request Rate with a custom metric.

Uygulama Analizler telemetrisiyle birlikte, herhangi bir Windows performans sayacını da izleyebilirsiniz. Akış seçeneklerinden seçin ve performans sayacının adını belirtin.

Canlı Ölçümler iki noktada toplanır: her sunucuda yerel olarak ve ardından tüm sunucularda. İlgili açılan listelerdeki diğer seçenekleri belirleyerek her ikisinde de varsayılanı değiştirebilirsiniz.

Örnek telemetri: Özel canlı tanılama olayları

Varsayılan olarak, olayların canlı akışı başarısız isteklerin ve bağımlılık çağrılarının, özel durumların, olayların ve izlemelerin örneklerini gösterir. Belirli bir noktada uygulanan ölçütleri görmek için filtre simgesini seçin.

Screenshot that shows the Filter button.

Ölçümlerde olduğu gibi, Uygulama Analizler telemetri türlerinden herhangi birine rastgele ölçütler belirtebilirsiniz. Bu örnekte belirli istek hataları ve olayları seçiyoruz.

Screenshot that shows the Query Builder.

Not

Şu anda, özel durum iletisi tabanlı ölçütler için en dıştaki özel durum iletisini kullanın. Yukarıdaki örnekte, iyi huylu özel durumu bir iç özel durum iletisiyle filtrelemek için ("<--" sınırlayıcısını izler) "İstemci bağlantısı kesildi", "İstek içeriği okunurken hata oluştu" ölçütünü içermeyen bir ileti kullanın.

Canlı akıştaki bir öğenin ayrıntılarını görmek için öğeyi seçin. Duraklat'ı seçerek veya aşağı kaydırıp bir öğe seçerek akışı duraklatabilirsiniz. Canlı akış, en üste geri kaydırdıktan sonra veya duraklatılırken toplanan öğelerin sayacını seçtiğinizde devam eder.

Screenshot that shows the Sample telemetry window with an exception selected and the exception details displayed at the bottom of the window.

Sunucu örneğine göre filtreleme

Belirli bir sunucu rolü örneğini izlemek istiyorsanız sunucuya göre filtreleyebilirsiniz. Filtrelemek için Sunucular'ın altında sunucu adını seçin.

Screenshot that shows the Sampled live failures.

Denetim kanalının güvenliğini sağlama

Canlı Ölçümler özel filtreleri, uygulamanızın telemetri verilerinin hangilerinin Azure portalındaki Canlı Ölçümler görünümüne akışla aktarılmış olduğunu denetlemenize olanak sağlar. Filtre ölçütleri, Uygulama Analizler SDK'sı ile izlenen uygulamalara gönderilir. Filtre değeri potansiyel olarak müşteri kimliği gibi hassas bilgiler içerebilir. Bu değerin güvenliğini sağlamak ve yetkisiz uygulamalara açıklanmasını önlemek için iki seçeneğiniz vardır:

  • Önerilen: Microsoft Entra kimlik doğrulamasını kullanarak Canlı Ölçüm kanalının güvenliğini sağlayın.
  • Eski (artık önerilmez): "Eski seçenek" bölümünde açıklandığı gibi gizli bir API anahtarı yapılandırarak kimliği doğrulanmış bir kanal ayarlayın.

Not

30 Eylül 2025'te, Canlı Ölçüm telemetrisini Application Analizler'a akışla aktarmak için kullanılan API anahtarları kullanımdan kaldırılacaktır. Bu tarihten sonra API anahtarlarını kullanan uygulamalar, Uygulama Analizler kaynağınıza Canlı Ölçüm verileri gönderemez. Application Analizler'a Canlı Ölçüm akışı için kimliği doğrulanmış telemetri alımı, Uygulama Analizler için Microsoft Entra kimlik doğrulaması ile yapılmalıdır.

Kimliği doğrulanmış bir kanal ayarlamak zorunda kalmadan özel filtreleri denemek mümkündür. Filtre simgelerinden herhangi birini seçin ve bağlı sunucuları yetkileyin. Bu seçeneği belirlerseniz, her yeni oturumda veya yeni bir sunucu çevrimiçi olduğunda bağlı sunucuları yetkilendirmeniz gerekir.

Uyarı

Güvenli olmayan kanalların kullanılmasını kesinlikle önerilmez ve kullanmaya başladıktan altı ay sonra bu seçeneği devre dışı bırakacağız. Bağlı sunucuları yetkile iletişim kutusunda bu seçeneğin devre dışı bırakılacağı tarih görüntülenir.

Screenshot that shows the Authorize connected servers dialog.

Eski seçenek: API anahtarı oluşturma

  1. API Erişimi sekmesini ve ardından API anahtarı oluştur'u seçin.

    Screenshot that shows selecting the API Access tab and the Create API key button.

  2. SDK denetim kanalı kimliğini doğrula onay kutusunu ve ardından Anahtar oluştur'a tıklayın.

    Screenshot that shows the Create API key pane. Select Authenticate SDK control channel checkbox and then select Generate key.

Yapılandırmaya API anahtarı ekleme

ASP.NET, ASP.NET Core, WorkerService ve Azure İşlevleri uygulamaları için yapılandırmaya bir API anahtarı ekleyebilirsiniz.

Program.cs dosyasına aşağıdaki ad alanını ekleyin:

using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;

Ardından aşağıdaki hizmet kaydını ekleyin:

// Existing code which includes services.AddApplicationInsightsTelemetry() to enable Application Insights.
builder.Services.ConfigureTelemetryModule<QuickPulseTelemetryModule> ((module, o) => module.AuthenticationApiKey = "YOUR-API-KEY-HERE");

ASP.NET Core uygulamalarını yapılandırma hakkında daha fazla bilgi için bkz . ASP.NET Core'da telemetri modüllerini yapılandırma.

WorkerService

WorkerService uygulamaları için bu yönergeleri izleyin.

Aşağıdaki ad alanını ekleyin:

using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;

Ardından, çağrısından services.AddApplicationInsightsTelemetryWorkerServiceönce aşağıdaki satırı ekleyin:

    services.ConfigureTelemetryModule<QuickPulseTelemetryModule> ((module, o) => module.AuthenticationApiKey = "YOUR-API-KEY-HERE");

WorkerService uygulamalarını yapılandırma hakkında daha fazla bilgi için bkz . WorkerServices'te telemetri modüllerini yapılandırma.

Azure İşlevleri uygulamaları

Azure İşlevleri uygulamaları (v2) için bir ortam değişkeni kullanarak kanalın güvenliğini API anahtarıyla sağlayabilirsiniz.

Uygulama Analizler kaynağınızın içinden bir API anahtarı oluşturun ve Azure İşlevleri uygulamanız için Ayarlar> Configuration bölümüne gidin. Yeni uygulama ayarı'naAPPINSIGHTS_QUICKPULSEAUTHAPIKEY tıklayın, adını girin ve API anahtarınıza karşılık gelen bir değer girin.

Desteklenen özellikler tablosu

Dil Temel ölçümler Performans ölçümleri Özel filtreleme Örnek telemetri İşleme göre CPU bölme
.NET Framework Desteklenen (LTS) Desteklenen (LTS) Desteklenen (LTS) Desteklenen (LTS) Desteklenen (LTS)
.NET Core (target=.NET Framework) Desteklenen (LTS) Desteklenen (LTS) Desteklenen (LTS) Desteklenen (LTS) Desteklenen (LTS)
.NET Core (target=.NET Core) Desteklenen (LTS) Destekleniyor* Desteklenen (LTS) Desteklenen (LTS) Desteklenmiyor
Azure İşlevleri v2 Desteklenir Desteklenir Desteklenir Desteklenir Desteklenmiyor
Java Desteklenen (V2.0.0+) Desteklenen (V2.0.0+) Desteklenmiyor Desteklenen (V3.2.0+) Desteklenmiyor
Node.js Desteklenen (V1.3.0+) Desteklenen (V1.3.0+) Desteklenmiyor Desteklenen (V1.3.0+) Desteklenmiyor
Python Desteklenmiyor Desteklenmiyor Desteklenmiyor Desteklenmiyor Desteklenmiyor

Temel ölçümler istek, bağımlılık ve özel durum oranını içerir. Performans ölçümleri (performans sayaçları) bellek ve CPU içerir. Örnek telemetri başarısız istekler ve bağımlılıklar, özel durumlar, olaylar ve izlemeler için ayrıntılı bilgi akışını gösterir.

PerfCounters desteği , .NET Framework'leri hedeflemeyen .NET Core sürümleri arasında biraz değişiklik gösterir:

  • Windows için Azure Uygulaması Hizmeti'nde (ASP.NET Core SDK sürüm 2.4.1 veya üzeri) çalışırken PerfCounters ölçümleri desteklenir.
  • PerfCounters, uygulama .NET Core LTS veya üzerini hedefleyen uygulamalar için herhangi bir Windows makinesinde çalıştırıldığında desteklenir.
  • PerfCounters, uygulama en son sürümlerde her yerde (Linux, Windows, Linux için app service veya kapsayıcılar gibi) çalıştığında desteklenir, ancak yalnızca .NET Core LTS veya üzerini hedefleyen uygulamalar için desteklenir.

Sorun giderme

Canlı Ölçümler, diğer Uygulama Analizler telemetrilerinden farklı IP adresleri kullanır. Bu IP adreslerinin güvenlik duvarınızda açık olduğundan emin olun. Ayrıca, sunucularınızın güvenlik duvarında Canlı Ölçümler için giden bağlantı noktalarının açık olup olmadığını denetleyin.

Azure TLS 1.2 geçiş duyurusunda açıklandığı gibi Canlı Ölçümler artık yalnızca TLS 1.2'yi destekliyor. TLS'nin eski bir sürümünü kullanıyorsanız Canlı Ölçümler herhangi bir veri görüntülemez. .NET Framework 4.5.1 tabanlı uygulamalar için, daha yeni TLS sürümünü desteklemek için bkz . İstemcilerde Aktarım Katmanı Güvenliği(TLS) 1.2'yi etkinleştirme - Configuration Manager .

.NET yapılandırması eksik

  1. Microsoft.Application Analizler NuGet paketinin en son sürümünü kullandığınızı doğrulayın. PerfCounterCollector.

  2. ApplicationInsights.config Dosyayı düzenleyin:

    • bağlantı dizesi kullandığınız Uygulama Analizler kaynağını işaret ettiğini doğrulayın.
    • QuickPulseTelemetryModule Yapılandırma seçeneğini bulun. Orada değilse ekleyin.
    • QuickPulseTelemetryProcessor Yapılandırma seçeneğini bulun. Orada değilse ekleyin.
    <TelemetryModules>
    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.
    QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector"/>
    </TelemetryModules>
    
    <TelemetryProcessors>
    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.
    QuickPulse.QuickPulseTelemetryProcessor, Microsoft.AI.PerfCounterCollector"/>
    </TelemetryProcessors>
    
  3. Uygulamayı yeniden başlatın.

"Verilere geçici olarak erişilemiyor" durum iletisi

Canlı Ölçümler'e gittiğinizde şu durum iletisini içeren bir başlık görebilirsiniz: "Verilere geçici olarak erişilemiyor. Durumumuzla ilgili güncelleştirmeler buraya https://aka.ms/aistatus gönderiliyor"

Azure durum sayfasının bağlantısını izleyin ve Uygulama Analizler etkileyen bir etkinleştirme kesintisi olup olmadığını denetleyin. Bir kesinti oluşmazsa güvenlik duvarlarının ve tarayıcı uzantılarının Canlı Ölçümlere erişimi engellemediğini doğrulayın. Örneğin, bazı popüler reklam engelleyici uzantıları ile *.monitor.azure.combağlantıları engeller. Canlı Ölçümlerin tüm özelliklerini kullanmak için reklam engelleyici uzantısını devre dışı bırakın veya reklam engelleyicinize, güvenlik duvarınıza etki alanı *.livediagnostics.monitor.azure.com için bir dışlama kuralı ekleyin.

beklenmeyen çok sayıda istek livediagnostics.monitor.azure.com

Uygulama Analizler SDK'ları, web uygulamanız için canlı ölçümler sağlayan QuickPulse uç noktalarıyla iletişim kurmak için REST API kullanır. VARSAYıLAN olarak SDK'lar, Azure portalında Canlı Ölçümler bölmesini görüntülenip görüntülenmediğini denetlemek için uç noktaları beş saniyede bir yoklar.

Canlı Ölçümler bölmesini açarsanız SDK'lar daha yüksek bir frekans moduna geçer ve her saniye QuickPulse'a yeni ölçümler gönderir. Bu, canlı uygulamanızı 1 saniyelik gecikme süresiyle izlemenize ve tanılamanıza olanak tanır, ancak aynı zamanda daha fazla ağ trafiği oluşturur. Normal trafik akışını geri yüklemek için Canlı Ölçümler bölmesinden uzağa gidin.

Not

SDK'lar tarafından QuickPulse uç noktalarına yapılan REST API çağrıları Uygulama Analizler tarafından izlenmez ve bağımlılık çağrılarınızı veya diğer ölçümleri etkilemez. Ancak, bunları diğer ağ izleme araçlarında görebilirsiniz.

Sonraki adımlar