Динамические метрики: мониторинг и диагностика с задержкой в 1 секунду

Статья
03/25/2023

Отслеживайте работу своего веб-приложения в реальном времени с помощью Live Metrics (другое название — QuickPulse) в Application Insights. Вы можете выбрать и отфильтровать метрики и счетчики производительности, чтобы отслеживать их в режиме реального времени без каких бы то ни было помех в работе службы. Можно также проверить трассировки стека из примеров неудачных запросов и исключений. Вместе с Профилировщиком и отладчиком моментальных снимков динамические метрики предоставляют мощное и неинвазивное средство диагностики для веб-сайта.

Примечание

Интерактивные метрики поддерживают только TLS 1.2. Дополнительные сведения см. в руководстве по устранению неполадок.

С помощью Live Metrics можно выполнять следующие действия:

Проверьте исправление, пока оно выпущено, отслеживая производительность и количество сбоев.
Наблюдайте за эффектом тестовых нагрузок и диагностики проблем в режиме реального времени.
Сосредоточьтесь на определенных тестовых сеансах или отфильтруйте известные проблемы, выбрав и отфильтровав метрики, которые вы хотите watch.
Получать трассировки исключений по мере того, как они возникают.
Экспериментировать с фильтрами, чтобы найти наиболее важные ключевые показатели эффективности.
Отслеживать любые счетчики производительности Windows в режиме реального времени.
Легко определите сервер с проблемами и отфильтруйте все ключевые показатели эффективности и динамический канал только на этом сервере.

Динамические метрики в настоящее время поддерживаются для приложений ASP.NET, ASP.NET Core, Функции Azure, Java и Node.js.

Примечание

Количество отслеживаемых экземпляров сервера, отображаемых динамическими метриками, может быть меньше фактического числа экземпляров, выделенных для приложения. Это несоответствие связано с тем, что многие современные веб-серверы будут выгружать приложения, которые не получают запросы в течение определенного периода времени для экономии ресурсов. Так как динамические метрики подсчитывают только серверы, на которых выполняется приложение, серверы, которые уже выгрузили процесс, не будут включены в эту общую сумму.

Начало работы

Важно!

Чтобы включить Application Insights, убедитесь, что она активирована в портал Azure и ваше приложение использует последнюю версию пакета NuGet Application Insights. Без пакета NuGet некоторые данные телеметрии отправляются в Application Insights, но эти данные телеметрии не будут отображаться в динамических метриках.

Следуйте рекомендациям для конкретного языка, чтобы включить динамические метрики:
- ASP.NET. Динамические метрики включены по умолчанию.
- ASP.NET Core. Динамические метрики включены по умолчанию.
- Консоль или рабочая роль .NET/.NET Core: динамические метрики включены по умолчанию.
- Приложения .NET: включение использования кода.
- Java: динамические метрики включены по умолчанию.
- Node.js
В портал Azure откройте ресурс Application Insights для приложения. Затем откройте Live Stream.
Защитите канал управления, если в фильтрах можно использовать конфиденциальные данные, такие как имена клиентов.

Примечание

Поддержка приема ключей инструментирования будет завершена 31 марта 31, 2025 г. Функция продолжит работать, но не будет обновляться или поддерживаться. Перейдите на строки подключения, чтобы использовать новые возможности.

Включение динамических метрик с помощью кода для любого приложения .NET

Примечание

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

Чтобы вручную настроить динамические метрики, выполните следующие действия.

Установите пакет NuGet Microsoft.ApplicationInsights.PerfCounterCollector.
В следующем примере кода консольного приложения показано, как настроить динамические метрики:

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

using Microsoft.ApplicationInsights;
using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;
using System;
using System.Threading.Tasks;

namespace LiveMetricsDemo
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 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();
            }
        }
    }
}

Примечание

Эта версия .NET больше не поддерживается.

using Microsoft.ApplicationInsights;
using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;
using System;
using System.Threading.Tasks;

namespace LiveMetricsDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 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();
            }
        }
    }
}

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

Чем динамические метрики отличаются от обозревателя метрик и Log Analytics?

