Поделиться через

Параметры хранения и мониторинга журналов в контейнерах приложений Azure

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

Журналы приложений контейнеров состоят из двух разных категорий:

  • Выходные данные консоли контейнера (stdout/stderr) сообщения.
  • Системные журналы, созданные приложениями контейнеров Azure.
  • Логи консоли приложения Spring.

Вы можете выбрать между этими местами назначения журналов:

  • Log Analytics: Azure Monitor Log Analytics — это хранилище по умолчанию и параметр просмотра. Журналы хранятся в рабочей области Log Analytics, где их можно просматривать и анализировать с помощью запросов Log Analytics. Дополнительные сведения о Log Analytics см. в статье Azure Monitor Log Analytics.
  • Azure Monitor: Azure Monitor направляет журналы в одно или несколько назначений:
    • Рабочая область Log Analytics для просмотра и анализа.
    • Архивация в учетной записи хранения Azure
    • Концентратор событий Azure для приема данных и аналитических служб. Дополнительные сведения см. в статье Центры событий Azure.
    • Решение для мониторинга партнеров Azure, например Datadog, Elastic, Logz.io и другие. Дополнительные сведения см. в разделе "Решения партнеров".
  • Не сохраняйте журналы. Вы можете отключить хранилище данных журнала. Когда отключено, журналы контейнеров в режиме реального времени можно просматривать с помощью функции потока журналов в приложении контейнера. Дополнительные сведения см. в разделе Потоковая передача журналов.

Если выбран пункт "Не сохранять журналы" или назначение Azure Monitor, пункт меню "Журналы", предоставляющий редактор запросов Log Analytics в портале Azure, будет отключен.

Настройка параметров ведения журнала

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

  1. Перейдите к среде приложений-контейнеров на портале.

  2. Выберите Мониторинг>Параметры ведения журнала.

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

    • Azure Log Analytics: с помощью этого параметра вы выбираете рабочую область Log Analytics для хранения данных журнала. Журналы можно просматривать с помощью запросов Log Analytics. Дополнительные сведения о Log Analytics см. в статье Azure Monitor Log Analytics.
    • Azure Monitor: Azure Monitor направляет журналы в место назначения. При выборе этого параметра необходимо выбрать параметры диагностики , чтобы завершить настройку после нажатия кнопки "Сохранить " на этой странице.
    • Не сохраняйте журналы: этот параметр отключает хранение данных журнала.

  4. Выберите Сохранить.

Параметры диагностики

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

Настройка параметров диагностики на уровне среды

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

  1. Перейдите в раздел вашей среды на портале.

  2. Выберите Мониторинг>Диагностические настройки. Если вы только что установили местоположение журналов для вашей среды в Azure Monitor, может потребоваться обновить страницу для отображения этого элемента конфигурации.

Сведения о назначении сохраняются в качестве параметров диагностики. Вы можете создать до пяти параметров диагностики для вашей среды. Для каждого параметра диагностики можно настроить разные категории журналов. Например, создайте один параметр диагностики для отправки категории системных журналов в одно место назначения, а другой — для отправки категории журналов консоли контейнера в другое место назначения.

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

  1. Выберите Добавить параметр диагностики.

  2. В поле "Имя параметра диагностики" введите имя параметра диагностики.

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

  4. Если вы хотите отправить метрики на уровне приложения, выберите Метрики>.

  5. Выберите одну или несколько сведений о назначении:

    • Отправить в рабочую область Log Analytics: выберите из существующих рабочих областей Log Analytics.
    • Архивируйте в учетную запись хранения: выберите из учетных записей хранения Azure.
    • Потоковая передача в концентратор событий: выберите из концентраторов событий Azure.
    • Отправьте в партнерское решение: выберите из партнерских решений Azure.

  6. Выберите Сохранить.

Дополнительные сведения о параметрах диагностики см. в разделе "Параметры диагностики" в Azure Monitor.

