32 Spring Boot Actuator: Überblick und Anpassungen

Spring Boot Actuator ist ein Teil von Spring Boot, der es ermöglicht, die Anwendung im Produktionsbetrieb zu überwachen und zu verwalten. Es bietet eine Reihe von vorgefertigten Endpunkten, die Einblicke in die Anwendung und ihre Betriebsbedingungen geben.

32.1 Default Endpoints

Einige der Standardendpunkte umfassen:

• health: Zeigt Anwendungsgesundheitsinformationen.
• info: Zeigt beliebige Anwendungsinfo.
• metrics: Liefert Metriken der Anwendung.
• loggers: Ermöglicht das Abfragen und Modifizieren der Logger-Konfigurationen.
• httptrace: Zeigt Trace-Informationen für die letzten HTTP-Anfragen.
• env: Zeigt die aktuellen Umgebungs-Eigenschaften.

32.2 Aktivierung und Deaktivierung von Endpunkten

Standardmäßig sind nicht alle Endpunkte aktiviert. Die Aktivierung oder Deaktivierung von Endpunkten kann über die application.properties oder application.yml Datei der Anwendung gesteuert werden.

management.endpoint.<endpoint>.enabled=true

Um einen Endpunkt zu deaktivieren, setzen Sie den Wert auf false.

32.3 Eigene Endpunkte definieren

Um eigene Metriken bereitzustellen, kann man eigene Endpunkte definieren. Dafür kann die @Endpoint Annotation verwendet werden. Innerhalb des Endpunkts können dann mit @ReadOperation, @WriteOperation und @DeleteOperation spezifische Operationen angeboten werden.

32.3.1 Beispiel für einen eigenen Endpunkt

import org.springframework.boot.actuate.endpoint.annotation.Endpoint;
import org.springframework.boot.actuate.endpoint.annotation.ReadOperation;
import org.springframework.stereotype.Component;

@Component
@Endpoint(id = "customMetrics")
public class CustomMetricsEndpoint {

    @ReadOperation
    public CustomMetrics customMetrics() {
        // Logik zur Rückgabe eigener Metriken
        return new CustomMetrics();
    }
}

Dies definiert einen neuen Endpunkt customMetrics, der über eine HTTP-GET-Anfrage zugänglich ist.

32.4 Zusammenfassung

Spring Boot Actuator bietet eine mächtige Möglichkeit, Anwendungen im Betrieb zu überwachen und zu verwalten. Die Anpassung und Erweiterung der Standardfunktionalitäten ermöglicht eine tiefe Integration in die Anwendung.