Actuator cu arc
Actuator cu arc este un subproiect al Spring Boot Framework. Include o serie de caracteristici suplimentare care ne ajută să monitorizăm și să gestionăm aplicația Spring Boot. Conține punctele finale ale actuatorului (locul în care trăiesc resursele). Putem folosi HTTP și JMX puncte finale pentru a gestiona și monitoriza aplicația Spring Boot. Dacă vrem să obținem funcții pregătite pentru producție într-o aplicație, ar trebui să folosim S pring Acţionare de pornire.
Caracteristici ale actuatorului Spring Boot
Sunt Trei Principalele caracteristici ale Spring Boot Actuator:
Punct final: Punctele finale ale actuatorului ne permit să monitorizăm și să interacționăm cu aplicația. Spring Boot oferă o serie de puncte finale încorporate. De asemenea, ne putem crea propriul punct final. Putem activa și dezactiva fiecare punct final individual. Majoritatea aplicației aleg HTTP , unde ID-ul punctului final, împreună cu prefixul de /actuator, este mapat la o adresă URL.
De exemplu, cel /sănătate endpoint oferă informațiile de bază privind sănătatea unei aplicații. Actuatorul, în mod implicit, l-a mapat la /actuator/sănătate .
Valori: Spring Boot Actuator oferă valori dimensionale prin integrarea cu micrometru . Micrometrul este integrat în Spring Boot. Este biblioteca de instrumente care alimentează livrarea de valori ale aplicației de la Spring. Oferă interfețe neutre pentru furnizori cronometre, manometre, contoare, rezumate de distribuție, și cronometre pentru sarcini lungi cu un model de date dimensionale.
Audit: Spring Boot oferă un cadru de audit flexibil care publică evenimente la un AuditEventRepository. Publică automat evenimentele de autentificare dacă Spring-security este în execuție.
Activarea actuatorului Spring Boot
Putem activa actuatorul prin injectarea dependenței arc-boot-demaror-actuator în fișierul pom.xml.
java char la int
org.springframework.boot spring-boot-starter-actuator 2.2.2.RELEASE
Puncte finale ale actuatorului Spring Boot
Punctele finale ale actuatorului ne permit să monitorizăm și să interacționăm cu aplicația noastră Spring Boot. Spring Boot include un număr de puncte finale încorporate și putem adăuga, de asemenea, puncte finale personalizate în aplicația Spring Boot.
Următorul tabel descrie punctele finale utilizate pe scară largă.
Id | Utilizare | Mod implicit |
---|---|---|
actuator | Oferă un sistem bazat pe hipermedia pagina de descoperire pentru celelalte puncte finale. Este necesar ca Spring HATEOAS să fie pe calea clasei. | Adevărat |
auditevenimente | Acesta expune informații despre evenimentele de audit pentru aplicația curentă. | Adevărat |
autoconfig | Este folosit pentru a afișa un raport de auto-configurare care arată toți candidații de auto-configurare și motivul pentru care „au fost” sau „nu au fost” aplicați. | Adevărat |
fasole | Este folosit pentru a afișa o listă completă a tuturor boabelor de primăvară din aplicația dvs. | Adevărat |
configprops | Este folosit pentru a afișa o listă colazionată a tuturor @ConfigurationProperties. | Adevărat |
haldă | Este folosit pentru a efectua un dump de fir. | Adevărat |
înv | Este folosit pentru a expune proprietățile din ConfigurableEnvironment din Spring. | Adevărat |
calea de zbor | Este folosit pentru a afișa orice migrare a bazei de date Flyway care au fost aplicate. | Adevărat |
sănătate | Este folosit pentru a afișa informații despre sănătatea aplicației. | Fals |
info | Este folosit pentru a afișa informații arbitrare ale aplicației. | Fals |
tăietori de lemne | Este folosit pentru a afișa și modifica configurația loggerelor din aplicație. | Adevărat |
lichidbază | Este folosit pentru a afișa orice migrare a bazei de date Liquibase care au fost aplicate. | Adevărat |
metrici | Este folosit pentru a afișa informații despre valori pentru aplicația curentă. | Adevărat |
mapări | Este folosit pentru a afișa o listă colazionată a tuturor căilor @RequestMapping. | Adevărat |
închide | Este folosit pentru a permite închiderea grațioasă a aplicației. | Adevărat |
urmă | Este folosit pentru a afișa informații de urmărire. | Adevărat |
Pentru Spring MVC, sunt utilizate următoarele puncte finale suplimentare.
Id | Descriere | Mod implicit |
---|---|---|
docs | Este folosit pentru a afișa documentația, inclusiv exemple de cereri și răspunsuri pentru punctele finale ale actuatorului. | Fals |
heapdump | Este folosit pentru a returna un fișier hprof dump comprimat GZip. | Adevărat |
jolokia | Este folosit pentru a expune bean-urile JMX prin HTTP (atunci când Jolokia este pe classpath). | Adevărat |
fișier jurnal | Este folosit pentru a returna conținutul fișierului jurnal. | Adevărat |
prometeu | Este folosit pentru a expune valorile într-un format care poate fi răzuit de un server prometheus. Necesită o dependență de micrometru-registru-prometheus. | Adevărat |
Proprietățile actuatorului Spring Boot
Spring Boot asigură securitatea pentru toate punctele finale ale actuatorului. Folosește bazată pe formă autentificare care oferă ID-ul de utilizator ca utilizator și un generat aleatoriu parola . Putem accesa, de asemenea, puncte finale restricționate de actuator, personalizând securitatea basicauth la punctele finale. Trebuie să suprascriem această configurație prin rolurile.de.conducere.securitate proprietate. De exemplu:
management.security.enabled=true management.security.roles=ADMIN security.basic.enabled=true security.user.name=admin security.user.passowrd=admin
Exemplu de actuator de pornire cu arc
Să înțelegem conceptul de actuator printr-un exemplu.
Pasul 1: Open Spring Initializr https://start.spring.io/ și creați o Maven proiect.
Pasul 2: Furnizați grup Nume. Noi am asigurat com.javatpoint.
Pasul 3: Furnizați Artefact Id. Noi am furnizat arc-boot-actuator-exemplu.
Pasul 4: Adăugați următoarele dependențe: Spring Web, actuator de pornire Spring Boot, și Spring Data Rest HAL Browser .
Pasul 5: Faceți clic pe Genera buton. Când facem clic pe butonul Generare, acesta împachetează toate specificațiile legate de proiect într-un Borcan fișier și îl descarcă în sistemul nostru local.
Pasul 6: Extrageți fișierul Jar și lipiți-l în spațiul de lucru STS.
Pasul 7: Importați folderul proiectului.
Fișier -> Import -> Proiecte Maven existente -> Răsfoiți -> Selectați folderul spring-boot-actuator-example -> Finish
Este nevoie de ceva timp pentru a importa. După importarea proiectului, putem vedea directorul proiectului în secțiunea Explorator de pachete.
Pasul 8: Creați o clasă Controller. Am creat clasa de controler cu numele DemoRestController.
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!'; } }
Pasul 9: Deschide aplicație.proprietăți fișier și dezactivați caracteristica de securitate a actuatorului adăugând următoarea declarație.
aplicație.proprietăți
management.security.enabled=false
Pasul 10: Rulați SpringBootActuatorExampleApplication.java fişier.
Pasul 11: Deschideți browserul și invocați adresa URL http://localhost:8080/actuator. Acesta returnează următoarea pagină:
șir de caractere java compară
{'_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}}}
Aplicația rulează implicit pe portul 8080. Odată ce actuatorul a pornit, putem vedea lista tuturor punctelor finale expuse prin HTTP.
Să invocăm sănătate punctul final prin invocarea adresei URL http://localhost:8080/actuator/health. Ea denotă starea SUS . Înseamnă că aplicația este sănătoasă și rulează fără nicio întrerupere.
În mod similar, putem invoca alte puncte finale care ne ajută să monitorizăm și să gestionăm aplicația Spring Boot.
Descărcați proiectul