A .NET számlálói az Application Insightsban

A Windows különböző teljesítményszámlálókat biztosít, például a processzor-, memória- és lemezhasználati statisztikák gyűjtéséhez használtakat. Saját teljesítményszámlálókat is definiálhat.

Az alkalmazás támogatja a teljesítményszámláló gyűjtését, ha az Internet Information Server (IIS) alatt fut egy helyszíni gazdagépen vagy rendszergazdai hozzáféréssel rendelkező virtuális gépen. Az Azure Web Apps-ként futó alkalmazások nem férhetnek hozzá közvetlenül a teljesítményszámlálókhoz, de az Application Insights összegyűjti az elérhető számlálók egy részét.

Előfeltételek

Adjon engedélyt az alkalmazáskészlet szolgáltatásfiókjának a teljesítményszámlálók figyelésére a Teljesítményfigyelő felhasználók csoportjához való hozzáadásával.

net localgroup "Performance Monitor Users" /add "IIS APPPOOL\NameOfYourPool"

Számlálók megtekintése

A Metrikák panelen a teljesítményszámlálók alapértelmezett készlete látható.

Alapértelmezett számlálók ASP.NET webalkalmazásokhoz:

• %Process\Processor Time
• % Process\Processor Time Normalized
• Memória\Rendelkezésre álló bájtok
• ASP.NET kérések/mp
• .NET Common Language Runtime (CLR) – Kivételek másodpercenként
• ASP.NET ApplicationsRequest végrehajtási ideje
• Process\Private Bytes
• Process\IO Data Bytes/sec
• ASP.NET Alkalmazások\Kérelmek az alkalmazássorban
• Processzor(_Total)\% Processzoridő

Alapértelmezett számlálók ASP.NET Core-webalkalmazásokhoz:

• %Process\Processor Time
• % Process\Processor Time Normalized
• Memória\Rendelkezésre álló bájtok
• Process\Private Bytes
• Process\IO Data Bytes/sec
• Processzor(_Total)\% Processzoridő

Számlálók hozzáadása

Ha a kívánt teljesítményszámláló nem szerepel a metrikák listájában, felveheti.

1. A helyi kiszolgálón található PowerShell-paranccsal megtudhatja, hogy mely számlálók érhetők el a kiszolgálón:

   Get-Counter -ListSet *
   

   További információ: Get-Counter.

2. Nyílt ApplicationInsights.config.

   Ha a fejlesztés során hozzáadta az Application Insightst az alkalmazáshoz:

   1. Szerkesztés ApplicationInsights.config a projektben.
   2. Helyezze újra üzembe a kiszolgálókon.

3. A teljesítménygyűjtő irányelvének szerkesztése:

   
       <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.PerformanceCollectorModule, Microsoft.AI.PerfCounterCollector">
         <Counters>
           <Add PerformanceCounter="\Objects\Processes"/>
           <Add PerformanceCounter="\Sales(photo)\# Items Sold" ReportAs="Photo sales"/>
         </Counters>
       </Add>
   

A saját maga által implementálva használt standard számlálókat és számlálókat is rögzítheti. \Objects\Processes Egy példa egy szabványos számlálóra, amely minden Windows rendszeren elérhető. \Sales(photo)\# Items Sold Egy példa egy webszolgáltatásban implementálható egyéni számlálóra.

A formátum , \Category(instance)\Countervagy olyan kategóriák esetén, amelyek nem rendelkeznek példányokkal, csak \Category\Counter.

A ReportAs paraméter olyan számlálónevekhez szükséges, amelyek nem egyeznek [a-zA-Z()/-_ \.]+.

Ha megad egy példányt, az a jelentett metrika dimenziójává CounterInstanceName válik.

Teljesítményszámlálók gyűjtése ASP.NET webalkalmazások vagy .NET/.NET Core-konzolalkalmazások kódjában

