Счетчики для .NET в Application Insights

Windows предоставляет различные счетчики производительности, такие как данные, используемые для сбора статистики использования процессора, памяти и диска. Вы также можете определить собственные счетчики производительности.

Ваше приложение поддерживает сбор счетчиков производительности, если оно запускается под управлением IIS на локальном узле или виртуальной машине с административным доступом. Приложения, работающие как Azure веб-приложения, не могут напрямую получать доступ к счетчикам производительности, но Application Insights собирает подмножество доступных счетчиков.

Предварительные условия

Предоставьте учетной записи службы пула приложений разрешение на мониторинг счетчиков производительности, добавив ее в группу пользователей Монитора производительности.

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

Просмотр счетчиков

На панели метрик показан набор счетчиков производительности по умолчанию.

Счетчики по умолчанию для веб-приложений ASP.NET:

• Процесс, %\Загруженность процессора
• % Нормализованное время процессора
• Память\Доступные байты
• Запросов ASP.NET/сек.
• Исключения среды CLR (CLR) .NET, выданные в секунду
• Запрос времени исполнения для приложений ASP.NET
• Процесс\Приватные байты
• \Процесс\Данные ввода-вывода, байт/сек
• Приложения ASP.NET\Очередь запросов в приложении
• Процессор(_общий объем ресурсов)\% загруженности процессора

Счетчики по умолчанию для веб-приложений ASP.NET Core:

• % Процесс\Время процессора
• Процесс, %\Нормализованная загруженность процессора
• Память\Доступные байты
• Процесс\Частные байты
• \Процесс\Данные ввода-вывода, байт/сек
• Процессор(_общее)\% времени работы процессора

Добавление счетчиков

Если нужный счетчик производительности не включен в список метрик, можно добавить его.

1. Чтобы получить список счетчиков, доступных на сервере, выполните на локальном сервере такую команду PowerShell:

   Get-Counter -ListSet *
   

   Дополнительные сведения см. в разделе Get-Counter.

2. Открыть ApplicationInsights.config.

   Если вы добавили Application Insights в приложение во время разработки, выполните следующие действия.

   1. Измените ApplicationInsights.config в проекте.
   2. Повторно разверните его на серверах.

3. Измените директиву сборщика данных производительности:

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

Вы фиксируете как стандартные счетчики, так и счетчики, которые вы реализуете самостоятельно. \Objects\Processes — это пример стандартного счетчика, доступного во всех системах Windows. Пример пользовательского счетчика, который можно реализовать в веб-службе: \Sales(photo)\# Items Sold.

Используется формат \Category(instance)\Counter, а для категорий без экземпляров — просто \Category\Counter.

Параметр ReportAs требуется для имен счетчиков, которые не соответствуют [a-zA-Z()/-_ \.]+.

Если указать экземпляр, он становится измерением CounterInstanceName сообщаемой метрики.

Сбор счетчиков производительности в коде для веб-приложений ASP.NET или консольных приложений .NET/.NET Core

Чтобы собрать счетчики производительности системы и отправить их в Application Insights, можно адаптировать следующий фрагмент кода:

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

Или вы можете сделать то же самое с пользовательскими метриками, созданными вами:

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

Сбор счетчиков производительности в коде для веб-приложений ASP.NET Core

Настройте PerformanceCollectorModule после метода WebApplication.CreateBuilder() в 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 и счетчики Application Insights

В следующих разделах рассматриваются счетчики ASP.NET и Application Insights.

Счетчики производительности для приложений, работающих на платформе Веб-приложений Azure и в контейнерах Windows в Службе приложений Azure

Приложения ASP.NET и ASP.NET Core, развернутые в веб-приложениях Azure, выполняются в специальной изолированной среде. Приложения, развернутые в Службе приложений Azure, могут использовать контейнер Windows или размещаться в изолированной среде. Если приложение развертывается в контейнере Windows, все стандартные счетчики производительности доступны на образе контейнера.

Изолированная среда не разрешает прямой доступ к счетчикам производительности системы. Однако ограниченное подмножество счетчиков предоставляется в виде переменных среды, как описано в счетчиках Perf, предоставляемых как переменные среды. В этой среде доступно только подмножество счетчиков. Полный список см. в разделе Счетчики Perf, предоставляемые как переменные среды.

Пакет SDK Application Insights для ASP.NET и ASP.NET Core определяет, развертывается ли код в веб-приложении или контейнере, отличном от Windows. Обнаружение определяет, собирает ли он счетчики производительности в изолированной среде или использует стандартный механизм сбора данных при размещении в контейнере Windows или виртуальной машине.

Счетчики производительности в приложениях ASP.NET Core

Поддержка счетчиков производительности в приложениях ASP.NET Core ограниченна.

• Пакеты SDK версии 2.4.1 и более поздних собирают данные счетчиков производительности, если приложение выполняется в веб-приложениях Azure (Windows).
• Пакеты SDK версии 2.7.1 и более поздних собирают счетчики производительности, если приложение выполняется в Windows и предназначено для NETSTANDARD2.0 или более поздних версий.
• Для приложений, предназначенных для платформа .NET Framework, все версии пакета SDK поддерживают счетчики производительности.
• Пакет SDK версии 2.8.0 и более поздних версий поддерживает счетчик ЦП и памяти в Linux. В Linux не поддерживаются никакие другие счетчики. Чтобы получить системные счетчики в Linux (и других средах, отличных от Windows), используйте счетчики событий.

