Мониторинг Управление API

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

Azure Monitor собирает и агрегирует метрики и журналы из системы для мониторинга доступности, производительности и устойчивости, а также уведомляет вас о проблемах, влияющих на систему. Вы можете использовать портал Azure, PowerShell, Azure CLI, REST API или клиентские библиотеки для настройки и просмотра данных мониторинга.

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

Сбор данных с помощью Azure Monitor

В этой таблице описывается, как собирать данные для мониторинга службы и что можно сделать с данными после сбора:

Данные, которые нужно собрать	Description	Сбор и маршрутизация данных	Где просмотреть данные	Поддерживаемые данные
Данные метрик	Метрики — это числовые значения, описывающие аспект системы в определенный момент времени. Метрики можно агрегировать с помощью алгоритмов, по сравнению с другими метриками и анализировать для тенденций с течением времени.	— собирается автоматически через регулярные интервалы. — Вы можете направлять некоторые метрики платформы в рабочую область Log Analytics для запроса с другими данными. Проверьте параметры экспорта DS для каждой метрики, чтобы узнать, можно ли использовать параметр диагностики для маршрутизации данных метрик.	Обозреватель метрик	Метрики azure Управление API, поддерживаемые Azure Monitor
Данные журнала ресурсов	Журналы записывают системные события с меткой времени. Журналы могут содержать различные типы данных, а также структурировать или текст свободной формы. Данные журнала ресурсов можно направлять в рабочие области Log Analytics для запроса и анализа.	Создайте параметр диагностики для сбора и маршрутизации данных журнала ресурсов.	Служба Log Analytics	Данные журнала ресурсов Azure Управление API, поддерживаемые Azure Monitor
Данные журнала действий	Журнал действий Azure Monitor содержит сведения о событиях уровня подписки. Журнал действий включает информацию, например, об изменении ресурса или запуске виртуальной машины.	— собирается автоматически. - Создайте параметр диагностики для рабочей области Log Analytics без платы.	Журнал действий

Список всех данных, поддерживаемых Azure Monitor, см. в следующих статье:

• Поддерживаемые метрики Azure Monitor
• Поддерживаемые журналы ресурсов Azure Monitor

Встроенный мониторинг для Управление API

Управление API Azure имеет следующие встроенные функции мониторинга.

Получение аналитики в службе управления API Azure

Azure Управление API предоставляет аналитику для API, чтобы можно было анализировать их использование и производительность. Используйте аналитику для мониторинга высокого уровня и устранения неполадок с API. Другие функции мониторинга, включая метрики и журналы ресурсов практически в режиме реального времени для диагностика и аудита, см. в руководстве по мониторингу опубликованных API.

Примечание.

В настоящее время эта функция недоступна в рабочих областях.

• Управление API предоставляет аналитику с помощьюПанель мониторинга на основе Azure Monitor. Панель мониторинга объединяет данные в рабочей области Azure Log Analytics.
• На классических уровнях служб Управление API экземпляр Управление API также включает устаревшую встроенную аналитику в портал Azure, а данные аналитики можно получить с помощью REST API Управление API. Похожие данные отображаются на панели мониторинга на основе Azure Monitor и встроенной аналитике.

Внимание

Панель мониторинга на основе Azure Monitor — это рекомендуемый способ доступа к данным аналитики. Встроенная (классическая) аналитика недоступна на уровнях версии 2.

С помощью аналитики API анализируйте использование и производительность API в Управление API экземпляре в нескольких измерениях, в том числе:

• Время
• Географический регион
• Программные интерфейсы
• Операции API
• Продукты
• Подписки
• Пользователи
• Запросы

Аналитика API предоставляет данные о запросах, включая неудачные и несанкционированные запросы. Географические значения основаны на сопоставлении IP-адресов. Может возникнуть задержка в доступности аналитических данных.

Панель мониторинга на основе Azure Monitor

Чтобы использовать панель мониторинга на основе Azure Monitor, требуется рабочая область Log Analytics в качестве источника данных для журналов шлюза Управление API.

Если необходимо настроить один, выполните краткие действия по отправке журналов шлюза в рабочую область Log Analytics. Дополнительные сведения см. в руководстве по мониторингу опубликованных API. Эта процедура является однократной настройкой.

1. Перейдите к экземпляру Управления API на портале Azure.
2. В меню слева в разделе "Мониторинг" выберите "Параметры диагностики" и "Добавить параметр диагностики>".
3. Введите описательное имя параметра диагностики.
4. В журналах выберите журналы, связанные с шлюзом ApiManagement.
5. В сведениях о назначении выберите "Отправить в Log Analytics" и выберите рабочую область Log Analytics в той же или другой подписке. Если вам нужно создать рабочую область, см. статью "Создание рабочей области Log Analytics".
6. Убедитесь, что в качестве целевой таблицы выбран конкретный ресурс.
7. Выберите Сохранить.

Внимание

Новая рабочая область Log Analytics может занять до 2 часов, чтобы начать получать данные. Существующая рабочая область должна начать получать данные примерно через 15 минут.

Доступ к панели мониторинга

