Использование Azure Application Insights в построителе API данных

2025-07-22

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

Azure Application Insights — это служба мониторинга, которая записывает данные телеметрии, такие как сведения о запросах, счетчики производительности, журналы и исключения. Интеграция с построителем API данных (DAB) помогает диагностировать проблемы и отслеживать поведение среды выполнения в рабочей среде.

Предупреждение Application Insights не поддерживается, если DAB размещается с помощью веб-приложений службы приложений Azure.

Конфигурация

Чтобы настроить Application Insights в конфигурации DAB, выполните приведенные действия.

Пример интерфейса командной строки

dab add-telemetry \
  --app-insights-enabled true \
  --app-insights-conn-string "@env('app-insights-connection-string')"

Пример JSON

"runtime": {
  ...
  "telemetry": {
    "application-insights": {
      "enabled": true,
      "connection-string": "@env('app-insights-connection-string')"
    }
  }
  ...
}

Предполагается app-insights-connection-string , что это переменная среды. Для его определения можно использовать .env файл.

Что фиксируется

Тип	Описание
Запрос телеметрии	URL-адрес, код состояния, время отклика
Трассировка телеметрии	Журналы консоли из DAB
Данные телеметрии исключений	Ошибки и трассировки стека
Счетчики производительности	ЦП, память, сетевые метрики

Просмотр в Azure

Перейдите к ресурсу Application Insights на портале Azure: https://portal.azure.com
Просмотрите журналы с помощью этого запроса:

traces
| order by timestamp

Сопоставление уровней логирования:

LogLevel	Степень серьезности	Ценность
Трассировка	Многословный	0
Отладка	Многословный	0
Информация	Информация	1
Предупреждение	Предупреждение	2
Ошибка	Ошибка	3
Критически важно	Критически важно	4

Проверка живых метрик

Снимок экрана: страница динамических метрик для данных построителя данных API в Application Insights.

Выполните этот запрос для обработки запросов.

requests
| order by timestamp

Снимок экрана результатов запроса запросов приложения Data API Builder в Application Insights.

Выполните этот запрос для исключений:

exceptions
| order by timestamp

Снимок экрана результатов запроса по исключениям конструктора API данных в Application Insights.