Устранение неполадок шлюза VMware Spring Cloud
Примечание.
Планы "Базовый", "Стандартный" и "Корпоративный" будут устарели начиная с середины марта 2025 г. с 3-летнего периода выхода на пенсию. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.
Стандартный план потребления и выделенного плана будет устарел с 30 сентября 2024 г. с полным завершением работы после шести месяцев. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в статье "Миграция потребления Azure Spring Apps Standard" и выделенного плана в приложения контейнеров Azure.
Эта статья относится к:❌ Basic/Standard ✔️ Enterprise
В этой статье показано, как устранить неполадки с Spring Cloud Gateway для VMware Tanzu с планом Azure Spring Apps Enterprise. Дополнительные сведения о шлюзе VMware Spring Cloud см. в статье "Настройка шлюза VMware Spring Cloud".
Необходимые компоненты
- Уже подготовленный экземпляр службы плана Azure Spring Apps Enterprise с включенным шлюзом VMware Spring Cloud. Дополнительные сведения см . в кратком руководстве по созданию и развертыванию приложений в Azure Spring Apps с помощью плана Enterprise.
- Azure CLI версии 2.45.0 или более поздней. Используйте следующую команду, чтобы установить расширение Azure Spring Apps:
az extension add --name spring
Проверка метрик шлюза
Дополнительные сведения о проверке метрик на портал Azure см. в разделе "Общие метрики" статьи "Метрики для Azure Spring Apps".
Дополнительные сведения о каждой поддерживаемой метрии см. в разделе "Метрики" для Azure Spring Apps.
Проверка журналов шлюза
Spring Cloud Gateway состоит из следующих подкомпонентов:
spring-cloud-gateway-operator
предназначен для управления шлюзом.spring-cloud-gateway
выполняет функции.
Доступны журналы обоих вложенных компонентов. В следующих разделах описывается проверка этих журналов.
Использование потоковой передачи журналов в режиме реального времени
Журналы можно передавать в режиме реального времени с помощью Azure CLI. Дополнительные сведения см. в журналах управляемых компонентов Stream Azure Spring Apps в режиме реального времени. В следующих примерах показано, как использовать команды Azure CLI для непрерывного потока новых журналов spring-cloud-gateway
и spring-cloud-gateway-operator
вложенных элементов.
Используйте следующую команду для потоковой передачи журналов:spring-cloud-gateway
az spring component logs \
--resource-group <resource-group-name> \
--service <Azure-Spring-Apps-instance-name> \
--name spring-cloud-gateway \
--all-instances \
--follow
Используйте следующую команду для потоковой передачи журналов:spring-cloud-gateway-operator
az spring component logs \
--resource-group <resource-group-name> \
--service <Azure-Spring-Apps-instance-name> \
--name spring-cloud-gateway-operator \
--all-instances \
--follow
Использование Log Analytics
В следующих разделах показано, как просматривать системные журналы с помощью Log Analytics.
Параметры диагностики для Log Analytics
Перед запросом журналов VMware Spring Cloud необходимо включить системные журналы и отправить их в Log Analytics. Чтобы включить системные журналы в портал Azure, выполните следующие действия.
Откройте экземпляр Azure Spring Apps.
В меню навигации выберите параметры диагностики.
Выберите "Добавить параметр диагностики" или выберите "Изменить" для существующего параметра.
В разделе "Журналы" выберите категорию системных журналов.
В разделе "Сведения о назначении" выберите "Отправить в рабочую область Log Analytics" и выберите рабочую область.
Нажмите кнопку "Сохранить", чтобы обновить параметр.
Проверка журналов в Log Analytics
Чтобы проверить журналы spring-cloud-gateway
и spring-cloud-gateway-operator
использовать портал Azure, выполните следующие действия.
Убедитесь, что вы включили системные журналы. Дополнительные сведения см. в разделе "Параметры диагностики" для Log Analytics .
Откройте экземпляр Azure Spring Apps.
Выберите "Журналы" в области навигации и выберите " Обзор".
Используйте следующие примеры запросов в области редактирования запросов. Измените диапазон времени, а затем нажмите кнопку "Выполнить ", чтобы найти журналы.
Чтобы просмотреть журналы
spring-cloud-gateway
, используйте следующий запрос:AppPlatformSystemLogs | where LogType in ("SpringCloudGateway") | project TimeGenerated , ServiceName , LogType, Log , _ResourceId | limit 100
Чтобы просмотреть журналы
spring-cloud-gateway-operator
, используйте следующий запрос:AppPlatformSystemLogs | where LogType in ("SpringCloudGatewayOperator") | project TimeGenerated , ServiceName , LogType, Log , _ResourceId | limit 100
Примечание.
До того, как журналы доступны в Log Analytics, может возникнуть задержка в течение нескольких минут.
Настройка уровней журнала
В этом разделе описывается настройка уровней журналов для шлюза VMware Spring Cloud и предложение одного средства ведения журнала в качестве примера.
Внимание
Прежде чем приступить к работе, ознакомьтесь с подробными сведениями и последствиями настройки уровней журналов, прочитав раздел "Настройка уровней журналов " в разделе "Настройка шлюза VMware Spring Cloud".
Чтобы настроить уровни журнала, выполните следующие действия.
- В экземпляре Azure Spring Apps выберите Spring Cloud Gateway в области навигации и выберите "Конфигурация".
- В разделах "Свойства" заполните пару
logging.level.org.springframework.cloud.gateway=DEBUG
"ключ-значение". - Выберите Сохранить, чтобы сохранить изменения.
- После успешного изменения можно найти более подробные журналы для устранения неполадок, например сведения о маршрутизации запросов.
Настройка правил генерации оповещений
Правила генерации оповещений можно создавать на основе журналов и метрик. Дополнительные сведения см. в разделе "Создание или изменение правила генерации оповещений метрик".
Выполните следующие действия, чтобы напрямую создать правила генерации оповещений из портал Azure для Azure Spring Apps:
- Откройте экземпляр Azure Spring Apps.
- Перейдите к журналам или метрикам.
- Напишите запрос журнала в области журналов или добавьте диаграмму метрик.
- Выберите Новое правило генерации оповещений. Это действие выполняется в области "Создание правила генерации оповещений", а запрос журнала или метрики заполняются автоматически.
Теперь можно настроить сведения о правиле генерации оповещений.
Мониторинг шлюза с помощью монитора производительности приложений
Дополнительные сведения о поддерживаемых мониторах производительности приложений и их настройке см. в разделе "Настройка мониторинга производительности приложений" в разделе "Настройка шлюза VMware Spring Cloud".
Перезапуск шлюза
Для некоторых ошибок перезапуск может помочь решить проблему. Дополнительные сведения см. в разделе "Перезапуск Spring Cloud Gateway" раздела "Настройка шлюза VMware Spring Cloud".