EventCounter — это механизм .NET и .NET Core для публикации и использования счетчиков или статистики. Счетчики событий поддерживаются на всех платформах ОС: Windows, Linux и macOS. Их можно рассматривать как кроссплатформенный эквивалент объектов PerformanceCounter, которые поддерживаются только в Windows-системах.

Хотя пользователи могут публиковать любые настраиваемые счетчики событий в соответствии с потребностями, .NET публикует набор этих счетчиков по умолчанию. В этом документе описаны шаги, необходимые для сбора и просмотра счетчиков событий (определенных системой или пользователем) в приложение Azure Insights.

Использование Application Insights для сбора счетчиков событий

Application Insights поддерживает сбор объектов EventCounters с помощью своего модуля EventCounterCollectionModule, который входит в состав недавно выпущенного пакета NuGet — Microsoft.ApplicationInsights.EventCounterCollector. Модуль EventCounterCollectionModule автоматически включается при использовании AspNetCore или WorkerService. EventCounterCollectionModule собирает счетчики с неконфигурируемой частотой сбора в 60 секунд. Для сбора объектов EventCounter не нужны специальные разрешения. Для приложений ASP.NET Core также необходимо добавить пакет Microsoft.ApplicationInsights.AspNetCore .

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

Счетчики, собираемые по умолчанию

Начиная с версии 2.15.0 версии SDK AspNetCore или версии SDK WorkerService, счетчики по умолчанию не собираются. Сам модуль включен, чтобы пользователи могли добавлять нужные счетчики для их сбора.

Список хорошо известных счетчиков, публикуемых средой выполнения .NET, см. в статье Доступные счетчики.

Настройка собираемых счетчиков

В следующем примере показано, как следует добавлять или удалять счетчики. Эта настройка будет выполнена как часть конфигурации службы приложений после включения сбора данных телеметрии Application Insights с использованием либо AddApplicationInsightsTelemetry(), либо AddApplicationInsightsWorkerService(). Ниже приведен пример кода из приложения для ASP.NET Core. Информацию о других типах приложений можно найти в этом документе.

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"));
        }
    );

Отключение модуля сбора данных EventCounter

EventCounterCollectionModule можно отключить с помощью ApplicationInsightsServiceOptions.

В следующем примере используется пакет SDK ASP.NET Core.

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

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

Аналогичный подход также можно использовать для пакета SDK для WorkerService, но пространство имен должно быть изменено, как показано в следующем примере.

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

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

Вы можете искать и отображать отчеты счетчиков производительности в Log Analytics.

Схема PerformanceCounters предоставляет category, имя counter и имя instance каждого счетчика производительности. В телеметрии для каждого приложения отображаются только счетчики для этого приложения. Например, вот как можно увидеть, какие счетчики доступны.

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

Instance Здесь относится к экземпляру счетчика производительности, а не к роли или экземпляру компьютера сервера. Имя экземпляра счетчика производительности обычно сегментирует счетчики, например время процессора, по имени процесса или приложения.

Вот как можно получить диаграмму доступной памяти за последний период.

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

Как и другие данные телеметрии, performanceCounters также содержат столбец cloud_RoleInstance, который указывает на экземпляр сервера, где запущено ваше приложение. Например, вот как можно сравнить производительность приложения на разных компьютерах.

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

Вы можете искать и отображать отчеты счетчиков событий в Log Analytics в таблице customMetrics .

Выполните, к примеру, следующий запрос, чтобы посмотреть, какие счетчики собираются и доступны для запроса:

customMetrics | summarize avg(value) by name

Чтобы получить диаграмму для определенного счетчика (например, ThreadPool Completed Work Item Count) за последний период времени, выполните следующий запрос.

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

Как и другие данные телеметрии, customMetrics также содержат столбец cloud_RoleInstance, который определяет идентификатор экземпляра сервера, на котором выполняется приложение. Предыдущий запрос показывает значение счетчика для каждого экземпляра и может использоваться для сравнения производительности разных экземпляров сервера.

Чем отличаются метрики "Частота исключений" и "Исключения"?

• Exception rate: частота исключений — это счетчик производительности системы. CLR подсчитывает все обработанные и необработанные исключения, которые выбрасываются, и делит общее количество в интервале выборки на длину интервала. Пакет SDK Application Insights получает этот результат и отправляет его на портал.
• Exceptions: Метрика исключений подсчитывает TrackException отчеты, полученные порталом, в интервале выборки диаграммы. Он включает только обрабатываемые исключения, где вы пишете вызовы TrackException в вашем коде. Он не включает все необработанные исключения.

Можно ли просматривать объекты EventCounter в динамических метриках?

Динамические метрики не отображают Счетчики событий. Для просмотра данных телеметрии используйте обозреватель метрик или службу аналитики.

После включения Application Insights на портале веб-приложений Azure почему не удается просмотреть счетчики событий?

Расширение Application Insights для ASP.NET Core пока не поддерживает эту функцию.