مشاركة عبر

إدارة ومراقبة التطبيق باستخدام Spring Boot Actuator

  • مقالة

إشعار

سيتم إهمال الخطط الأساسية والقياسية والمؤسسة بدءا من منتصف مارس 2025، مع فترة تقاعد 3 سنوات. نوصي بالانتقال إلى Azure Container Apps. لمزيد من المعلومات، راجع إعلان إيقاف Azure Spring Apps.

سيتم إهمال الاستهلاك القياسي والخطة المخصصة بدءا من 30 سبتمبر 2024، مع إيقاف التشغيل الكامل بعد ستة أشهر. نوصي بالانتقال إلى Azure Container Apps. لمزيد من المعلومات، راجع ترحيل استهلاك Azure Spring Apps القياسي وخطة مخصصة إلى Azure Container Apps.

هذه المقالة تنطبق على: ✔️ Java ❌ C#‎

تنطبق هذه المقالة على: ✔️ Basic/Standard ✔️ Enterprise

يوفر Spring Boot Actuator ميزات جاهزة للإنتاج لتطبيقاتك. يمكنك مراقبة التطبيق الخاص بك بكل جهد، وجمع المقاييس، وفهم الحالة أو نشاط قاعدة البيانات باستخدام هذه الأداة. يمكنك الوصول إلى أدوات من الدرجة المهنية دون الحاجة إلى إنشائها من البداية.

يعرض المشغل بيانات تشغيلية حيوية حول التطبيق قيد التشغيل، مثل الحالة الصحية والمقاييس والمعلومات والمزيد. يستخدم وحدة التشغيل نقاط نهاية HTTP أو ملحقات إدارة Java (JMX)، ما يسهل التفاعل معها. بعد دمجه، يوفر العديد من نقاط النهاية الافتراضية، ومثل وحدات Spring النمطية الأخرى، يكون قابلا للتكوين والتوسيع بسهولة.

تستخدم Azure Spring Apps المحرك لإثراء المقاييس من خلال JMX. ويمكنه أيضا العمل مع Application Live View في خطة Enterprise لمساعدتك في الحصول على البيانات من التطبيقات والتفاعل معها.

رسم تخطيطي يوضح تدفق البيانات باستخدام Spring Boot Actuator.

تكوين Spring Boot Actuator

تصف الأقسام التالية كيفية تكوين وحدة التشغيل.

إضافة تبعية وحدة التشغيل

لإضافة وحدة تشغيل إلى مشروع مستند إلى Maven، أضف التبعية التالية:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
</dependencies>

يعمل هذا التكوين مع أي إصدار Spring Boot لأن الإصدارات مشمولة في Spring Boot Bill of Materials (BOM).

تكوين نقطة نهاية وحدة تشغيل

بشكل افتراضي، يعرض health تطبيق Spring Boot نقطة النهاية فقط. لمراقبة التكوين والبيئة القابلة للتكوين، استخدم الخطوات التالية لتمكين env نقطتي النهاية و configprops أيضا:

  1. انتقل إلى جزء نظرة عامة على التطبيق، وحدد التكوين في قائمة الإعداد، ثم انتقل إلى صفحة تكوين متغيرات البيئة.

  2. أضف الخصائص التالية كما هي في نموذج "key:value". تفتح هذه البيئة نقاط نهاية Spring Actuator التالية: healthو envو.configprops

    management.endpoints.web.exposure.include: health,env,configprops

  3. حدد حفظ. يتم إعادة تشغيل التطبيق تلقائيا وتحميل متغيرات البيئة الجديدة.

يمكنك الآن العودة إلى جزء نظرة عامة على التطبيق والانتظار حتى تتغير حالة التزويد إلى ناجح.

لعرض جميع نقاط النهاية المضمنة والتكوينات ذات الصلة، راجع قسم تعريض نقاط النهاية في ميزات جاهزية إنتاج Spring Boot.

نقطة نهاية وحدة تشغيل آمنة

عند فتح التطبيق للجمهور، يتم عرض نقاط نهاية المحرك هذه للجمهور أيضا. نوصي بإخفاء كافة نقاط النهاية عن طريق تعيين management.endpoints.web.exposure.exclude=*، لأن الخاصية exclude لها الأسبقية على الخاصية include . يحظر هذا الإجراء طريقة العرض المباشرة للتطبيق في خطة المؤسسة والتطبيقات أو الأدوات الأخرى التي تعتمد على نقطة نهاية HTTP للمفعل.

في خطة المؤسسة، هناك طريقتان لتأمين الوصول:

  • يمكنك تعطيل نقطة النهاية العامة للتطبيقات وتكوين قاعدة توجيه في VMware Spring Cloud Gateway لتعطيل وصول المحرك من الجمهور. لمزيد من المعلومات، راجع تكوين بوابة سحابة الربيع VMware.

  • يمكنك تكوين وحدة التشغيل للاستماع إلى منفذ HTTP مختلف من التطبيق الرئيسي. في تطبيق مستقل، يتم تعيين منفذ HTTP للمفعل افتراضيا إلى نفس منفذ HTTP الرئيسي. لكي يستمع التطبيق إلى منفذ مختلف، قم بتعيين الخاصية management.server.port . يتعذر على Application Live View الكشف تلقائيا عن تغيير المنفذ هذا، لذلك تحتاج أيضا إلى تكوين الخاصية على توزيع Azure Spring Apps. بعد ذلك، لا يمكن الوصول إلى المحرك بشكل عام، ولكن يمكن ل Application Live View القراءة من نقطة نهاية المحرك عبر منفذ آخر. لمزيد من المعلومات، راجع استخدام طريقة عرض التطبيق المباشر مع خطة Azure Spring Apps Enterprise.

الخطوات التالية