После настройки рабочей области Log Analytics откройте панель мониторинга на основе Azure Monitor для анализа использования и производительности API.

1. Перейдите к экземпляру Управления API на портале Azure.
2. В меню слева в разделе Мониторинг выберите Аналитика. Откроется панель мониторинга аналитики.
3. Выберите диапазон времени для данных.
4. Выберите категорию отчета для данных аналитики, например временная шкала, география" и т. д.

Устаревшая встроенная аналитика

В некоторых Управление API уровнях служб встроенная аналитика (также называемая устаревшей аналитикой или классической аналитикой) также доступна в портал Azure, а данные аналитики можно получить с помощью УПРАВЛЕНИЕ API REST API.

Чтобы получить доступ к встроенной (классической) аналитике в портал Azure:

1. Перейдите к экземпляру Управления API на портале Azure.
2. В меню слева в разделе "Мониторинг" выберите "Аналитика" (классическая модель).
3. Выберите диапазон времени для данных или введите настраиваемый диапазон времени.
4. Выберите категорию отчета для данных аналитики, например временная шкала, география" и т. д.
5. При необходимости отфильтруйте отчет по одной или нескольким другим категориям.

Используйте операции с отчетами в REST API управления API для получения и фильтрации данных аналитики для экземпляра службы управления API.

Доступные операции возвращают записи отчетов по API, географии, операциям API, продукту, запросу, подписке, времени или пользователю.

Включение ведения журнала использования портала разработчика в Azure Управление API

В этом разделе показано, как включить журналы Azure Monitor для аудита и устранения неполадок использования портала разработчика Управление API. При включении с помощью параметра диагностики журналы собирают сведения о полученных и обработанных порталом разработчика запросах.

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

• Действия проверки подлинности пользователей, такие как вход и выход
• Представления сведений о API, сведения об операциях API и продуктах
• Тестирование API в интерактивной консоли тестирования

Включение параметра диагностики для журналов портала разработчика

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

1. Перейдите к экземпляру Управления API на портале Azure.

2. В меню слева в разделе "Мониторинг" выберите "Параметры диагностики" и "Добавить параметр диагностики>".

   

3. На странице параметров диагностики введите или выберите сведения для параметра:

   1. Имя параметра диагностики: введите описательное имя.
   2. Группы категорий. При необходимости сделайте выбор для вашего сценария.
   3. В разделе "Категории" выберите журналы, связанные с использованием портала разработчика. При необходимости выберите другие категории.
   4. В разделе "Сведения о назначении" выберите один или несколько параметров и укажите сведения о назначении. Например, архивные журналы в учетную запись хранения или потоковая передача их в концентратор событий. Дополнительные сведения см. в разделе "Параметры диагностики" в Azure Monitor.
   5. Выберите Сохранить.

Просмотр данных журнала диагностики

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

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

1. В портал Azure перейдите к назначению учетной записи хранения.
2. В меню слева выберите браузер хранилища.
3. В разделе контейнеров BLOB-объектов выберите insights-logs-developerportalauditlogs.
4. Перейдите к контейнеру для журналов в Управление API экземпляре. Журналы секционируются интервалами в 1 час.
5. Чтобы получить данные для дальнейшего анализа, нажмите кнопку "Скачать".

Использование средств Azure Monitor для анализа данных

Эти средства Azure Monitor доступны в портал Azure для анализа данных мониторинга:

• Некоторые службы Azure имеют встроенную панель мониторинга мониторинга в портал Azure. Эти панели мониторинга называются аналитическими сведениями, и их можно найти в разделе "Аналитика" в Azure Monitor в портал Azure.

• Обозреватель метрик позволяет просматривать и анализировать метрики для ресурсов Azure. Дополнительные сведения см. в разделе "Анализ метрик" с помощью обозревателя метрик Azure Monitor.

• Log Analytics позволяет запрашивать и анализировать данные журнала с помощью языка запросов Kusto (KQL). Дополнительные сведения см. в статье Начало работы с запросами журнала в Azure Monitor.

• В портал Azure есть пользовательский интерфейс для просмотра и базового поиска журнала действий. Чтобы выполнить более подробный анализ, перенаправите данные в журналы Azure Monitor и выполните более сложные запросы в Log Analytics.

• Application Insights отслеживает доступность, производительность и использование веб-приложений, чтобы можно было выявлять и диагностировать ошибки, не ожидая, когда пользователь сообщит о них.
  Application Insights включает точки подключения к различным средствам разработки и интегрируется с Visual Studio для поддержки процессов DevOps. Дополнительные сведения см. в разделе "Мониторинг приложений" для Служба приложений.

Средства, которые позволяют более сложной визуализации, включают:

• Панели мониторинга, позволяющие объединить различные виды данных в одну область в портал Azure.
• Книги, настраиваемые отчеты, которые можно создать в портал Azure. Книги могут включать текст, метрики и запросы журналов.
• Grafana — открытое средство платформы, которое работает на операционных панелях мониторинга. С помощью Grafana можно создавать панели мониторинга, содержащие данные из нескольких источников, отличных от Azure Monitor.
• Power BI— служба бизнес-аналитики, которая предоставляет интерактивные визуализации в различных источниках данных. Вы можете настроить Power BI на автоматический импорт данных журналов из Azure Monitor, чтобы воспользоваться этими визуализациями.

