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

Artigo
02/09/2025

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):

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. O SBA descobrirá automaticamente aplicações cujos endpoints de atuadores estão expostos. Outros serão exibidos com o status DOWN no painel.
```
apiVersion: diagtool4j.microsoft.com/v1alpha1
kind: Component
metadata:
    name: spring-boot-admin
    namespace: <namespace>
spec:
    type: SpringBootAdmin
```
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:

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 visualizar o painel do SBA. Todos os aplicativos no mesmo namespace devem ser registrados automaticamente.

Usar os recursos de diagnóstico

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

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

Para ajustar os níveis de log, navegue para a seção Loggers. 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 thread dumps para análise aprofundada.

Próximo passo

Introdução ao Java Diagnostic Agent

Partilhar via