logo

Federstarter-Aktuator

Federmanschettenaktuator

Federmanschettenaktuator ist ein Unterprojekt des Spring Boot Frameworks. Es enthält eine Reihe zusätzlicher Funktionen, die uns helfen, die Spring Boot-Anwendung zu überwachen und zu verwalten. Es enthält die Aktor-Endpunkte (den Ort, an dem die Ressourcen leben). Wir können benutzen HTTP Und JMX Endpunkte zum Verwalten und Überwachen der Spring Boot-Anwendung. Wenn wir produktionsbereite Funktionen in einer Anwendung erhalten möchten, sollten wir S. verwenden pring Boot-Aktuator.

Merkmale des Federmanschettenaktuators

Es gibt drei Hauptmerkmale des Spring Boot Actuators:

    Endpunkte Metriken Prüfung

Endpunkt: Mithilfe der Aktuatorendpunkte können wir die Anwendung überwachen und mit ihr interagieren. Spring Boot bietet eine Reihe integrierter Endpunkte. Wir können auch unseren eigenen Endpunkt erstellen. Wir können jeden Endpunkt einzeln aktivieren und deaktivieren. Die meisten Anwendungen werden ausgewählt HTTP , wobei die ID des Endpunkts zusammen mit dem Präfix von /Aktuator, wird einer URL zugeordnet.

Zum Beispiel die /Gesundheit Der Endpunkt stellt die grundlegenden Gesundheitsinformationen einer Anwendung bereit. Der Aktor hat es standardmäßig zugeordnet /Aktuator/Gesundheit .

Metriken: Spring Boot Actuator bietet dimensionale Metriken durch die Integration mit Mikrometer . Das Mikrometer ist in Spring Boot integriert. Es handelt sich um die Instrumentierungsbibliothek, die die Bereitstellung von Anwendungsmetriken von Spring ermöglicht. Es bietet herstellerneutrale Schnittstellen für Timer, Messgeräte, Zähler, Verteilungsübersichten, Und lange Aufgabentimer mit einem dimensionalen Datenmodell.

Word-Symbolleiste für den Schnellzugriff

Prüfung: Spring Boot bietet ein flexibles Audit-Framework, das Ereignisse auf einem veröffentlicht AuditEventRepository. Es veröffentlicht automatisch die Authentifizierungsereignisse, wenn Spring-Security ausgeführt wird.

Aktivieren des Spring-Boot-Aktuators

Wir können den Aktuator aktivieren, indem wir die Abhängigkeit einfügen Federstarter-Aktuator in der pom.xml-Datei.

 org.springframework.boot spring-boot-starter-actuator 2.2.2.RELEASE 

Endpunkte des Spring-Boot-Aktuators

Mithilfe der Aktuatorendpunkte können wir unsere Spring Boot-Anwendung überwachen und mit ihr interagieren. Spring Boot umfasst eine Reihe integrierter Endpunkte und wir können auch benutzerdefinierte Endpunkte in der Spring Boot-Anwendung hinzufügen.

In der folgenden Tabelle werden die häufig verwendeten Endpunkte beschrieben.

Ausweis Verwendung Standard
Aktuator Es bietet eine Hypermedia-basierte Entdeckungsseite für die anderen Endpunkte. Es erfordert, dass sich Spring HATEOAS im Klassenpfad befindet. WAHR
Prüfereignisse Es stellt Informationen zu Prüfereignissen für die aktuelle Anwendung bereit. WAHR
Autokonfiguration Es wird verwendet, um einen Autokonfigurationsbericht anzuzeigen, in dem alle Autokonfigurationskandidaten und der Grund aufgeführt sind, warum sie angewendet wurden oder nicht. WAHR
Bohnen Es wird verwendet, um eine vollständige Liste aller Spring Beans in Ihrer Anwendung anzuzeigen. WAHR
configprops Es wird verwendet, um eine sortierte Liste aller @ConfigurationProperties anzuzeigen. WAHR
entsorgen Es wird verwendet, um einen Thread-Dump durchzuführen. WAHR
env Es wird verwendet, um Eigenschaften aus Springs ConfigurableEnvironment verfügbar zu machen. WAHR
Weg fliegen Es wird verwendet, um alle angewendeten Flyway-Datenbankmigrationen anzuzeigen. WAHR
Gesundheit Es wird verwendet, um Informationen zum Anwendungszustand anzuzeigen. FALSCH
die Info Es wird verwendet, um beliebige Anwendungsinformationen anzuzeigen. FALSCH
Holzfäller Es wird verwendet, um die Konfiguration von Loggern in der Anwendung anzuzeigen und zu ändern. WAHR
Flüssigkeitsbasis Es wird verwendet, um alle angewendeten Liquibase-Datenbankmigrationen anzuzeigen. WAHR
Metriken Es wird verwendet, um Metrikinformationen für die aktuelle Anwendung anzuzeigen. WAHR
Zuordnungen Es wird verwendet, um eine sortierte Liste aller @RequestMapping-Pfade anzuzeigen. WAHR
abschalten Es wird verwendet, um das ordnungsgemäße Herunterfahren der Anwendung zu ermöglichen. WAHR
verfolgen Es wird verwendet, um Trace-Informationen anzuzeigen. WAHR

