Pružinový startovací aktuátor
Pohon pružiny
Pohon pružiny je dílčím projektem Spring Boot Framework. Obsahuje řadu dalších funkcí, které nám pomáhají sledovat a spravovat aplikaci Spring Boot. Obsahuje koncové body aktuátoru (místo, kde se nacházejí zdroje). Můžeme použít HTTP a JMX koncové body pro správu a monitorování aplikace Spring Boot. Pokud chceme v aplikaci získat funkce připravené pro výrobu, měli bychom použít S pružina Boot aktuátor.
Vlastnosti pružinového spouštěcího aktuátoru
Existují tři hlavní vlastnosti Spring Boot Actuator:
Koncový bod: Koncové body aktuátoru nám umožňují monitorovat aplikaci a komunikovat s ní. Spring Boot poskytuje řadu vestavěných koncových bodů. Můžeme si také vytvořit vlastní koncový bod. Můžeme povolit a zakázat každý koncový bod samostatně. Většina aplikací si vybere HTTP , kde ID koncového bodu spolu s předponou /pohon, je namapován na URL.
Například, /zdraví koncový bod poskytuje základní informace o stavu aplikace. Akční člen jej ve výchozím nastavení namapoval na /aktor/zdrav .
Metriky: Spring Boot Actuator poskytuje rozměrové metriky integrací s mikrometr . Mikrometr je integrován do Spring Boot. Je to knihovna instrumentace, která pohání poskytování aplikačních metrik od Spring. Poskytuje dodavatelsky neutrální rozhraní pro časovače, měřidla, počítadla, souhrny distribuce, a dlouhé časovače úkolů s rozměrovým datovým modelem.
Audit: Spring Boot poskytuje flexibilní rámec auditu, který publikuje události AuditEventRepository. Automaticky publikuje události ověřování, pokud je spuštěna funkce spring-security.
Aktivace pružinového spouštěcího aktuátoru
Můžeme aktivovat aktuátor injektováním závislosti pružina-boot-startér-aktor v souboru pom.xml.
org.springframework.boot spring-boot-starter-actuator 2.2.2.RELEASE
Koncové body aktuátoru Spring Boot
Koncové body aktuátorů nám umožňují monitorovat naši aplikaci Spring Boot a pracovat s ní. Spring Boot obsahuje řadu vestavěných koncových bodů a můžeme také přidat vlastní koncové body v aplikaci Spring Boot.
Následující tabulka popisuje široce používané koncové body.
| Id | Používání | Výchozí |
|---|---|---|
| akční člen | Poskytuje hypermediální stránka objevování pro ostatní koncové body. Vyžaduje to, aby byl Spring HATEOAS na cestě třídy. | Skutečný |
| auditní události | Vystavuje informace o událostech auditu pro aktuální aplikaci. | Skutečný |
| autokonfigurace | Používá se k zobrazení zprávy o automatické konfiguraci zobrazující všechny kandidáty na automatickou konfiguraci a důvod, proč „byly“ nebo „nebyly“ použity. | Skutečný |
| fazole | Používá se k zobrazení kompletního seznamu všech jarních fazolí ve vaší aplikaci. | Skutečný |
| configprops | Používá se k zobrazení seřazeného seznamu všech @ConfigurationProperties. | Skutečný |
| skládka | Používá se k provedení výpisu podprocesu. | Skutečný |
| env | Používá se k vystavení vlastností z ConfigurableEnvironment společnosti Spring. | Skutečný |
| průlet | Používá se k zobrazení všech migrací databáze Flyway, které byly použity. | Skutečný |
| zdraví | Používá se k zobrazení informací o stavu aplikace. | Nepravdivé |
| info | Používá se k zobrazení informací o libovolné aplikaci. | Nepravdivé |
| dřevorubci | Slouží k zobrazení a úpravě konfigurace loggerů v aplikaci. | Skutečný |
| kapalná báze | Používá se k zobrazení všech migrací databáze Liquibase, které byly použity. | Skutečný |
| metriky | Používá se k zobrazení informací o metrikách pro aktuální aplikaci. | Skutečný |
| mapování | Používá se k zobrazení seřazeného seznamu všech cest @RequestMapping. | Skutečný |
| vypnout | Používá se k tomu, aby bylo možné aplikaci plynule vypnout. | Skutečný |
| stopa | Používá se k zobrazení informací o sledování. | Skutečný |
Pro Spring MVC se používají následující dodatečné koncové body.
| Id | Popis | Výchozí |
|---|---|---|
| dokumenty | Používá se k zobrazení dokumentace, včetně vzorových požadavků a odpovědí pro koncové body aktuátoru. | Nepravdivé |
| skládka | Používá se k vrácení GZip komprimovaného souboru výpisu haldy hprof. | Skutečný |
| jolokia | Používá se k odhalení JMX beanů přes HTTP (když je Jolokia na cestě třídy). | Skutečný |
| log soubor | Používá se k vrácení obsahu souboru protokolu. | Skutečný |
| Prometheus | Používá se k vystavení metrik ve formátu, který může být seškrábán serverem prometheus. Vyžaduje závislost na mikrometru-registru-prometheus. | Skutečný |
Vlastnosti aktuátoru Spring Boot
Spring Boot umožňuje zabezpečení všech koncových bodů pohonu. Používá založené na formuláři ověřování, které poskytuje uživatelské ID jako uživatel a náhodně generovaný Heslo . Můžeme také přistupovat ke koncovým bodům omezeným na aktuátory přizpůsobením zabezpečení základního ověření koncovým bodům. Tuto konfiguraci musíme přepsat pomocí manažerské.bezpečnostní.role vlastnictví. Například:
management.security.enabled=true management.security.roles=ADMIN security.basic.enabled=true security.user.name=admin security.user.passowrd=admin
Příklad pružinového spouštěcího aktuátoru
Pojďme pochopit koncept aktuátoru na příkladu.
Krok 1: Otevřete Spring Initializr https://start.spring.io/ a vytvořit a Maven projekt.
Krok 2: Poskytněte Skupina název. Poskytli jsme com.javatpoint.
Krok 3: Poskytněte Artefakt Id. Poskytli jsme příklad pružinového aktuátoru.
Krok 4: Přidejte následující závislosti: Spring Web, Spring Boot Starter Actuator, a Prohlížeč Spring Data Rest HAL .
Krok 5: Klikněte na generovat knoflík. Když klikneme na tlačítko Generovat, zabalí všechny specifikace související s projektem do a Sklenice soubor a stáhne jej do našeho místního systému.
Krok 6: Extrahujte soubor Jar a vložte jej do pracovního prostoru STS.
Krok 7: Importujte složku projektu.
Soubor -> Import -> Stávající projekty Maven -> Procházet -> Vyberte složku spring-boot-actuator-example -> Finish
Import nějakou dobu trvá. Po importu projektu vidíme adresář projektu v sekci průzkumník balíčků.
Krok 8: Vytvořte třídu Controller. Vytvořili jsme třídu kontroleru s názvem 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!'; } } Krok 9: Otevři aplikace.vlastnosti soubor a deaktivujte bezpečnostní funkci aktuátoru přidáním následujícího příkazu.
aplikace.vlastnosti
management.security.enabled=false
Krok 10: Spusťte SpringBootActuatorExampleApplication.java soubor.
Krok 11: Otevřete prohlížeč a vyvolejte URL http://localhost:8080/actuator. Vrátí následující stránku:
{'_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}}} Aplikace standardně běží na portu 8080. Jakmile se aktuátor spustí, můžeme vidět seznam všech koncových bodů vystavených přes HTTP.
Pojďme vyvolat zdraví koncový bod vyvoláním adresy URL http://localhost:8080/actuator/health. Označuje stav NAHORU . To znamená, že aplikace je v pořádku a běží bez přerušení.
Podobně můžeme vyvolat další koncové body, které nám pomáhají sledovat a spravovat aplikaci Spring Boot.
Stáhnout projekt
