مشغل التمهيد الربيعي
مشغل التمهيد الربيعي هو مشروع فرعي لإطار عمل Spring Boot. يتضمن عددًا من الميزات الإضافية التي تساعدنا في مراقبة تطبيق Spring Boot وإدارته. يحتوي على نقاط نهاية المحرك (المكان الذي تعيش فيه الموارد). يمكننا ان نستخدم HTTP و جمكس نقاط النهاية لإدارة ومراقبة تطبيق Spring Boot. إذا أردنا الحصول على ميزات جاهزة للإنتاج في أحد التطبيقات، فيجب علينا استخدام S مشغل التمهيد pring
ميزات مشغل التمهيد الربيعي
هناك ثلاثة الملامح الرئيسية لمشغل Spring Boot:
نقطة النهاية: تسمح لنا نقاط نهاية المشغل بمراقبة التطبيق والتفاعل معه. يوفر Spring Boot عددًا من نقاط النهاية المضمنة. يمكننا أيضًا إنشاء نقطة النهاية الخاصة بنا. يمكننا تمكين وتعطيل كل نقطة نهاية على حدة. معظم التطبيقات تختار HTTP ، حيث معرف نقطة النهاية، مع البادئة / المحرك، تم تعيينه إلى عنوان URL.
على سبيل المثال، /صحة توفر نقطة النهاية المعلومات الصحية الأساسية للتطبيق. قام المشغل بتعيينه افتراضيًا /المحرك/الصحة .
المقاييس: يوفر Spring Boot Actuator مقاييس الأبعاد من خلال التكامل مع ميكرومتر . تم دمج الميكرومتر في Spring Boot. إنها مكتبة الأجهزة التي تدعم تقديم مقاييس التطبيق من Spring. يوفر واجهات محايدة للبائعين الموقتات، أجهزة القياس، العدادات، ملخصات التوزيع، و توقيت المهام الطويلة مع نموذج بيانات الأبعاد.
مراجعة: يوفر Spring Boot إطار عمل مرنًا للتدقيق ينشر الأحداث على موقع AuditEventRepository. يقوم تلقائيًا بنشر أحداث المصادقة إذا كان أمان الربيع قيد التنفيذ.
مجاني مقابل مجاني
تمكين مشغل التمهيد الربيعي
يمكننا تمكين المحرك عن طريق حقن التبعية مشغل التمهيد الربيعي في ملف pom.xml.
org.springframework.boot spring-boot-starter-actuator 2.2.2.RELEASE
نقاط نهاية مشغل التمهيد الربيعي
تسمح لنا نقاط نهاية المشغل بمراقبة تطبيق Spring Boot الخاص بنا والتفاعل معه. يتضمن Spring Boot عددًا من نقاط النهاية المضمنة ويمكننا أيضًا إضافة نقاط نهاية مخصصة في تطبيق Spring Boot.
يصف الجدول التالي نقاط النهاية المستخدمة على نطاق واسع.
بطاقة تعريف | الاستخدام | تقصير |
---|---|---|
المحرك | وهو يوفر على أساس الوسائط التشعبية صفحة الاكتشاف لنقاط النهاية الأخرى. يتطلب وجود Spring HATEOAS في مسار الفصل. | حقيقي |
com.auditevents | يعرض معلومات أحداث التدقيق للتطبيق الحالي. | حقيقي |
التكوين التلقائي | يتم استخدامه لعرض تقرير التكوين التلقائي الذي يوضح جميع المرشحين للتكوين التلقائي وسبب تطبيقهم 'تم' أو 'لم يتم تطبيقهم'. | حقيقي |
فول | يتم استخدامه لعرض قائمة كاملة بجميع حبوب الربيع الموجودة في تطبيقك. | حقيقي |
com.configprops | يتم استخدامه لعرض قائمة مجمعة بجميع @ConfigurationProperties. | حقيقي |
أحمق | يتم استخدامه لإجراء تفريغ الخيط. | حقيقي |
بيئة | يتم استخدامه لكشف الخصائص من بيئة Spring's ConfigurableEnvironment. | حقيقي |
عن طريق الطيران | يتم استخدامه لإظهار أي عمليات ترحيل لقاعدة بيانات Flyway تم تطبيقها. | حقيقي |
صحة | يتم استخدامه لإظهار المعلومات الصحية للتطبيق. | خطأ شنيع |
معلومات | يتم استخدامه لعرض معلومات التطبيق التعسفي. | خطأ شنيع |
الحطابين | يتم استخدامه لإظهار وتعديل تكوين المسجلين في التطبيق. | حقيقي |
com.liquibase | يتم استخدامه لإظهار أي عمليات ترحيل لقاعدة بيانات Liquibase تم تطبيقها. | حقيقي |
المقاييس | يتم استخدامه لإظهار معلومات المقاييس للتطبيق الحالي. | حقيقي |
تعيينات | يتم استخدامه لعرض قائمة مجمعة بجميع مساراتRequestMapping. | حقيقي |
اغلق | يتم استخدامه للسماح بإيقاف تشغيل التطبيق بأمان. | حقيقي |
يتعقب | يتم استخدامه لعرض معلومات التتبع. | حقيقي |
بالنسبة لـ Spring MVC، يتم استخدام نقاط النهاية الإضافية التالية.
بطاقة تعريف | وصف | تقصير |
---|---|---|
مستندات | يتم استخدامه لعرض الوثائق، بما في ذلك أمثلة الطلبات والاستجابات لنقاط نهاية المشغل. | خطأ شنيع |
com.heapdump | يتم استخدامه لإرجاع ملف تفريغ كومة الذاكرة المؤقتة hprof المضغوط من GZip. | حقيقي |
jolokia | يتم استخدامه لكشف حبوب JMX عبر HTTP (عندما يكون Jolokia في مسار الفصل). | حقيقي |
ملف تسجيل | يتم استخدامه لإرجاع محتويات ملف السجل. | حقيقي |
بروميثيوس | يتم استخدامه لعرض المقاييس بتنسيق يمكن استخلاصه بواسطة خادم بروميثيوس. فإنه يتطلب الاعتماد على ميكرومتر-التسجيل-بروميثيوس. | حقيقي |
خصائص مشغل Spring Boot
يتيح Spring Boot الأمان لجميع نقاط نهاية المشغل. يستخدم على أساس النموذج المصادقة التي توفر معرف المستخدم كمستخدم وتم إنشاؤها بشكل عشوائي كلمة المرور . يمكننا أيضًا الوصول إلى نقاط النهاية المقيدة بواسطة المشغل عن طريق تخصيص أمان المصادقة الأساسية لنقاط النهاية. نحن بحاجة إلى تجاوز هذا التكوين من خلال Management.security.roles ملكية. على سبيل المثال:
management.security.enabled=true management.security.roles=ADMIN security.basic.enabled=true security.user.name=admin security.user.passowrd=admin
مثال على مشغل التمهيد الربيعي
دعونا نفهم مفهوم المحرك من خلال مثال.
الخطوة 1: فتح تهيئة الربيع https://start.spring.io/ وإنشاء أ مخضرم مشروع.
الخطوة 2: توفير مجموعة اسم. قدمنا com.javatpoint.
الخطوه 3: توفير الأداة بطاقة تعريف. لقد قدمنا مثال على مشغل التمهيد الربيعي.
الخطوة 4: أضف التبعيات التالية: Spring Web، مشغل Spring Boot Starter، و متصفح Spring Data Rest HAL .
الخطوة 5: اضغط على يولد زر. عندما نضغط على زر إنشاء، فإنه يقوم بتجميع كافة المواصفات المتعلقة بالمشروع في ملف إناء الملف وتنزيله على نظامنا المحلي.
الخطوة 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: افتح ال application.properties قم بملف وتعطيل ميزة الأمان الخاصة بالمشغل عن طريق إضافة العبارة التالية.
application.properties
management.security.enabled=false
الخطوة 10: تشغيل SpringBootActuatorExampleApplication.java ملف.
الخطوة 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.
تحميل المشروع