Für Spring MVC werden die folgenden zusätzlichen Endpunkte verwendet.

char zu string in Java
Ausweis Beschreibung Standard
Dokumente Es dient zur Anzeige der Dokumentation, einschließlich Beispielanfragen und -antworten für die Endpunkte des Aktuators. FALSCH
Heapdump Es wird verwendet, um eine GZip-komprimierte hprof-Heap-Dump-Datei zurückzugeben. WAHR
Jolokia Es wird verwendet, um JMX-Beans über HTTP verfügbar zu machen (wenn sich Jolokia im Klassenpfad befindet). WAHR
Logdatei Es wird verwendet, um den Inhalt der Protokolldatei zurückzugeben. WAHR
Prometheus Es wird verwendet, um Metriken in einem Format bereitzustellen, das von einem Prometheus-Server gescrapt werden kann. Es erfordert eine Abhängigkeit von micrometer-registry-prometheus. WAHR

Eigenschaften des Spring Boot-Aktors

Spring Boot ermöglicht Sicherheit für alle Aktuator-Endpunkte. Es benutzt formbasiert Authentifizierung, die Folgendes bietet Benutzer-ID als Benutzer und eine zufällig generierte Passwort . Wir können auch auf Endpunkte mit Aktorbeschränkung zugreifen, indem wir die Basicauth-Sicherheit an die Endpunkte anpassen. Wir müssen diese Konfiguration überschreiben Management.Sicherheitsrollen Eigentum. Zum Beispiel:

 management.security.enabled=true management.security.roles=ADMIN security.basic.enabled=true security.user.name=admin security.user.passowrd=admin 

Beispiel für einen Federmanschettenaktuator

Lassen Sie uns das Konzept des Aktuators anhand eines Beispiels verstehen.

Schritt 1: Öffnen Sie Spring Initializr https://start.spring.io/ und erstellen Sie eine Maven Projekt.

Schritt 2: Das ____ bereitstellen Gruppe Name. Wir haben zur Verfügung gestellt com.javatpoint.

Schritt 3: Das ____ bereitstellen Artefakt Ausweis. Wir haben das bereitgestellt Beispiel für einen Federmanschettenaktuator.

Schritt 4: Fügen Sie die folgenden Abhängigkeiten hinzu: Spring Web, Spring Boot Starter Actuator, Und Spring Data Rest HAL-Browser .

Schritt 5: Klick auf das Generieren Taste. Wenn wir auf die Schaltfläche „Generieren“ klicken, werden alle projektbezogenen Spezifikationen in eine Datei zusammengefasst Krug Datei und lädt sie auf unser lokales System herunter.

Federstarter-Aktuator

Schritt 6: Extrahieren Sie die Jar-Datei und fügen Sie sie in den STS-Arbeitsbereich ein.

Schritt 7: Importieren Sie den Projektordner.

Datei -> Importieren -> Vorhandene Maven-Projekte -> Durchsuchen -> Wählen Sie den Ordner spring-boot-actuator-example -> Fertig stellen

Der Import dauert einige Zeit. Nach dem Import des Projekts können wir das Projektverzeichnis im Paket-Explorer-Bereich sehen.

Zum Array Java hinzufügen
Federstarter-Aktuator

Schritt 8: Erstellen Sie eine Controller-Klasse. Wir haben die Controller-Klasse mit dem Namen DemoRestController erstellt.

DemoRestController.java

 package com.javatpoint; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class DemoRestController { @GetMapping('/hello') public String hello() { return 'Hello User!'; } } 

Schritt 9: Öffne das application.properties Datei und deaktivieren Sie die Sicherheitsfunktion des Stellantriebs, indem Sie die folgende Anweisung hinzufügen.

application.properties

Java-Tostring
 management.security.enabled=false 

Schritt 10: Führen Sie das aus SpringBootActuatorExampleApplication.java Datei.

Schritt 11: Öffnen Sie den Browser und rufen Sie die URL http://localhost:8080/actuator auf. Es wird die folgende Seite zurückgegeben:

 {'_links':{'self':{'href':'http://localhost:8080/actuator','templated':false},'health':{'href':'http://localhost:8080/actuator/health','templated':false},'health-path':{'href':'http://localhost:8080/actuator/health/{*path}','templated':true},'info':{'href':'http://localhost:8080/actuator/info','templated':false}}} 

Die Anwendung läuft standardmäßig auf Port 8080. Sobald der Aktuator gestartet ist, können wir die Liste aller über HTTP bereitgestellten Endpunkte sehen.

Rufen wir das an Gesundheit Endpunkt durch Aufrufen der URL http://localhost:8080/actuator/health. Es bezeichnet den Status HOCH . Dies bedeutet, dass die Anwendung fehlerfrei ist und ohne Unterbrechung ausgeführt wird.

Federstarter-Aktuator

Ebenso können wir andere Endpunkte aufrufen, die uns bei der Überwachung und Verwaltung der Spring Boot-Anwendung helfen.


Projekt herunterladen