Настройка параметров диагностики на уровне приложения контейнера

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

  1. Перейдите к приложению-контейнеру на портале.

  2. Выберите Мониторинг>Параметры диагностики. Если вы только что установили назначение журналов среды вашего контейнерного приложения в Azure Monitor, может потребоваться обновить страницу, чтобы этот элемент конфигурации отобразился.

  3. Выберите Добавить параметр диагностики.

  4. В поле "Имя параметра диагностики" введите имя параметра диагностики.

  5. В поле Метрики выберите AllMetrics.

  6. Выберите одну или несколько сведений о назначении:

    • Отправить в рабочую область Log Analytics: выберите из существующих рабочих областей Log Analytics.
    • Архивирование в учетную запись хранения: выберите учетную запись хранения.
    • Потоковая передача в концентратор событий: выберите из концентраторов событий Azure.
    • Отправьте в партнерское решение: выберите из партнерских решений Azure.

  7. Выберите Сохранить.

Настройка параметров ведения журнала

Настройте место назначения данных журналов для среды приложений контейнеров с помощью команд Azure CLI az containerapp create и az containerapp update с аргументом --logs-destination.

Сначала зарегистрируйте Microsoft.Insights пространство имен.

az provider register --namespace Microsoft.Insights

Отправьте в рабочую область Log Analytics

Чтобы создать платформу Container Apps, используя существующую рабочую область Log Analytics для логирования, выполните следующую команду. Замените значения <PLACEHOLDERS> на свои. Идентификатор ресурса рабочей области Log Analytics можно получить на странице этой рабочей области на портале Azure или из команды az monitor log-analytics workspace show.

az containerapp env create \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination log-analytics \
  --logs-workspace-id <LOG_ANALYTICS_WORKSPACE_ID>

Аргумент --logs-destination принимает значения log-analytics, azure-monitorи none.

Отправка в Azure Monitor

Чтобы обновить существующую среду приложений контейнеров для использования Azure Monitor в качестве назначения журналов, выполните следующую команду. Замените <PLACEHOLDERS> вашими значениями.

az containerapp env update \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination azure-monitor

Настройка параметров диагностики

Когда --logs-destination задано azure-monitor, необходимо создать параметры диагностики, чтобы настроить сведения о назначении для категорий журналов с помощью команды az monitor diagnostics-settings. Эти параметры диагностики можно настроить как на уровне среды, так и на уровне приложения контейнера.

Чтобы создать параметры диагностики на уровне среды, выполните следующую команду. Замените значения <PLACEHOLDERS> на свои. Идентификатор среды можно получить на странице "Среда" на портале Azure, или из команды az containerapp env show.

az monitor diagnostic-settings create \
  --name "AllMetricsToLogAnalytics" \
  --resource <ENVIRONMENT_ID> \
  --logs '[{"categoryGroup":"allLogs","enabled":true}]' \
  --metrics '[{"category":"AllMetrics","enabled":true}]' \
  --workspace <LOG_ANALYTICS_RESOURCE_ID>

Убедитесь, что в значениях JSON, предоставленных параметрам --logs и --metrics, нет пробелов.

Для параметра --logs можно указать category или categoryGroup, но не одновременно оба. Для categoryGroup доступны значения audit и allLogs. Для category доступны значения ContainerAppConsoleLogs и ContainerAppSystemLogs.

Для параметра --metrics доступна только категория AllMetrics.

Дополнительные сведения см. в разделе LogSettings и MetricSettings.

Чтобы создать параметры диагностики на уровне приложения контейнера, выполните следующую команду. Замените значения <PLACEHOLDERS> на свои. Идентификатор приложения контейнера можно получить на портале Azure или из az containerapp show команды.

При создании параметров диагностики на уровне приложения контейнера --logs параметр не поддерживается, а для параметра --metrics доступна только категория AllMetrics.

az monitor diagnostic-settings create \
--name "AllMetricsToLogAnalytics" \
--resource <CONTAINER_APP_ID> \
--metrics '[{"category":"AllMetrics","enabled":true}]' \
--workspace <LOG_ANALYTICS_RESOURCE_ID>

Дополнительные сведения о командах параметров диагностики Azure Monitor см . в az monitor diagnostic-settings.

Ограничения

Следующие ограничения применяются при настройке параметров журнала.

  • Приватный канал. Отправка журналов непосредственно в рабочую область Log Analytics через приватный канал не поддерживается. Однако вы можете использовать Azure Monitor и отправлять журналы в ту же рабочую область Log Analytics. Это косвенное действие требуется для предотвращения потери данных журнала системы.

Следующие шаги

Мониторинг журналов с помощью Log Analytics

  • Last updated on