Пружинен задвижващ механизъм
Пружинен задвижващ механизъм е подпроект на Spring Boot Framework. Той включва редица допълнителни функции, които ни помагат да наблюдаваме и управляваме приложението Spring Boot. Той съдържа крайните точки на задвижването (мястото, където живеят ресурсите). Можем да използваме HTTP и JMX крайни точки за управление и наблюдение на приложението Spring Boot. Ако искаме да получим готови за производство функции в приложение, трябва да използваме S pring Задвижващ механизъм за зареждане.
Характеристики на пружинния задвижващ механизъм
Има три основни характеристики на Spring Boot Actuator:
Крайна точка: Крайните точки на задвижването ни позволяват да наблюдаваме и взаимодействаме с приложението. Spring Boot предоставя редица вградени крайни точки. Можем също да създадем своя собствена крайна точка. Можем да активираме и деактивираме всяка крайна точка поотделно. Повечето от приложението изберете HTTP , където идентификаторът на крайната точка, заедно с префикса на /задвижващ механизъм, се съпоставя с URL адрес.
java char към int
Например, на /здраве крайната точка предоставя основната здравна информация на приложението. Задвижващият механизъм по подразбиране го е съпоставил към /задвижващ механизъм/здраве .
Метрика: Spring Boot Actuator предоставя размерни показатели чрез интегриране с микрометър . Микрометърът е интегриран в Spring Boot. Това е инструменталната библиотека, захранваща доставката на показатели за приложения от пролетта. Той предоставя неутрални спрямо доставчика интерфейси за таймери, измервателни уреди, броячи, разпределителни обобщения, и дълги таймери за задачи с размерен модел на данни.
Одит: Spring Boot предоставя гъвкава рамка за одит, която публикува събития в AuditEventRepository. Той автоматично публикува събитията за удостоверяване, ако се изпълнява spring-security.
Активиране на Spring Boot Actuator
Можем да активираме задвижващия механизъм чрез инжектиране на зависимостта spring-boot-starter-actuator във файла pom.xml.
org.springframework.boot spring-boot-starter-actuator 2.2.2.RELEASE
Крайни точки на пружинния задвижващ механизъм
Крайните точки на задвижването ни позволяват да наблюдаваме и взаимодействаме с нашето приложение Spring Boot. Spring Boot включва редица вградени крайни точки и можем също да добавим персонализирани крайни точки в приложението Spring Boot.
Следната таблица описва широко използваните крайни точки.
Документ за самоличност | Използване | По подразбиране |
---|---|---|
задвижващ механизъм | Той осигурява базирана на хипермедия страница за откриване за другите крайни точки. Изисква Spring HATEOAS да бъде на пътя на класа. | Вярно |
одитни събития | Той излага информация за одитни събития за текущото приложение. | Вярно |
autoconfig | Използва се за показване на отчет за автоматично конфигуриране, показващ всички кандидати за автоматично конфигуриране и причината, поради която те „са били“ или „не са били“ приложени. | Вярно |
боб | Използва се за показване на пълен списък на всички пролетни зърна във вашето приложение. | Вярно |
configprops | Използва се за показване на подреден списък на всички @ConfigurationProperties. | Вярно |
сметище | Използва се за извършване на дъмп на нишка. | Вярно |
околна среда | Използва се за излагане на свойства от ConfigurableEnvironment на Spring. | Вярно |
път за прелитане | Използва се за показване на всички миграции на бази данни на Flyway, които са били приложени. | Вярно |
здраве | Използва се за показване на информация за здравето на приложението. | Невярно |
инфо | Използва се за показване на произволна информация за приложението. | Невярно |
дървосекачи | Използва се за показване и промяна на конфигурацията на регистраторите в приложението. | Вярно |
течна основа | Използва се за показване на всички миграции на бази данни на Liquibase, които са били приложени. | Вярно |
метрика | Използва се за показване на информация за показатели за текущото приложение. | Вярно |
съпоставяния | Използва се за показване на съпоставен списък на всички пътища @RequestMapping. | Вярно |
изключвам | Използва се, за да позволи на приложението да бъде елегантно изключване. | Вярно |
следа | Използва се за показване на информация за проследяване. | Вярно |
За Spring MVC се използват следните допълнителни крайни точки.
Документ за самоличност | Описание | По подразбиране |
---|---|---|
документи | Използва се за показване на документация, включително примерни заявки и отговори за крайните точки на Actuator. | Невярно |
heapdump | Използва се за връщане на GZip компресиран hprof heap dump файл. | Вярно |
jolokia | Използва се за излагане на JMX bean-ове през HTTP (когато Jolokia е на пътя на класа). | Вярно |
лог файл | Използва се за връщане на съдържанието на лог файла. | Вярно |
прометей | Използва се за излагане на показатели във формат, който може да бъде изтрит от сървър на prometheus. Това изисква зависимост от micrometer-registry- prometheus. | Вярно |
Свойства на задвижващия механизъм Spring Boot
Spring Boot позволява сигурност за всички крайни точки на задвижването. То използва базиран на формуляр удостоверяване, което осигурява потребителски идентификатор като потребител и генериран на случаен принцип парола . Можем също така да получим достъп до крайни точки, ограничени от задвижващи механизми, като персонализираме защитата на основния достъп до крайните точки. Трябва да заменим тази конфигурация от управление.сигурност.роли Имот. Например:
management.security.enabled=true management.security.roles=ADMIN security.basic.enabled=true security.user.name=admin security.user.passowrd=admin
Пример за задвижване на пружинно зареждане
Нека разберем концепцията на задвижващия механизъм чрез пример.
Етап 1: Отворете Spring Initializr https://start.spring.io/ и създайте a Мейвън проект.
Стъпка 2: Осигурете на Група име. Осигурили сме com.javatpoint.
Стъпка 3: Осигурете на Артефакт Документ за самоличност. Предоставили сме пример за задействане на пружинно зареждане.
Стъпка 4: Добавете следните зависимости: Spring Web, Spring Boot Starter Actuator, и Spring Data Rest HAL браузър .
Стъпка 5: Кликнете върху Генерирай бутон. Когато щракнем върху бутона Генериране, той обвива всички спецификации, свързани с проекта, в a Буркан файл и го изтегля в нашата локална система.
Стъпка 6: Извлечете Jar файла и го поставете в STS работното пространство.
Стъпка 7: Импортирайте папката на проекта.
Файл -> Импортиране -> Съществуващи проекти на Maven -> Преглед -> Изберете папката spring-boot-actuator-example -> Край
швета тивари
Импортирането отнема известно време. След като импортираме проекта, можем да видим директорията на проекта в раздела за изследване на пакети.
Стъпка 8: Създайте клас контролер. Създадохме класа на контролера с името 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!'; } }
Стъпка 9: Отвори приложение.свойства файл и деактивирайте защитната функция на задвижващия механизъм, като добавите следното изявление.
приложение.свойства
management.security.enabled=false
Стъпка 10: Стартирайте SpringBootActuatorExampleApplication.java файл.
низ в int
Стъпка 11: Отворете браузъра и извикайте URL адреса http://localhost:8080/actuator. Връща следната страница:
{'_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}}}
Приложението работи на порт 8080 по подразбиране. След като задвижващият механизъм стартира, можем да видим списъка с всички крайни точки, изложени през HTTP.
Нека извикаме здраве крайна точка чрез извикване на URL http://localhost:8080/actuator/health. Означава статуса НАГОРЕ . Това означава, че приложението е здраво и работи без прекъсване.
По същия начин можем да извикаме други крайни точки, които ни помагат да наблюдаваме и управляваме приложението Spring Boot.
Изтеглете проекта