Conectar-se a uma instância de aplicativo para solução de problemas

Este artigo aplica-se a: ✔️ Basic/Standard ✔️ Enterprise

Este artigo descreve como acessar o ambiente de shell dentro de suas instâncias de aplicativo para fazer a solução de problemas avançada.

Embora o Azure Spring Apps ofereça várias abordagens de solução de problemas gerenciadas, convém fazer a solução de problemas avançada usando o ambiente de shell. Por exemplo, talvez você queira realizar as seguintes tarefas de solução de problemas:

• Use diretamente as ferramentas do Java Development Kit (JDK).
• Diagnostique os serviços back-end de um aplicativo para conexão de rede e latência de chamada de API para instâncias de rede virtual e não virtual.
• Diagnostique problemas de capacidade de armazenamento, desempenho e CPU/memória.

Pré-requisitos

• CLI do Azure com a extensão Azure Spring Apps. Use o comando a seguir para remover versões anteriores e instalar a extensão mais recente. Se você instalou spring-cloud a extensão anteriormente, desinstale-a para evitar incompatibilidades de configuração e versão.

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

• Um aplicativo implantado no Azure Spring Apps.

• Se você implantou um contêiner personalizado, um programa shell. A predefinição é /bin/sh.

Atribuir uma função do Azure

Antes de se conectar a uma instância de aplicativo, você deve receber a função Azure Spring Apps Connect Role. A conexão com uma instância de aplicativo requer a permissão Microsoft.AppPlatform/Spring/apps/deployments/connect/actionde ação de dados .

Você pode atribuir uma função do Azure usando o portal do Azure ou a CLI do Azure.

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

Conectar-se a uma instância do aplicativo

Você pode se conectar a uma instância de aplicativo usando o portal do Azure ou a CLI do Azure.

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

Solucionar problemas da instância do aplicativo

Depois de se conectar a uma instância do aplicativo, você pode verificar o status da memória de pilha.

Use o seguinte comando para localizar o ID do processo Java, que geralmente 1é:

jps

A saída deve ser semelhante ao exemplo a seguir:

Em seguida, use o seguinte comando para executar a ferramenta JDK para verificar o resultado:

jstat -gc 1

A saída deve ser semelhante ao exemplo a seguir:

Desconectar da instância do aplicativo

Quando terminar a solução de problemas, use o exit comando para se desconectar da instância do aplicativo ou pressione Ctrl+d.

Ferramentas de resolução de problemas

A lista a seguir descreve algumas das ferramentas pré-instaladas que você pode usar para solucionar problemas:

• lsof - Lista arquivos abertos.
• top - Exibe informações de resumo do sistema e utilização atual.
• ps - Obtém um instantâneo do processo em execução.
• netstat - Imprime conexões de rede e estatísticas de interface.
• nslookup - Consulta servidores de nomes de internet de forma interativa.
• ping - Testa se um host de rede pode ser alcançado.
• nc - Lê e grava em conexões de rede usando TCP ou UDP.
• wget - Permite baixar arquivos e interagir com APIs REST.
• df - Exibe a quantidade de espaço em disco disponível.

Você também pode usar ferramentas agrupadas pelo JDK, como jps, jcmde jstat.

A lista a seguir mostra as ferramentas disponíveis, que dependem do seu plano de serviço e do tipo de implantação do aplicativo:

• Implantação de código-fonte, JAR e artefatos:
  • Consumo Básico, Padrão e Padrão & Plano Dedicado:
    • Ferramentas comuns - Sim
    • Ferramentas JDK - Sim, apenas para cargas de trabalho Java.
  • Plano Empresarial:
    • Ferramentas comuns - Depende de qual pilha de sistema operacional você escolheu em seu construtor. Sim, para o Full OS Stack. Não, para o SO base Stack.
    • Ferramentas JDK - Sim, apenas para cargas de trabalho Java.
• Implantação de imagem personalizada: depende do conjunto de ferramentas instaladas na imagem.

Limitações

Usar o ambiente de shell dentro de suas instâncias de aplicativo tem as seguintes limitações:

• Como o aplicativo está sendo executado como um usuário não-root, você não pode executar algumas ações que exigem permissão de root. Por exemplo, não é possível instalar novas ferramentas usando o gerenciador apt / yumde pacotes do sistema.

• Como alguns recursos do Linux são proibidos, ferramentas que exigem privilégios especiais, como tcpdump, não funcionam.

Próximos passos

• Autodiagnóstico e resolver problemas no Azure Spring Apps