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

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:

  1. 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. SBA ermittelt automatisch Apps, deren Aktorendpunkte verfügbar gemacht werden. Andere werden im Dashboard mit dem DOWN Status angezeigt.

    apiVersion: diagtool4j.microsoft.com/v1alpha1
    kind: Component
    metadata:
        name: spring-boot-admin
        namespace: <namespace>
    spec:
        type: SpringBootAdmin
    
  2. 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:

  1. 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
    
  2. Gehen Sie in Ihrem Browser zu http://localhost:8080, um das SBA-Dashboard anzuzeigen. Alle Anwendungen im selben Namespace werden automatisch registriert.

    Screenshot des Spring Boot Admin-Dashboards.

Verwenden Sie die Diagnosefunktionen

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

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

Screenshot der Dashboardseite des Spring Boot Admin, auf der Anwendungsmetriken angezeigt werden.

Um die Protokollstufen anzupassen, wechseln Sie zum Abschnitt Loggers. Anschließend können Sie die Log-Level für bestimmte Pakete oder Klassen dynamisch ändern, um Probleme zu isolieren.

Screenshot der Dashboardseite

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-