Трансляция журналов консоли приложений Azure Spring Apps в режиме реального времени

Примечание.

Планы Basic, Standardи Enterprise вступили в период вывода из обращения 17 марта 2025 года. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.

План стандартного потребления и выделенный план вошли в период вывода из эксплуатации 30 сентября 2024 года, с полным завершением работы к концу марта 2025 года. Дополнительные сведения см. в статье «Перенос потребления и выделенного плана Azure Spring Apps Standard на Azure Container Apps».

Эта статья относится к:✅ Java ✅ C#

Эта статья относится к:✅ Basic/Standard ✅ Enterprise

В этой статье описывается, как включить потоковую передачу журналов в Azure CLI для получения журналов консоли приложения в режиме реального времени для устранения неполадок. Вы также можете использовать параметры диагностики для анализа диагностических данных в Azure Spring Apps. Дополнительные сведения см. в разделе Анализ журналов и метрик на основе параметров диагностики. Дополнительные сведения о потоковой передаче журналов см. в потоковой передаче журналов заданий Azure Spring Apps в реальном времени и потоковой передаче журналов управляемых компонентов Azure Spring Apps в реальном времени.

Предварительные требования

• Azure CLI с расширением Azure Spring Apps версии 1.0.0 или более поздней. Установите это расширение, выполнив следующую команду: az extension add --name spring
• Экземпляр Azure Spring Apps с запущенным приложением. Дополнительные сведения см. в статье Краткое руководство. Развертывание первого приложения Azure Spring Apps.

Журналы потоков

Портал Azure

Выполните следующие действия для потоковой передачи журналов в портал Azure:

1. Перейдите на страницу "Обзор " для экземпляра службы Azure Spring Apps и выберите "Приложения " в области навигации.

2. Найдите целевое приложение и выберите контекстное меню.

3. Во всплывающем контекстном меню выберите "Просмотреть поток журналов".

   

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

Для удобства существует множество точек входа для журналов потоков. Их можно найти на следующих панелях:

• Область списка приложений
• Область списка развертывания
• Область списка экземпляров приложения

Azure CLI

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

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

Группа ресурсов и имя службы опущены в следующих примерах.

Посмотреть хвостовой лог для приложения с одним экземпляром

Если у приложения с именем auth-service есть только один экземпляр, вы можете просмотреть журнал экземпляра приложения с помощью следующей команды:

az spring app logs --name <application-name>

Команда возвращает журналы, аналогичные следующим примерам, где auth-service находится имя приложения.

...
2020-01-15 01:54:40.481  INFO [auth-service,,,] 1 --- [main] o.apache.catalina.core.StandardService  : Starting service [Tomcat]
2020-01-15 01:54:40.482  INFO [auth-service,,,] 1 --- [main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.22]
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.a.c.c.C.[Tomcat].[localhost].[/uaa]  : Initializing Spring embedded WebApplicationContext
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.s.web.context.ContextLoader  : Root WebApplicationContext: initialization completed in 7203 ms

...

Просмотр журнала хвоста для приложения с несколькими экземплярами

Если для приложения с именем auth-service существует несколько экземпляров, журнал экземпляра можно просмотреть с помощью параметра -i/--instance.

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

az spring app show --name auth-service --query properties.activeDeployment.properties.instances --output table

Команда создает результаты, аналогичные следующим выходным данным:

Name                                         Status    DiscoveryStatus
-------------------------------------------  --------  -----------------
auth-service-default-12-75cc4577fc-pw7hb  Running   UP
auth-service-default-12-75cc4577fc-8nt4m  Running   UP
auth-service-default-12-75cc4577fc-n25mh  Running   UP

Затем можно транслировать журналы экземпляра приложения с помощью -i/--instance следующим образом:

az spring app logs --name auth-service --instance auth-service-default-12-75cc4577fc-pw7hb

Кроме того, можно получить сведения об экземплярах приложения из портала Azure. Выберите Приложения в левой области навигации в службе Azure Spring Apps, затем выберите Экземпляры приложений.

Непрерывная трансляция новых логов

По умолчанию az spring app logs выводит только существующие журналы, переданные в консоль приложения, а затем завершает работу. Если вы хотите передавать новые журналы, добавьте -f/--follow аргумент, как показано в следующем примере:

az spring app logs --name auth-service --follow

При использовании аргумента --follow для мгновенных журналов служба потоковой передачи журналов Azure Spring Apps отправляет журналы пульса клиенту каждую минуту, если приложение не записывает журналы постоянно. Сообщения журнала Heartbeat используют следующий формат: 2020-01-15 04:27:13.473: No log from server

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

az spring app logs --help

Форматирование структурированных журналов JSON

Примечание.

Для форматирования структурированных журналов JSON требуется расширение spring версии 2.4.0 или более поздней.

Структурированные журналы приложений отображаются в формате JSON, который может быть трудно считывать. Аргумент можно использовать --format-json для форматирования журналов в формате JSON в более читаемый формат. Для получения дополнительной информации см. структурированный журнал приложений для Azure Spring Apps.

В следующем примере показано, как использовать --format-json аргумент:

# Raw JSON log
$ az spring app logs --name auth-service
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Disable delta property : false"}
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Single vip registry refresh property : null"}

# Formatted JSON log
$ az spring app logs --name auth-service --format-json
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Disable delta property : false
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Single vip registry refresh property : null

Аргумент --format-json также принимает необязательный настраиваемый формат при использовании синтаксиса форматирования строк. Дополнительные сведения см. в разделе "Формат строкового синтаксиса".

В следующем примере показано, как использовать синтаксис строки форматирования:

# Custom format
$ az spring app logs --name auth-service --format-json="{message}{n}"
Disable delta property : false
Single vip registry refresh property : null

По умолчанию используется формат:

{timestamp} {level:>5} [{thread:>15.15}] {logger{39}:<40.40}: {message}{n}{stackTrace}

Просмотр журнала приложения Azure Spring Apps в реальном времени в экземпляре с внедрением виртуальной сети

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

Azure Spring Apps также позволяет получать доступ к журналам приложений в режиме реального времени из общедоступной сети с помощью портал Azure или Azure CLI.

Примечание.

Включение конечной точки потоковой передачи журналов в общедоступной сети добавляет входящий общедоступный IP-адрес в вашу виртуальную сеть. Обязательно используйте осторожность, если это забота о вас.

Портал Azure

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

1. Выберите экземпляр службы Azure Spring Apps, развернутый в виртуальной сети, а затем выберите "Сеть " в меню навигации.

2. Перейдите на вкладку внедрение Vnet.

3. Переключите состояние ресурсов Dataplane в общедоступной сети на включено, чтобы разрешить потоковую передачу журналов на конечную точку в общедоступной сети. Этот процесс займет несколько минут.

   

Azure CLI

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

az spring update \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --enable-dataplane-public-endpoint true

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

Обеспечение безопасности трафика к общедоступной конечной точке потоковой передачи логов

Поток журналов использует тот же ключ, что и тестовая конечная точка, описанная в статье "Настройка промежуточной среды в Azure Spring Apps, для аутентификации подключений к вашим развертываниям. В результате только пользователи, имеющие доступ на чтение к тест-ключам, могут получать доступ к потоковой передаче журналов.

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

Примечание.

Если после включения общедоступной конечной точки потока журналов вы не можете получить доступ к журналам приложений в экземпляре виртуальной сети с функцией внедрения из Интернета, проверьте группу безопасности сети, чтобы убедиться, что такой входящий трафик разрешен.

В следующей таблице показан пример базового правила, которое мы рекомендуем. Для получения целевого IP-адреса службы можно использовать такие команды, как nslookup и конечная точка <service-name>.private.azuremicroservices.io .

Приоритет	Имя	Порт	Протокол	Источник	Назначение	Действие
100	Имя правила	80	TCP	Интернет	IP-адрес службы	Разрешить
110	Имя правила	443	TCP	Интернет	IP-адрес службы	Разрешить

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

• Краткое руководство. Мониторинг приложений Azure Spring Apps с помощью журналов, метрик и трассировки
• Анализ журналов и метрик на основе параметров диагностики
• Стриминг журналов заданий Azure Spring Apps в режиме реального времени
• Трансляция в потоковом режиме журналов компонентов под управлением Azure Spring Apps в режиме реального времени