Подключение к экземпляру приложения для устранения неполадок

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

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

Несмотря на то что Azure Spring Apps предлагает различные управляемые подходы к устранению неполадок, вы можете захотеть провести расширенное устранение неполадок с помощью среды оболочки. Например, может потребоваться выполнить следующие задачи устранения неполадок:

• Напрямую используйте средства Java Development Kit (JDK).
• Диагностика серверных служб приложения для сетевых подключений и задержки вызовов API для экземпляров виртуальной сети и не виртуальной сети.
• Диагностика проблем с емкостью хранилища, производительностью и ЦП/памятью.

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

• Azure CLI с расширением Azure Spring Apps. Используйте следующую команду, чтобы удалить предыдущие версии и установить последнее расширение. Если вы ранее установили spring-cloud расширение, удалите его, чтобы избежать несоответствий конфигурации и версий.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• Развернутое приложение в Azure Spring Apps.

• Если вы развернули пользовательский контейнер, используйте программу оболочки. Значение по умолчанию — /bin/sh.

Назначьте роль Azure

Перед подключением к экземпляру приложения вам необходимо предоставить роль Azure Spring Apps Connect Role. Для подключения к экземпляру приложения требуется разрешение на действие данных Microsoft.AppPlatform/Spring/apps/deployments/connect/action.

Вы можете назначить роль Azure с помощью портала Azure или Azure CLI.

az role assignment create \
    --role 'Azure Spring Apps Connect Role' \
    --scope '<service-instance-resource-id>' \
    --assignee '<your-identity>'

Подключитесь к экземпляру приложения

Вы можете подключиться к экземпляру приложения с помощью портал Azure или Azure CLI.

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name>

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --instance <instance_name>

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --deployment green

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --shell-cmd /bin/bash

Устранение неполадок с экземпляром приложения

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

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

jps

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

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

jstat -gc 1

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

Отключение от экземпляра приложения

Когда вы закончите устранение неполадок, используйте exit команду для отключения от экземпляра приложения или нажмите клавиши CTRL+D.

Средства диагностики

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

• lsof — выводит список открытых файлов.
• top — отображает сводную информацию о системе и текущее использование.
• ps — получает моментальный снимок выполняемого процесса.
• netstat — печатает сетевые подключения и статистику интерфейса.
• nslookup — интерактивно запрашивает серверы имен Интернета.
• ping — проверяет, можно ли достичь сетевого узла.
• nc — считывает и записывает данные в сетевые подключения с помощью TCP или UDP.
• wget — позволяет скачивать файлы и взаимодействовать с REST API.
• df — отображает объем свободного места на диске.

Вы также можете использовать средства, упакованные в JDK, такие как jps, jcmdи jstat.

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

• Развертывание исходного кода, JAR и артефактов:
  • Базовые и стандартные планы:
    • Общие инструменты — да
    • Средства JDK — да, только для рабочих нагрузок Java.
  • Корпоративный план:
    • Общие инструменты— зависит от того, какой стек ОС вы выбрали в построителе. Да, для полного стека ОС. Нет, для базового стека операционной системы.
    • Средства JDK — да, только для рабочих нагрузок Java.
• Развертывание пользовательского образа: зависит от установленного набора инструментов в образе.

Ограничения

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

• Так как приложение работает в качестве пользователя, не являющегося корневым, невозможно выполнить некоторые действия, требующие корневого разрешения. Например, нельзя установить новые средства с помощью системного диспетчера apt / yumпакетов.

• Поскольку некоторые возможности Linux запрещены, средства, требующие специальных привилегий, например tcpdump, не работают.

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

• Самостоятельная диагностика и решение проблем в Azure Spring Apps