Возможности	Live Stream	Обозреватель метрик и Log Analytics
Задержка	Данные отображаются в течение одной секунды.	Агрегировано по минутам.
Нет сохранения	Данные сохраняются, пока они хранятся на диаграмме, а затем удаляются.	Данные хранятся в течение 90 дней.
По запросу	Данные передаются в потоковую передачу только при открытой области Динамические метрики.	Данные отправляются при установке и включении пакета SDK.
Бесплатный	Плата за данные Live Stream не взимается.	Зависит от цены.
Дискретизация	Передаются все выбранные метрики и счетчики. Производится выборка сбоев и трассировок стека.	События можно использовать для выборки.
Канал управления	В пакет SDK отправляются управляющие сигналы фильтрации. Мы советуем защитить этот канал.	Одним из способов связи является портал.

Выбор и фильтрация метрик

Эти возможности доступны в ASP.NET, ASP.NET Core и Функции Azure (версия 2).

Можно отслеживать пользовательский КПЭ в реальном времени, применяя произвольные фильтры к любым данным телеметрии Application Insights на портале. Щелкните элемент управления фильтром, появляющийся при наведении указателя мыши на любую диаграмму. На следующей диаграмме показан пользовательский ключевой показатель эффективности подсчета запросов с фильтрами по атрибутам URL-адреса и длительности . Проверьте фильтры с помощью раздела предварительного просмотра потока, в которых отображается динамический канал телеметрии, соответствующий критериям, заданным в любой момент времени.

Вы можете отслеживать значение, отличное от Count. Параметры зависят от типа потока, который может быть любой телеметрией Application Insights, например запросы, зависимости, исключения, трассировки, события или метрики. Это также может быть ваше собственное настраиваемое измерение.

Наряду с телеметрией Application Insights можно также отслеживать любой счетчик производительности Windows. Выберите его в параметрах потока и укажите имя счетчика производительности.

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

Пример телеметрии: пользовательские динамические диагностические события

По умолчанию динамический веб-канал событий отображает примеры завершившихся сбоем запросов и вызовов зависимостей, исключений, событий и трассировок. Щелкните значок фильтра, чтобы просмотреть действующие критерии в любой момент времени.

Как и для метрик, можно указать любые произвольные критерии для любого типа данных телеметрии Application Insights. В этом примере мы выбираем конкретные сбои и события запросов.

Примечание

В настоящее время для критериев на основе сообщений об исключении используйте самое внешнее сообщение об исключении. В предыдущем примере, чтобы отфильтровать неопасное исключение с внутренним сообщением об исключении (следует за разделителем -<-) "Клиент отключен", используйте сообщение, не содержащее условия "Ошибка чтения содержимого запроса".

Чтобы просмотреть сведения об элементе в динамическом веб-канале, выберите его. Вы можете приостановить веб-канал, нажав кнопку Пауза или прокрутив вниз и выбрав элемент. Трансляция возобновляется после прокрутки обратно в начало или при выборе счетчика элементов, собранных во время приостановки.

Фильтрация по экземпляру сервера

Если требуется отслеживать определенный экземпляр роли сервера, можно применить фильтрацию по серверу. Чтобы отфильтровать данные, выберите имя сервера в разделе Серверы.

Защита канала управления

Настраиваемые фильтры динамических метрик позволяют контролировать, какие данные телеметрии приложения передаются в представление Динамические метрики в портал Azure. Критерии фильтров отправляются в приложения, инструментированные с помощью пакета SDK Application Insights. Значение фильтра может содержать конфиденциальную информацию, например идентификатор клиента. Чтобы защитить это значение и предотвратить его раскрытие неавторизованным приложениям, у вас есть два варианта:

Рекомендуется: Защитите канал Live Metrics с помощью проверки подлинности Azure Active Directory (Azure AD).
Устаревшая версия (больше не рекомендуется): Настройте канал с проверкой подлинности, настроив секретный ключ API, как описано в разделе "Устаревший параметр".

Примечание