A rendszerteljesítmény-számlálók gyűjtéséhez és az Application Insightsba való elküldéséhez a következő kódrészletet módosíthatja:

    var perfCollectorModule = new PerformanceCollectorModule();
    perfCollectorModule.Counters.Add(new PerformanceCounterCollectionRequest(
      @"\Process([replace-with-application-process-name])\Page Faults/sec", "PageFaultsPerfSec"));
    perfCollectorModule.Initialize(TelemetryConfiguration.Active);

Vagy ugyanezt megteheti a létrehozott egyéni metrikákkal is:

    var perfCollectorModule = new PerformanceCollectorModule();
    perfCollectorModule.Counters.Add(new PerformanceCounterCollectionRequest(
      @"\Sales(photo)\# Items Sold", "Photo sales"));
    perfCollectorModule.Initialize(TelemetryConfiguration.Active);

Teljesítményszámlálók gyűjtése ASP.NET Core-webalkalmazások kódjában

Konfigurálás PerformanceCollectorModule a metódus után a WebApplication.CreateBuilder() következőben Program.cs:

using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddApplicationInsightsTelemetry();

// The following configures PerformanceCollectorModule.

builder.Services.ConfigureTelemetryModule<PerformanceCollectorModule>((module, o) =>
    {
        // The application process name could be "dotnet" for ASP.NET Core self-hosted applications.
        module.Counters.Add(new PerformanceCounterCollectionRequest(@"\Process([replace-with-application-process-name])\Page Faults/sec", "DotnetPageFaultsPerfSec"));
    });

var app = builder.Build();

ASP.NET és Application Insights-számok

A következő szakaszok a ASP.NET és az Application Insights számát ismertetik.

Azure App Service-beli Azure-webalkalmazásokban és Windows-tárolókban futó alkalmazások teljesítményszámlálói

Az Azure Web Appsben üzembe helyezett ASP.NET és ASP.NET Core-alkalmazások speciális tesztkörnyezetben futnak. A Azure-alkalmazás szolgáltatásban üzembe helyezett alkalmazások használhatnak Windows-tárolót, vagy tesztkörnyezetben üzemeltethetők. Ha az alkalmazás windowsos tárolóban van üzembe helyezve, a tároló lemezképében minden standard teljesítményszámláló elérhető.

A tesztkörnyezet nem teszi lehetővé a rendszerteljesítmény-számlálók közvetlen elérését. A számlálók korlátozott részhalmaza azonban környezeti változóként jelenik meg a környezeti változóként közzétett Perf Számlálókban leírtak szerint. Ebben a környezetben csak a számlálók egy részhalmaza érhető el. A teljes listát a környezeti változókként közzétett perf számlálókban találja.

A ASP.NET és ASP.NET Core-hoz készült Application Insights SDK észleli, hogy a kód webalkalmazásban vagy nem Windows-tárolóban van-e üzembe helyezve. Az észlelés meghatározza, hogy a tesztkörnyezetben gyűjti-e a teljesítményszámlálókat, vagy windowsos tárolón vagy virtuális gépen üzemeltetve használja-e a standard gyűjtési mechanizmust.

Teljesítményszámlálók ASP.NET Core-alkalmazásokban

A ASP.NET Core teljesítményszámlálóinak támogatása korlátozott:

• A 2.4.1-s és újabb SDK-verziók teljesítményszámlálókat gyűjtenek, ha az alkalmazás az Azure Web Appsben (Windows) fut.
• A 2.7.1-s és újabb SDK-verziók teljesítményszámlálókat gyűjtenek, ha az alkalmazás Windows rendszerben és célokban vagy újabb verziókban NETSTANDARD2.0 fut.
• A .NET-keretrendszer megcélzott alkalmazások esetében az SDK minden verziója támogatja a teljesítményszámlálókat.
• Az SDK 2.8.0-s és újabb verziói támogatják a Cpu/Memória számlálót Linuxon. A Linux nem támogat más számlálót. Ha rendszerszámlálókat szeretne lekérni Linuxon (és más nem Windows-környezetekben), használjon eseményszámlálókat.

