Comece a usar o componente Spring Boot Admin da Ferramenta de Diagnóstico Java (diag4j) no Serviço de Kubernetes do Azure

Artigo
02/11/2025

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

Pré-requisitos

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

Instalar diag4j em 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 do Administrador do Spring Boot

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

Aplique um CR (recurso personalizado) para criar um componente do Administrador do Spring Boot. Crie um arquivo chamado spring-boot-admin.yaml e adicione o conteúdo a seguir. Substitua <namespace> pelo namespace no qual seus aplicativos spring boot estão em execução. O SBA descobrirá automaticamente aplicativos cujos pontos de extremidade do atuador são expostos. Outros aparecerão com o status DOWN no painel.
```
apiVersion: diagtool4j.microsoft.com/v1alpha1
kind: Component
metadata:
    name: spring-boot-admin
    namespace: <namespace>
spec:
    type: SpringBootAdmin
```

Use o seguinte comando para aplicar o CR:

kubectl apply -f spring-boot-admin.yaml

Acesse o painel diag4j

Use as seguintes etapas para acessar o painel:

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
```
Navegue até http://localhost:8080 no navegador para exibir o painel do SBA. Todos os aplicativos no mesmo namespace devem ser registrados automaticamente.

Usar os recursos de diagnóstico

Para exibir as métricas do aplicativo, clique no aplicativo no painel do SBA. Você pode exibir métricas em tempo real, incluindo as seguintes métricas:

Uso de memória da CPU &
Status da coleta de lixo (GC)
Threads ativos e variáveis de ambiente

Para ajustar os níveis de log, navegue até a seção Registradores. Em seguida, você pode modificar os níveis de log dinamicamente para pacotes ou classes específicos para isolar problemas.

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

Próxima etapa

Introdução ao Agente de Diagnóstico Java

Compartilhar via