30 сентября 2025 г. ключи API, используемые для потоковой передачи данных телеметрии Live Metrics в Application Insights, будут прекращены. После этой даты приложения, использующие ключи API, не смогут отправлять данные динамических метрик в ресурс Application Insights. Прием данных телеметрии с проверкой подлинности для потоковой передачи динамических метрик в Application Insights необходимо выполнить с помощью Azure AD проверки подлинности для Application Insights.

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

Предупреждение

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

Устаревший вариант: создание ключа API

Перейдите на вкладку Доступ к API , а затем щелкните Создать ключ API.
Установите флажок Проверка подлинности канала управления пакета SDK , а затем щелкните Создать ключ.

Добавление ключа API в конфигурацию

Вы можете добавить ключ API в конфигурацию для приложений ASP.NET, ASP.NET Core, WorkerService и Функции Azure.

В файле Program.cs добавьте следующее пространство имен:

using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;

Затем добавьте следующую регистрацию службы:

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

В файле Startup.cs добавьте следующее пространство имен:

using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;

Затем измените ConfigureServices метод :

public void ConfigureServices(IServiceCollection services)
{
    // Existing code which includes services.AddApplicationInsightsTelemetry() to enable Application Insights.
    services.ConfigureTelemetryModule<QuickPulseTelemetryModule> ((module, o) => module.AuthenticationApiKey = "YOUR-API-KEY-HERE");
}

Примечание

Эта версия .NET больше не поддерживается.

В файлеapplicationinsights.config добавьте AuthenticationApiKey в QuickPulseTelemetryModule:

<Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector">
      <AuthenticationApiKey>YOUR-API-KEY-HERE</AuthenticationApiKey>
</Add>

Дополнительные сведения о настройке ASP.NET Core приложений см. в разделе Настройка модулей телеметрии в ASP.NET Core.

WorkerService

Для приложений WorkerService следуйте этим инструкциям.

Добавьте следующее пространство имен:

using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;

Затем добавьте следующую строку перед вызовом services.AddApplicationInsightsTelemetryWorkerService:

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

Дополнительные сведения о настройке приложений WorkerService см. в разделе Настройка модулей телеметрии в WorkerServices.

Приложения Функции Azure

Для Функции Azure приложений (версия 2) канал можно защитить с помощью ключа API с помощью переменной среды.

Создайте ключ API из ресурса Application Insights и перейдите в раздел Конфигурация параметров> для приложения Функции Azure. Выберите Новый параметр приложения, введите имя APPINSIGHTS_QUICKPULSEAUTHAPIKEYи введите значение, соответствующее ключу API.

Таблица поддерживаемых возможностей

Язык	Базовые метрики	Метрики производительности	Настраиваемая фильтрация	Пример данных телеметрии	Разделение ЦП по процессам
.NET Framework	Поддерживается (LTS)	Поддерживается (LTS)	Поддерживается (LTS)	Поддерживается (LTS)	Поддерживается (LTS)
.NET Core (целевая платформа .NET Core)	Поддерживается (LTS)	Поддерживается (LTS)	Поддерживается (LTS)	Поддерживается (LTS)	Поддерживается (LTS)
.NET Core (целевая платформа .NET Core)	Поддерживается (LTS)	Поддерживается*	Поддерживается (LTS)	Поддерживается (LTS)	Не поддерживается
Функции Azure версии 2	Поддерживается	Поддерживается	Поддерживается	Поддерживается	Не поддерживается
Java	Поддерживается (версия 2.0.0+)	Поддерживается (версия 2.0.0+)	Не поддерживается	Поддерживается (версия 3.2.0 +)	Не поддерживается
Node.js	Поддерживается (версия 1.3.0+)	Поддерживается (версия 1.3.0+)	Не поддерживается	Поддерживается (версия 1.3.0+)	Не поддерживается

К базовым метрикам относится количество запросов, зависимостей и исключений. К метрикам производительности (счетчикам производительности) относятся память и ЦП. Пример данных телеметрии демонстрирует поток подробных сведений о неудачных запросах и зависимостях, исключениях, событиях и трассировках.

