logo

Actuador d'arrencada Spring Boot

Actuador d'arrencada de primavera

Actuador d'arrencada de primavera és un subprojecte del Spring Boot Framework. Inclou una sèrie de funcions addicionals que ens ajuden a supervisar i gestionar l'aplicació Spring Boot. Conté els punts finals de l'actuador (el lloc on viuen els recursos). Podem utilitzar HTTP i JMX punts finals per gestionar i supervisar l'aplicació Spring Boot. Si volem obtenir funcions preparades per a la producció en una aplicació, hauríem d'utilitzar S pring Actuador d'arrencada.

Característiques de l'actuador d'arrencada de primavera

N'hi ha tres característiques principals de Spring Boot Actuator:

    Punts finals Mètriques Auditoria

Punt final: Els punts finals de l'actuador ens permeten supervisar i interactuar amb l'aplicació. Spring Boot proporciona una sèrie de punts finals integrats. També podem crear el nostre propi punt final. Podem habilitar i desactivar cada punt final individualment. La majoria de l'aplicació tria HTTP , on l'Id del punt final, juntament amb el prefix de / actuador, està assignat a un URL.

Per exemple, el /salut endpoint proporciona la informació bàsica de salut d'una aplicació. L'actuador, per defecte, el va assignar /actuador/salut .

Mètriques: Spring Boot Actuator proporciona mètriques dimensionals mitjançant la integració amb el micròmetre . El micròmetre està integrat a Spring Boot. És la biblioteca d'instrumentació que impulsa el lliurament de mètriques d'aplicacions de Spring. Proporciona interfícies neutrals per a proveïdors temporitzadors, indicadors, comptadors, resums de distribució, i temporitzadors de tasques llargues amb un model de dades dimensionals.

Auditoria: Spring Boot proporciona un marc d'auditoria flexible que publica esdeveniments a un AuditEventRepository. Publica automàticament els esdeveniments d'autenticació si Spring-security està en execució.

Habilitació de l'actuador d'arrencada de primavera

Podem habilitar l'actuador injectant la dependència molla-arrencada-accionador-arrencada al fitxer pom.xml.

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

Punts finals de l'actuador d'arrencada de primavera

Els punts finals de l'actuador ens permeten supervisar i interactuar amb la nostra aplicació Spring Boot. Spring Boot inclou un nombre de punts finals integrats i també podem afegir punts finals personalitzats a l'aplicació Spring Boot.

La taula següent descriu els punts finals àmpliament utilitzats.

Id Ús Per defecte
actuador Proporciona un sistema basat en hipermèdia pàgina de descobriment per als altres punts finals. Requereix que Spring HATEOAS estigui al camí de classe. És cert
esdeveniments auditats Exposa informació d'esdeveniments d'auditoria per a l'aplicació actual. És cert
autoconfig S'utilitza per mostrar un informe de configuració automàtica que mostra tots els candidats a la configuració automàtica i el motiu pel qual 's'han aplicat' o 'no s'han aplicat'. És cert
mongetes S'utilitza per mostrar una llista completa de totes les faves de primavera de la vostra aplicació. És cert
configprops S'utilitza per mostrar una llista agrupada de totes les @ConfigurationProperties. És cert
abocador S'utilitza per realitzar un abocament de fil. És cert
env S'utilitza per exposar propietats del ConfigurableEnvironment de Spring. És cert
via de vol S'utilitza per mostrar qualsevol migració de bases de dades Flyway que s'hagi aplicat. És cert
salut S'utilitza per mostrar la informació de salut de l'aplicació. Fals
informació S'utilitza per mostrar informació arbitrària de l'aplicació. Fals
madereros S'utilitza per mostrar i modificar la configuració dels registradors a l'aplicació. És cert
liquibase S'utilitza per mostrar qualsevol migració de bases de dades de Liquibase que s'hagi aplicat. És cert
mètriques S'utilitza per mostrar informació de mètriques per a l'aplicació actual. És cert
mapes S'utilitza per mostrar una llista agrupada de tots els camins @RequestMapping. És cert
tancar S'utilitza per permetre que l'aplicació es tanqui amb gràcia. És cert
traça S'utilitza per mostrar informació de traça. És cert

