Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте динамические метрики из Application Insights для мониторинга веб-приложений. Выберите и отфильтруйте метрики и счетчики производительности для просмотра в реальном времени и проверки трассировки стека из примера неудачных запросов и исключений. Динамические метрики — это мощное средство диагностики при сочетании с .NET Profiler и Snapshot Debugger.
С помощью динамических метрик можно:
- Проверьте исправление во время выпуска, наблюдая за производительностью и количеством сбоев.
- Наблюдайте за влиянием тестовой нагрузки и диагностируйте проблемы в реальном времени.
- Сосредоточьтесь на определенных сеансах тестирования или отфильтруйте известные проблемы, выбрав и отфильтровав метрики, которые вы хотите просмотреть.
- Получать трассировки исключений по мере того, как они возникают.
- Экспериментировать с фильтрами, чтобы найти наиболее важные ключевые показатели эффективности.
- Отслеживать любые счетчики производительности Windows в режиме реального времени.
- Легко определить сервер, у которого возникли проблемы, и отфильтровать все KPI и поток данных в реальном времени только для этого сервера.
Начало работы
- Включите динамические метрики с помощью следующих рекомендаций для конкретного языка:
- ASP.NET: не поддерживается.
- ASP.NET Core: включен по умолчанию.
- Java: включен по умолчанию.
- Node.js: включен по умолчанию.
-
Python: передача
enable_live_metrics=Trueвconfigure_azure_monitor. Обратитесь к документации Azure Monitor OpenTelemetry Distro для получения дополнительной информации.
Откройте ресурс Application Insights для приложения в портал Azure. Выберите динамические метрики, которые перечислены в разделе "Исследование " в меню слева.
Защита канала управления путем включения проверки подлинности Microsoft Entra при использовании пользовательских фильтров.
Примечание.
Поддержка приема ключей инструментирования будет завершена 31 марта 31, 2025 г. Прием ключей инструментирования будет и дальше осуществляться, но мы больше не будем предоставлять обновления или поддержку для этой функции. Перейдите на строки подключения, чтобы использовать новые возможности.
Как динамические метрики отличаются от обозревателя метрик и Log Analytics?
| Возможности | Потоковая трансляция | Обозреватель метрик и Log Analytics |
|---|---|---|
| Задержка | Данные отображаются в течение одной секунды. | Агрегировано за минуты. |
| Без хранения | Данные сохраняются, пока находятся на диаграмме, а затем удаляются. | Данные хранятся в течение 90 дней. |
| по запросу | Данные передаются только в режиме реального времени, пока открыта область динамических метрик. | Данные отправляются всякий раз, когда пакет SDK установлен и включен. |
| Бесплатно | Плата за данные Live Stream не взимается. | В зависимости от ценообразования. |
| Образец | Передаются все выбранные метрики и счетчики. Производится выборка сбоев и трассировок стека. | Можно использовать примеры событий. |
| Канал управления | В пакет SDK отправляются управляющие сигналы фильтрации. Мы советуем защитить этот канал. | Связь осуществляется в одном направлении — к порталу. |
Выбор и фильтрация метрик
Эти возможности доступны с ASP.NET, ASP.NET Core и Функции Azure (версия 2).
Показатели пользовательской производительности можно отслеживать в реальном времени, применяя произвольные фильтры к любой телеметрии Application Insights на портале. Щелкните элемент управления фильтром, появляющийся при наведении указателя мыши на любую диаграмму. На следующей диаграмме показан пользовательский ключевой показатель эффективности подсчета запросов с фильтрами по атрибутам URL-адреса и длительности . Проверьте фильтры с помощью раздела предварительного просмотра потока, в котором отображается живое отображение телеметрии, удовлетворяющее указанным вами критериям на любом этапе.
Вы можете отслеживать значение, отличное от количества. Параметры зависят от типа потока, который может быть представлен любой телеметрией Application Insights, такой как запросы, зависимости, исключения, трассировки, события и метрики. Это также может быть собственное индивидуальное измерение.
Наряду с телеметрией Application Insights можно также отслеживать любой счетчик производительности Windows. Выберите его из параметров потока и укажите имя счетчика производительности.
Динамические метрики агрегируются в двух точках: локально на каждом сервере, а затем на всех серверах. Чтобы изменить значение по умолчанию, можно выбрать другие параметры в соответствующих раскрывающихся списках.
Пример телеметрии: пользовательское диагностическое событие в реальном времени
По умолчанию динамический веб-канал событий отображает примеры завершившихся сбоем запросов и вызовов зависимостей, исключений, событий и трассировок. Щелкните значок фильтра, чтобы просмотреть действующие критерии в любой момент времени.
Как и для метрик, можно указать любые произвольные критерии для любого типа данных телеметрии Application Insights. В этом примере мы выбираем определенные сбои запросов и события.
Примечание.
В настоящее время для критериев на основе сообщений об исключении используйте самое внешнее сообщение об исключении. В предыдущем примере, чтобы отфильтровать незначительное исключение с внутренним сообщением (следующее после разделителя "<--") "Клиент отключен", используйте критерий "не содержит 'Ошибка при чтении содержимого запроса'".
Чтобы просмотреть сведения о элементе в динамическом веб-канале, выберите его. Вы можете приостановить веб-канал, нажав кнопку "Приостановить " или прокрутив вниз и выбрав элемент. Динамический канал возобновляется после прокрутки обратно в верхнюю часть или при выборе счетчика элементов, собранных во время приостановки.
Фильтрация по экземпляру сервера
Если требуется отслеживать определенный экземпляр роли сервера, можно применить фильтрацию по серверу. Чтобы отфильтровать данные, выберите имя сервера в разделе Серверы.
Защита канала управления
Защитите канал управления динамическими метриками, включив проверку подлинности Microsoft Entra, которая предотвращает несанкционированное раскрытие потенциально конфиденциальной информации, введенной в пользовательские фильтры.
Примечание.
30 сентября 2025 г. поддержка ключей API, используемых для потоковой передачи телеметрии Live Metrics в Application Insights, будет прекращена. После этой даты приложения, использующие ключи API, не смогут отправлять данные динамических метрик в ресурс Application Insights. Прием данных телеметрии с проверкой подлинности для потоковой передачи динамических метрик в Application Insights потребуется выполнить проверку подлинности Microsoft Entra для Application Insights.
Таблица поддерживаемых возможностей
| Язык | Базовые метрики | Метрики производительности | Настраиваемая фильтрация | Пример данных телеметрии | Разделение ЦП по процессам |
|---|---|---|---|---|---|
| Платформа .NET Framework | Поддерживается (LTS) | Поддерживается (LTS) | Поддерживается (LTS) | Поддерживается (LTS) | Поддерживается (LTS) |
| .NET Core (целевая платформа .NET Framework) | Поддерживается (LTS) | Поддерживается (LTS) | Поддерживается (LTS) | Поддерживается (LTS) | Поддерживается (LTS) |
| .NET Core (целевая платформа .NET Core) | Поддерживается (LTS) | Поддерживается* | Поддерживается (LTS) | Поддерживается (LTS) | Не поддерживаются |
| Функции Azure версии 2 | Поддерживается | Поддерживается | Поддерживается | Поддерживается | Не поддерживаются |
| Ява | Поддерживается (версия 2.0.0 +) | Поддерживается (версия 2.0.0 +) | Не поддерживаются | Поддерживается (версия 3.2.0 +) | Не поддерживаются |
| Node.js | Поддерживается (версия 1.3.0+) | Поддерживается (версия 1.3.0+) | Не поддерживаются | Поддерживается (версия 1.3.0+) | Не поддерживаются |
| Питон | Поддерживается (версия дистрибутива 1.6.0+) | Не поддерживаются | Не поддерживаются | Не поддерживаются | Не поддерживаются |
К базовым метрикам относится количество запросов, зависимостей и исключений. К метрикам производительности (счетчикам производительности) относятся память и ЦП. Пример данных телеметрии демонстрирует поток подробных сведений о неудачных запросах и зависимостях, исключениях, событиях и трассировках.
Поддержка PerfCounters немного меняется в зависимости от версий .NET Core, которые не предназначены для платформ .NET Framework.
- Метрики PerfCounters поддерживаются при запуске в службе приложение Azure для Windows (пакет SDK для ядра ASP.NET версии 2.4.1 или более поздней).
- PerfCounters поддерживается при запуске приложения на любом компьютере Windows для приложений, предназначенных для .NET Core LTS или более поздней версии.
- PerfCounters поддерживается, если приложение работает в любом месте (например, Linux, Windows, служба приложений для Linux или контейнеров) в последних версиях, но только для приложений, предназначенных для .NET Core LTS или более поздней версии.
Устранение неполадок
См. статью об устранении неполадок.