Introducción al componente administrador de Spring Boot de la herramienta de diagnóstico de Java (diag4j) en Azure Kubernetes Service

Artículo
02/10/2025

En este artículo se proporcionan instrucciones paso a paso para configurar y empezar a usar el componente administrador de Spring Boot de la herramienta de diagnóstico de Java (diag4j) en Azure Kubernetes Service (AKS). Siguiendo estos pasos, puede supervisar y diagnosticar las aplicaciones Java de forma eficaz.

Prerrequisitos

Un clúster de AKS en ejecución con los permisos necesarios.
kubectl instalado y configurado para acceder al clúster de AKS.
Helm está instalado en su equipo local.
Aplicaciones Java implementadas en AKS. Para más información, consulte Implementación de una aplicación de Spring Boot en Azure Kubernetes Service. La herramienta funciona mejor cuando se habilitan los puntos de conexión del accionador de Spring Boot.
Acceso para desarrolladores al espacio de nombres que hospeda diag4j. Asegúrese de que puede ejecutar kubectl port-forward.

Instalación de diag4j en el clúster

Use el siguiente comando para instalar diag4j en el espacio de nombres deseado:

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

Creación de un componente de administrador de Spring Boot

Use los siguientes comandos para crear un componente de administrador de Spring Boot (SBA):

Aplique un recurso personalizado (CR) para crear un componente de administrador de Spring Boot. Cree un archivo denominado spring-boot-admin.yamly agregue el siguiente contenido. Reemplace <namespace> por el espacio de nombres en el que se ejecutan las aplicaciones de Spring Boot. SBA detectará automáticamente las aplicaciones cuyos puntos de conexión del accionador están expuestos. Los otros se mostrarán en el panel con el estado DOWN.
```
apiVersion: diagtool4j.microsoft.com/v1alpha1
kind: Component
metadata:
    name: spring-boot-admin
    namespace: <namespace>
spec:
    type: SpringBootAdmin
```
Use el siguiente comando para aplicar la CR:
```
kubectl apply -f spring-boot-admin.yaml
```

Acceso al panel diag4j

Siga estos pasos para acceder al panel:

Use el siguiente comando para configurar el reenvío de puertos local al servidor SBA:
```
kubectl port-forward svc/spring-boot-admin-azure-java -n <namespace> 8080:8080
```
Vaya a http://localhost:8080 en el explorador para ver el panel de SBA. Todas las aplicaciones del mismo espacio de nombres deben registrarse automáticamente.

Uso de las características de diagnóstico

Para ver las métricas de la aplicación, haga clic en la aplicación en el panel de SBA. Puede ver las métricas en tiempo real, incluidas las siguientes:

Uso de memoria de la CPU &
Estado de recolección de basura (GC)
Subprocesos activos y variables de entorno

Para ajustar los niveles de registro, vaya a la sección Registradores. A continuación, puede modificar los niveles de registro dinámicamente para paquetes o clases específicos para aislar problemas.

Para realizar diagnósticos avanzados, genere volcados de heap y volcados de hilos para realizar su análisis detallado.

Paso siguiente

Introducción al agente de diagnóstico de Java

Compartir vía