EventCounter .NET/.NET Core-mechanizmus számlálók vagy statisztikák közzétételére és felhasználására. Az EventCounters minden operációsrendszer-platformon támogatott – Windows, Linux és macOS. Platformfüggetlen egyenértékűnek tekinthető a PerformanceCounters esetében, amelyet csak Windows-rendszerek támogatnak.

Bár a felhasználók bármilyen egyéni eseményszámlálót közzétehetnek az igényeiknek megfelelően, a .NET alapértelmezés szerint közzéteszi ezeket a számlálókat. Ez a dokumentum végigvezeti a Azure-alkalmazás Insights eseményszámlálóinak (rendszer által definiált vagy felhasználó által definiált) gyűjtéséhez és megtekintéséhez szükséges lépéseket.

Az Application Insights használata az EventCounters gyűjtéséhez

Az Application Insights támogatja a gyűjtést EventCounters az EventCounterCollectionModuleújonnan kiadott Microsoft.ApplicationInsights.EventCounterCollector NuGet-csomag részeként. EventCounterCollectionModuleA automatikusan engedélyezve van az AspNetCore vagy a WorkerService használatakor. EventCounterCollectionModule 60 másodperces nem konfigurálható gyűjtési gyakorisággal gyűjti a számlálókat. Az EventCounters gyűjtéséhez nincs szükség különleges engedélyekre. Az ASP.NET Core-alkalmazásokhoz a Microsoft.ApplicationInsights.AspNetCore csomagot is hozzá kell adnia.

dotnet add package Microsoft.ApplicationInsights.EventCounterCollector
dotnet add package Microsoft.ApplicationInsights.AspNetCore

Összegyűjtött alapértelmezett számlálók

Az AspNetCore SDK vagy a WorkerService SDK 2.15.0-s verziójától kezdve alapértelmezés szerint nem gyűjt számlálókat. Maga a modul engedélyezve van, így a felhasználók hozzáadhatják a kívánt számlálókat az adatgyűjtéshez.

A .NET-futtatókörnyezet által közzétett jól ismert számlálók listájának lekéréséhez tekintse meg az Elérhető számlálók dokumentumot.

Gyűjtendő számlálók testreszabása

Az alábbi példa a számlálók hozzáadását/eltávolítását mutatja be. Ezt a testreszabást az alkalmazásszolgáltatás konfigurációjának részeként kell elvégezni, miután az Application Insights telemetriai gyűjtemény engedélyezve lett az AddApplicationInsightsTelemetry() egyik vagy AddApplicationInsightsWorkerService()a . Az alábbi példakód egy ASP.NET Core-alkalmazásból származik. Más típusú alkalmazások esetén tekintse meg ezt a dokumentumot.

using Microsoft.ApplicationInsights.Extensibility.EventCounterCollector;
using Microsoft.Extensions.DependencyInjection;

builder.Services.ConfigureTelemetryModule<EventCounterCollectionModule>(
        (module, o) =>
        {
            // Removes all default counters, if any.
            module.Counters.Clear();

            // Adds a user defined counter "MyCounter" from EventSource named "MyEventSource"
            module.Counters.Add(
                new EventCounterCollectionRequest("MyEventSource", "MyCounter"));

            // Adds the system counter "gen-0-size" from "System.Runtime"
            module.Counters.Add(
                new EventCounterCollectionRequest("System.Runtime", "gen-0-size"));
        }
    );

Az EventCounter gyűjteménymodul letiltása

EventCounterCollectionModule funkcióval ApplicationInsightsServiceOptionsle lehet tiltani.

Az alábbi példa a ASP.NET Core SDK-t használja.

using Microsoft.ApplicationInsights.AspNetCore.Extensions;
using Microsoft.Extensions.DependencyInjection;

var applicationInsightsServiceOptions = new ApplicationInsightsServiceOptions();
applicationInsightsServiceOptions.EnableEventCounterCollectionModule = false;
builder.Services.AddApplicationInsightsTelemetry(applicationInsightsServiceOptions);

Hasonló megközelítés használható a WorkerService SDK-hoz is, de a névteret módosítani kell az alábbi példában látható módon.