Поддержка PerfCounters немного отличается в разных версиях .NET Core, которые не предназначены для платформа .NET Framework:

Метрики PerfCounters поддерживаются при работе в Служба приложений Azure для Windows (пакет SDK ASP.NET Core версии 2.4.1 или более поздней).
PerfCounters поддерживаются, когда приложение выполняется на любом компьютере Windows для приложений, предназначенных для .NET Core LTS или более поздней версии.
PerfCounters поддерживаются, когда приложение выполняется где угодно (например, Linux, Windows, служба приложений для Linux или контейнеры) в последних версиях, но только для приложений, предназначенных для .NET Core LTS или более поздней версии.

Устранение неполадок

Live Metrics использует не такие IP-адреса, как в других данных телеметрии Application Insights. Убедитесь, что эти IP-адреса открыты в брандмауэре. Кроме того, проверка, что исходящие порты для динамических метрик открыты в брандмауэре серверов.

Как описано в объявлении о миграции Azure TLS 1.2, динамические метрики теперь поддерживают только TLS 1.2. Если вы используете более раннюю версию протокола TLS, в динамических метриках не будут отображаться никакие данные. Для приложений на основе платформа .NET Framework 4.5.1 см. статью Включение протокола TLS 1.2 на клиентах — Configuration Manager для поддержки более новой версии TLS.

Отсутствует конфигурация для .NET

Убедитесь, что вы используете последнюю версию пакета NuGet Microsoft.ApplicationInsights.PerfCounterCollector.
Измените файл ApplicationInsights.config:
- Убедитесь, что строка подключения указывает на ресурс Application Insights, который вы используете.
- QuickPulseTelemetryModule Найдите параметр конфигурации. Если его нет, добавьте его.
- QuickPulseTelemetryProcessor Найдите параметр конфигурации. Если его нет, добавьте его.
```
<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>
```
Перезапустите программу.

Сообщение о состоянии "Данные временно недоступны"

При переходе к динамическим метрикам может отображаться баннер с сообщением о состоянии: "Данные временно недоступны. Обновления о нашем статусе публикуются здесь https://aka.ms/aistatus"

Перейдите по ссылке на страницу состояния Azure и проверка, если сбой активации влияет на Application Insights. Если сбой отсутствует, проверьте, блокируют ли какие-либо брандмауэры или расширения браузера доступ к динамическим метрикам. Например, некоторые популярные расширения блокировки рекламы блокируют подключения к *.monitor.azure.com. Чтобы использовать все возможности динамических метрик, отключите расширение ad-blocker или добавьте правило исключения для домена *.livediagnostics.monitor.azure.com в средство блокировки рекламы, брандмауэр и т. д.

Непредвиденное большое количество запросов к livediagnostics.monitor.azure.com

При открытии панели LiveMetrics ожидается более интенсивное движение трафика. Перейдите с панели LiveMetrics, чтобы восстановить обычный поток трафика. Пакеты SDK для Application Insights опрашивают конечные точки QuickPulse с помощью вызовов REST API каждые пять секунд, чтобы проверка, просматривается ли панель LiveMetrics.

Пакеты SDK будут отправлять новые метрики в QuickPulse каждую секунду, пока открыта панель LiveMetrics.

Динамические метрики: мониторинг и диагностика с задержкой в 1 секунду

Начало работы

Включение динамических метрик с помощью кода для любого приложения .NET

Чем динамические метрики отличаются от обозревателя метрик и Log Analytics?

Выбор и фильтрация метрик

Пример телеметрии: пользовательские динамические диагностические события

Фильтрация по экземпляру сервера

Защита канала управления

Устаревший вариант: создание ключа API

Добавление ключа API в конфигурацию

WorkerService

Приложения Функции Azure

Таблица поддерживаемых возможностей

Устранение неполадок

Отсутствует конфигурация для .NET

Сообщение о состоянии "Данные временно недоступны"

Непредвиденное большое количество запросов к livediagnostics.monitor.azure.com

Дальнейшие действия

Дополнительные ресурсы

Дополнительные ресурсы