Introdução ao componente Spring Boot Admin da Ferramenta de Diagnóstico Java (diag4j) no Serviço Kubernetes do Azure

Este artigo fornece instruções passo a passo para configurar e começar a usar o componente Spring Boot Admin da Ferramenta de Diagnóstico Java (diag4j) no Serviço Kubernetes do Azure (AKS). Seguindo estas etapas, você pode monitorar e diagnosticar seus aplicativos Java de forma eficiente.

Pré-requisitos

  • Um cluster AKS em execução com as permissões necessárias.
  • kubectl instalado e configurado para acessar seu cluster AKS.
  • Helm instalado no seu computador local.
  • Aplicações Java implementadas no AKS. Para obter mais informações, consulte Implantar o aplicativo Spring Boot no Serviço Kubernetes do Azure. A ferramenta funciona melhor quando os pontos finais do atuador Spring Boot estão ativados.
  • Acesso do desenvolvedor ao namespace que hospeda diag4j. Certifique-se de que você pode executar kubectl port-forward.

Instale o diag4j no seu cluster

Use o seguinte comando para instalar o diag4j no namespace desejado:

helm install my-diag4j oci://diag4j.azurecr.io/helm/diag4j --version 1.1.5 -n <namespace> --create-namespace

Criar um componente Spring Boot Admin

Use os seguintes comandos para criar um componente Spring Boot Admin (SBA):

  1. Aplique um recurso personalizado (CR) para criar um componente Spring Boot Admin. Crie um arquivo chamado spring-boot-admin.yamle, em seguida, adicione o seguinte conteúdo. Substitua <namespace> pelo namespace em que seus aplicativos Spring Boot estão sendo executados. A SBA descobre automaticamente aplicações cujos pontos finais dos atuadores estão expostos. Outros são apresentados com o estado DOWN no painel de controlo.

    apiVersion: diagtool4j.microsoft.com/v1alpha1
kind: Component
metadata:
    name: spring-boot-admin
    namespace: <namespace>
spec:
    type: SpringBootAdmin

  2. Utilize o seguinte comando para aplicar a CR:

    kubectl apply -f spring-boot-admin.yaml

Acesse o painel do diag4j

Use as seguintes etapas para acessar o painel:

  1. Use o seguinte comando para configurar o encaminhamento de porta local para o servidor SBA:

    kubectl port-forward svc/spring-boot-admin-azure-java -n <namespace> 8080:8080

  2. Aceda a http://localhost:8080 no seu navegador para ver o painel da SBA. Todas as aplicações no mesmo espaço de nomes registam-se automaticamente.

    Captura de tela do painel de administração do Spring Boot.

Usar os recursos de diagnóstico

Para visualizar as métricas da aplicação, selecione a aplicação no painel da SBA. Pode visualizar métricas em tempo real, incluindo as seguintes:

  • Utilização de CPU e memória
  • Estado da recolha de lixo (GC)
  • Threads ativos e variáveis de ambiente

Captura de tela da página do painel Administrador do Spring Boot que mostra as métricas do aplicativo.

Para ajustar os níveis de registo, vá à secção Registadores. Pode então modificar dinamicamente os níveis de registo de pacotes ou classes específicos para isolar problemas.

Captura de tela da página do painel Administrador do Spring Boot que mostra a seção Loggers.

Para executar diagnósticos avançados, gere despejos de heap e thread dumps para análise aprofundada.

Próximo passo

Introdução ao Java Diagnostic Agent

  • Last updated on