Erste Schritte mit der Spring Boot Admin-Komponente des Java-Diagnosetools (diag4j) auf Azure Kubernetes Service

Artikel
02/12/2025

Dieser Artikel enthält schrittweise Anleitungen zum Einrichten und Starten der Verwendung der Spring Boot Admin-Komponente des Java-Diagnosetools (diag4j) in Azure Kubernetes Service (AKS). Mithilfe dieser Schritte können Sie Ihre Java-Anwendungen effizient überwachen und diagnostizieren.

Voraussetzungen

Ein laufender AKS-Cluster mit den erforderlichen Berechtigungen.
kubectl installiert und für den Zugriff auf Ihren AKS-Cluster konfiguriert.
Helm muss auf dem lokalen Computer installiert sein.
In AKS bereitgestellte Java-Anwendungen. Weitere Informationen finden Sie unter Deploy Spring Boot Application to Azure Kubernetes Service. Das Tool funktioniert besser, wenn Spring Boot-Aktorendpunkte aktiviert sind.
Entwicklerzugriff auf den Namespace, der diag4j hosten soll. Stellen Sie sicher, dass Sie kubectl port-forwardausführen können.

Installieren von diag4j in Ihrem Cluster

Verwenden Sie den folgenden Befehl, um diag4j im gewünschten Namespace zu installieren:

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

Erstellen einer Spring Boot Admin-Komponente

Verwenden Sie die folgenden Befehle, um eine Spring Boot Admin (SBA)-Komponente zu erstellen:

Wenden Sie eine benutzerdefinierte Ressource (CR) an, um eine Spring Boot Admin-Komponente zu erstellen. Erstellen Sie eine Datei mit dem Namen spring-boot-admin.yaml, und fügen Sie dann den folgenden Inhalt hinzu. Ersetzen Sie <namespace> durch den Namespace, in dem Ihre Spring Boot-Apps ausgeführt werden. Die SBA ermittelt automatisch Apps, deren Aktorendpunkte verfügbar gemacht werden. Andere werden mit dem Status DOWN im Dashboard angezeigt.
```
apiVersion: diagtool4j.microsoft.com/v1alpha1
kind: Component
metadata:
    name: spring-boot-admin
    namespace: <namespace>
spec:
    type: SpringBootAdmin
```
Verwenden Sie den folgenden Befehl, um die CR anzuwenden:
```
kubectl apply -f spring-boot-admin.yaml
```

Zugreifen auf das diag4j-Dashboard

Führen Sie die folgenden Schritte aus, um auf das Dashboard zuzugreifen:

Verwenden Sie den folgenden Befehl, um die lokale Portweiterleitung an den SBA-Server zu konfigurieren:
```
kubectl port-forward svc/spring-boot-admin-azure-java -n <namespace> 8080:8080
```
Navigieren Sie in Ihrem Browser zu http://localhost:8080, um das SBA-Dashboard anzuzeigen. Alle Anwendungen im selben Namespace sollten automatisch registriert werden.

Verwenden Sie die Diagnosefunktionen

Um Anwendungsmetriken anzuzeigen, klicken Sie im SBA-Dashboard auf die Anwendung. Sie können Echtzeitmetriken anzeigen, einschließlich der folgenden Metriken:

CPU-& Arbeitsspeicherauslastung
Garbage Collection-Status (GC-Status)
Aktive Threads und Umgebungsvariablen

Um Protokollierungsstufen einzustellen, navigieren Sie zum Abschnitt Protokollierungen. Anschließend können Sie die Protokollierungsstufen für bestimmte Pakete oder Klassen dynamisch anpassen, um Probleme zu isolieren.

Generieren Sie für erweiterte Diagnosen Heap- und Threaddumps, die eine eingehende Analyse ermöglichen.

Nächster Schritt

Erste Schritte mit dem Java Diagnostic Agent-

Teilen über