using Microsoft.ApplicationInsights.AspNetCore.Extensions;
using Microsoft.Extensions.DependencyInjection;

var applicationInsightsServiceOptions = new ApplicationInsightsServiceOptions();
applicationInsightsServiceOptions.EnableEventCounterCollectionModule = false;
builder.Services.AddApplicationInsightsTelemetry(applicationInsightsServiceOptions);

A Log Analyticsben teljesítményszámláló jelentéseket kereshet és jeleníthet meg.

A performanceCounters séma az egyes teljesítményszámlálók categorynevét counter és instance nevét teszi elérhetővé. Az egyes alkalmazások telemetriai adataiban csak az adott alkalmazás számlálói láthatók. Például a rendelkezésre álló számlálók megtekintéséhez:

performanceCounters | summarize count(), avg(value) by category, instance, counter

Instance Itt a teljesítményszámláló példányra hivatkozik, nem a szerepkörre vagy a kiszolgálógép-példányra. A teljesítményszámláló-példány neve általában a folyamat vagy az alkalmazás neve alapján szegmentálta a számlálókat, például a processzoridőt.

Az elmúlt időszakban rendelkezésre álló memória diagramjának lekérése:

performanceCounters | where counter == "Available Bytes" | summarize avg(value), min(value) by bin(timestamp, 1h) | render timechart

A többi telemetriához hasonlóan a PerformanceCounters is rendelkezik egy oszlopmalcloud_RoleInstance, amely annak a gazdagépkiszolgáló-példánynak az identitását jelzi, amelyen az alkalmazás fut. Például az alkalmazás teljesítményének összehasonlítása a különböző gépeken:

performanceCounters | where counter == "% Processor Time" and instance == "SendMetrics" | summarize avg(value) by cloud_RoleInstance, bin(timestamp, 1d)

Az eseményszámláló-jelentések a Log Analyticsben, a customMetrics táblában kereshetők és jeleníthetők meg.

Futtassa például a következő lekérdezést, hogy lássa, milyen számlálók vannak összegyűjtve és elérhetők a lekérdezéshez:

customMetrics | summarize avg(value) by name

Ha egy adott számláló diagramját (például: ThreadPool Completed Work Item Count) szeretné lekérni az elmúlt időszakban, futtassa az alábbi lekérdezést.

customMetrics 
| where name contains "System.Runtime|ThreadPool Completed Work Item Count"
| where timestamp >= ago(1h)
| summarize  avg(value) by cloud_RoleInstance, bin(timestamp, 1m)
| render timechart

A többi telemetriához hasonlóan a customMetrics is rendelkezik egy oszloppalcloud_RoleInstance, amely annak a gazdagépkiszolgáló-példánynak az identitását jelzi, amelyen az alkalmazás fut. Az előző lekérdezés a példányonkénti számlálóértéket jeleníti meg, és a különböző kiszolgálópéldányok teljesítményének összehasonlítására használható.

Mi a különbség a kivételi arány és a Kivételek metrikák között?

• Exception rate: A kivételi arány egy rendszerteljesítmény-számláló. A CLR megszámolja az összes olyan kezelt és kezeletlen kivételt, amely ki van dobva, és a mintavételi intervallumban lévő összesítést az intervallum hosszával osztja el. Az Application Insights SDK összegyűjti ezt az eredményt, és elküldi a portálnak.
• Exceptions: A Kivételek metrika megszámolja a TrackException portál által a diagram mintavételezési időközében fogadott jelentéseket. Csak azokat a kezelt kivételeket tartalmazza, ahol hívásokat ír TrackException a kódba. Nem tartalmazza az összes kezeletlen kivételt.

Láthatom az EventCounterst az élő metrikákban?

Az élő metrikák nem jelenítik meg az EventCounterst. A telemetriai adatok megtekintéséhez használja a Metric Explorert vagy az Analyticset.

Miután engedélyeztem az Application Insights szolgáltatást az Azure Web App Portalon, miért nem látom az eseményszámlálókat?

A ASP.NET Core Application Insights-bővítménye még nem támogatja ezt a funkciót.