Commencez avec le composant Admin Spring Boot de l’outil de diagnostic Java (diag4j) sur Azure Kubernetes Service

Article
02/10/2025

Cet article fournit des instructions pas à pas pour configurer et commencer à utiliser le composant d’administration Spring Boot de l’outil de diagnostic Java (diag4j) sur Azure Kubernetes Service (AKS). En suivant ces étapes, vous pouvez surveiller et diagnostiquer efficacement vos applications Java.

Conditions préalables

Un cluster AKS en cours d’exécution avec les autorisations nécessaires.
kubectl installé et configuré pour accéder à votre cluster AKS.
Helm installé sur votre machine locale.
Applications Java déployées dans AKS. Pour plus d’informations, consultez Déployer une application Spring Boot sur Azure Kubernetes Service. L’outil fonctionne mieux lorsque les points de terminaison d’actionneur Spring Boot sont activés.
Accès développeur à l’espace de noms hébergeant diag4j. Vérifiez que vous pouvez exécuter kubectl port-forward.

Installer diag4j dans votre cluster

Utilisez la commande suivante pour installer diag4j dans l’espace de noms souhaité :

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

Créer un composant d’administration Spring Boot

Utilisez les commandes suivantes pour créer un composant Spring Boot Admin (SBA) :

Appliquez une ressource personnalisée (CR) pour créer un composant d’administration Spring Boot. Créez un fichier nommé spring-boot-admin.yaml, puis ajoutez le contenu suivant. Remplacez <namespace> par l’espace de noms dans lequel vos applications Spring Boot s’exécutent. SBA découvre automatiquement les applications dont les points de terminaison d’actionneur sont exposés. Les autres s'afficheront avec le statut DOWN sur le tableau de bord.
```
apiVersion: diagtool4j.microsoft.com/v1alpha1
kind: Component
metadata:
    name: spring-boot-admin
    namespace: <namespace>
spec:
    type: SpringBootAdmin
```
Utilisez la commande suivante pour appliquer le CR :
```
kubectl apply -f spring-boot-admin.yaml
```

Accéder au tableau de bord diag4j

Pour accéder au tableau de bord, procédez comme suit :

Utilisez la commande suivante pour configurer le transfert de port local vers le serveur SBA :
```
kubectl port-forward svc/spring-boot-admin-azure-java -n <namespace> 8080:8080
```
Accédez à http://localhost:8080 dans votre navigateur pour afficher le tableau de bord SBA. Toutes les applications du même espace de noms doivent être enregistrées automatiquement.

Utiliser les fonctionnalités de diagnostic

Pour afficher les métriques d’application, cliquez sur l’application dans le tableau de bord SBA. Vous pouvez afficher les métriques en temps réel, notamment les métriques suivantes :

Utilisation de la mémoire & du processeur
État de la collecte des ordures (GC)
Threads actifs et variables d’environnement

Pour ajuster les niveaux de journal, accédez à la section journaux. Vous pouvez ensuite modifier dynamiquement les niveaux de journal pour des packages ou des classes spécifiques afin d’isoler les problèmes.

Pour effectuer des diagnostics avancés, générez des dumps de tas et des dumps de threads pour une analyse approfondie.

Étape suivante

Prise en main de l’agent de diagnostic Java

Partager via