Per a Spring MVC, s'utilitzen els punts finals addicionals següents.

Id Descripció Per defecte
docs S'utilitza per mostrar documentació, incloses sol·licituds d'exemple i respostes per als punts finals de l'actuador. Fals
heapdump S'utilitza per retornar un fitxer d'abocament d'heap hprof comprimit GZip. És cert
jolokia S'utilitza per exposar beans JMX a través d'HTTP (quan Jolokia es troba al camí de classe). És cert
fitxer de registre S'utilitza per retornar el contingut del fitxer de registre. És cert
prometeu S'utilitza per exposar mètriques en un format que pot ser raspat per un servidor Prometheus. Requereix una dependència de micrometer-registry-prometheus. És cert

Propietats de l'actuador Spring Boot

Spring Boot permet la seguretat de tots els punts finals de l'actuador. S'utilitza basat en formes autenticació que proporciona ID d'usuari com l'usuari i un generat aleatòriament contrasenya . També podem accedir als punts finals restringits per l'actuador personalitzant la seguretat basicauth als punts finals. Hem d'anul·lar aquesta configuració per funcions.de.administració.de.seguretat propietat. Per exemple:

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

Exemple d'actuador d'arrencada de primavera

Entendrem el concepte d'actuador a través d'un exemple.

Pas 1: Open Spring Initializr https://start.spring.io/ i crear un Maven projecte.

Pas 2: Proporcioneu el Grup nom. Hem proporcionat com.javatpoint.

Pas 3: Proporcioneu el Artefacte Id. Hem proporcionat el Exemple d'actuador d'arrencada de molla.

Pas 4: Afegiu les dependències següents: Spring Web, actuador d'arrencada Spring Boot, i Spring Data Rest Navegador HAL .

Pas 5: Feu clic a Generar botó. Quan fem clic al botó Genera, embolcalla totes les especificacions relacionades amb el projecte en un Pot fitxer i el descarrega al nostre sistema local.

Actuador d'arrencada Spring Boot

Pas 6: Extraieu el fitxer Jar i enganxeu-lo a l'espai de treball STS.

Pas 7: Importa la carpeta del projecte.

Fitxer -> Importa -> Projectes Maven existents -> Navega -> Seleccioneu la carpeta spring-boot-actuator-example -> Finalitza

Es triga un temps a importar. Després d'importar el projecte, podem veure el directori del projecte a la secció de l'explorador de paquets.

java localdate
Actuador d'arrencada Spring Boot

Pas 8: Creeu una classe de controlador. Hem creat la classe de controlador amb el nom 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!'; } } 

Pas 9: Obriu el application.properties arxivar i desactivar la funció de seguretat de l'actuador afegint la següent declaració.

application.properties

 management.security.enabled=false 

Pas 10: Executeu el SpringBootActuatorExampleApplication.java dossier.

Pas 11: Obriu el navegador i invoqueu l'URL http://localhost:8080/actuator. Torna la pàgina següent:

 {'_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}}} 

L'aplicació s'executa al port 8080 de manera predeterminada. Un cop s'ha iniciat l'actuador, podem veure la llista de tots els punts finals exposats mitjançant HTTP.

Invoquem el salut punt final invocant l'URL http://localhost:8080/actuator/health. Indica l'estatus Amunt . Significa que l'aplicació està en bon estat i funciona sense cap interrupció.

Actuador d'arrencada Spring Boot

De la mateixa manera, podem invocar altres punts finals que ens ajuden a supervisar i gestionar l'aplicació Spring Boot.


Descarrega Projecte