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:
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.
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
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ó.
De la mateixa manera, podem invocar altres punts finals que ens ajuden a supervisar i gestionar l'aplicació Spring Boot.
Descarrega Projecte