Визуализация данных мониторинга службы "Управление API" с помощью управляемой панели мониторинга Grafana

Вы можете использовать Управляемый Grafana Azure для визуализации Управление API данных мониторинга, собранных в рабочую область Log Analytics. Используйте предварительно созданную Управление API панель мониторинга для визуализации журналов и метрик в режиме реального времени, собранных из Управление API экземпляра.

• Дополнительные сведения об Управляемой Grafana Azure
• Дополнительные сведения о наблюдаемости в Azure Управление API

На вашем Управление API экземпляре:

• Чтобы визуализировать журналы ресурсов и метрики для Управление API, настройте параметры диагностики для сбора журналов ресурсов и отправки их в рабочую область Log Analytics.

• Чтобы визуализировать подробные данные о запросах к шлюзу Управление API, интегрируйте экземпляр Управление API с Application Insights.

  Примечание.

  Чтобы визуализировать данные на одной панели мониторинга, настройте рабочую область Log Analytics для параметров диагностики и экземпляра Application Insights в той же группе ресурсов, что и экземпляр Управление API.

В рабочей области Managed Grafana:

• Сведения о создании управляемого экземпляра и рабочей области Grafana см. в кратком руководстве по порталу или Azure CLI.
• Экземпляр Управляемой Grafana должен находиться в той же подписке, что и экземпляр Управление API.
• При создании рабочая область Grafana автоматически назначается управляемому удостоверению Microsoft Entra, которому назначена роль читателя монитора в подписке. Этот подход обеспечивает немедленный доступ к Azure Monitor из новой рабочей области Grafana без необходимости задавать разрешения вручную. Дополнительные сведения о настройке источников данных для Managed Grafana.

Сначала импортируйте панель мониторинга Управление API в рабочую область Управления Grafana.

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

1. Перейдите в рабочую область Azure Managed Grafana. На портале на странице обзора экземпляра Управляемого Grafana выберите ссылку Endpoint .
2. В рабочей области Managed Grafana перейдите к панели мониторинга>"Обзор>импорта".
3. На странице "Импорт" в разделе "Импорт через grafana.com" введите 16604 и выберите "Загрузить".
4. Выберите источник данных Azure Monitor, просмотрите или обновите другие параметры и нажмите кнопку "Импорт".

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

1. В рабочей области Managed Grafana перейдите на панели мониторинга>"Обзор" и выберите панель мониторинга Управление API.
2. В раскрывающихся списках в верхней части сделайте выбор для вашего Управление API экземпляра. При настройке выберите экземпляр Application Insights и рабочую область Log Analytics.

Просмотрите визуализации по умолчанию на панели мониторинга, которая отображается на следующем снимках экрана:

Экспорт данных Azure Monitor

Вы можете экспортировать данные из Azure Monitor в другие средства с помощью:

• Метрики. Используйте REST API для метрик для извлечения данных метрик из базы данных метрик Azure Monitor. Дополнительные сведения см . в справочнике по REST API Azure Monitor.

• Журналы: используйте REST API или связанные клиентские библиотеки.

• Экспорт данных рабочей области Log Analytics.

Сведения о начале работы с REST API Azure Monitor см . в пошаговом руководстве по REST API мониторинга Azure.

Использование запросов Kusto для анализа данных журнала

Вы можете анализировать данные журнала Azure Monitor с помощью языка запросов Kusto (KQL). Дополнительные сведения см. в разделе Запросы журналов в Azure Monitor.

Использование оповещений Azure Monitor для уведомления о проблемах

Оповещения Azure Monitor позволяют выявлять и устранять проблемы в системе, а также заранее уведомлять вас, когда конкретные условия находятся в данных мониторинга, прежде чем клиенты заметят их. Вы можете получать оповещения о любых источниках данных метрик или журналов на платформе данных Azure Monitor. Существуют различные типы оповещений Azure Monitor в зависимости от служб, которые вы отслеживаете, и собираемых данных мониторинга. См. раздел "Выбор правильного типа правила генерации оповещений".

Сведения о настройке правила генерации оповещений в Azure Управление API см. в статье "Настройка правила генерации оповещений".

Примеры распространенных оповещений для ресурсов Azure см. в примерах запросов оповещений журнала.

Реализация оповещений в масштабе

Для некоторых служб можно отслеживать масштаб, применяя одно правило генерации оповещений метрик к нескольким ресурсам одного типа, которые существуют в одном регионе Azure. Оповещения базовых показателей Azure Monitor (AMBA) предоставляют полуавтомативный метод реализации важных оповещений метрик платформы, панелей мониторинга и рекомендаций в масштабе.

Получение персонализированных рекомендаций с помощью Помощника по Azure

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

Дополнительные сведения о Помощнике по Azure см. в обзоре Помощника по Azure.

Связанный контент

• справочник по данным мониторинга Управление API
• Мониторинг ресурсов Azure с помощью Azure Monitor