استكشاف أخطاء بوابة VMware Spring Cloud وإصلاحها

إشعار

يعد Azure Spring Apps هو الاسم الجديد لخدمة Azure Spring Cloud. رغم أن الخدمة تحمل اسماً جديداً، سترى الاسم القديم في بعض الأماكن لفترة من الوقت بينما نعمل على تحديث الأصول مثل لقطات الشاشة، ومقاطع الفيديو، والرسوم التخطيطية.

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

توضح لك هذه المقالة كيفية استكشاف أخطاء Spring Cloud Gateway ل VMware Tanzu وإصلاحها باستخدام خطة Azure Spring Apps Enterprise. لمعرفة المزيد حول بوابة VMware Spring Cloud، راجع تكوين بوابة VMware Spring Cloud.

المتطلبات الأساسية

• مثيل خدمة خطة Azure Spring Apps Enterprise الذي تم توفيره بالفعل مع تمكين VMware Spring Cloud Gateway. لمزيد من المعلومات، راجع التشغيل السريع: إنشاء التطبيقات ونشرها في Azure Spring Apps باستخدام خطة المؤسسة.
• الإصدار 2.45.0 من Azure CLI أو أحدث. استخدم الأمر التالي لتثبيت ملحق Azure Spring Apps: az extension add --name spring.

التحقق من مقاييس البوابة

لمزيد من المعلومات حول كيفية التحقق من المقاييس على مدخل Microsoft Azure، راجع قسم صفحة Common metrics في Metrics for Azure Spring Apps.

لمزيد من المعلومات حول كل مقياس مدعوم، راجع قسم Gateway في Metrics for Azure Spring Apps.

التحقق من سجلات البوابة

تتكون Spring Cloud Gateway من المكونات الفرعية التالية:

• spring-cloud-gateway-operator لإدارة البوابة.
• spring-cloud-gateway يفي بالميزات.

تتوفر سجلات كلا الحوسبتين الفرعيتين. تصف الأقسام التالية كيفية التحقق من هذه السجلات.

استخدام دفق السجل في الوقت الحقيقي

يمكنك دفق السجلات في الوقت الحقيقي باستخدام Azure CLI. لمزيد من المعلومات، راجع دفق سجلات المكونات المدارة في Azure Spring Apps في الوقت الفعلي. توضح الأمثلة التالية كيف يمكنك استخدام أوامر Azure CLI لدفق سجلات جديدة باستمرار للحواسيب spring-cloud-gateway الفرعية و spring-cloud-gateway-operator .

استخدم الأمر التالي لدفق السجلات ل spring-cloud-gateway:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name spring-cloud-gateway \
    --all-instances \
    --follow

استخدم الأمر التالي لدفق السجلات ل spring-cloud-gateway-operator:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name spring-cloud-gateway-operator \
    --all-instances \
    --follow

استخدام "Log Analytics"

توضح لك الأقسام التالية كيفية عرض سجلات النظام باستخدام Log Analytics.

إعدادات التشخيص ل Log Analytics

يجب تشغيل سجلات النظام وإرسالها إلى Log Analytics قبل الاستعلام عن سجلات بوابة VMware Spring Cloud. لتمكين سجلات النظام في مدخل Microsoft Azure، استخدم الخطوات التالية:

1. افتح مثيل Azure Spring Apps.

2. في قائمة التنقل، حدد Diagnostics settings.

3. حدد إضافة إعداد تشخيص أو حدد تحرير الإعداد لإعداد موجود.

4. في قسم Logs ، حدد فئة System Logs .

5. في قسم Destination details ، حدد Send to Log Analytics workspace ثم حدد مساحة العمل الخاصة بك.

6. حدد حفظ لتحديث الإعداد.

التحقق من السجلات في Log Analytics

للتحقق من spring-cloud-gateway سجلات مدخل Microsoft Azure واستخدامها spring-cloud-gateway-operator ، استخدم الخطوات التالية:

1. تأكد من تشغيل سجلات النظام. لمزيد من المعلومات، راجع قسم إعدادات التشخيص ل Log Analytics .

2. افتح مثيل Azure Spring Apps.

3. حدد Logs في جزء التنقل ثم حدد Overview.

4. استخدم نماذج الاستعلامات التالية في جزء تحرير الاستعلام. اضبط النطاق الزمني ثم حدد تشغيل للبحث عن السجلات.

   • لعرض سجلات spring-cloud-gateway، استخدم الاستعلام التالي:

     AppPlatformSystemLogs
     | where LogType in ("SpringCloudGateway")
     | project TimeGenerated , ServiceName , LogType, Log , _ResourceId
     | limit 100
     

     

   • لعرض سجلات spring-cloud-gateway-operator، استخدم الاستعلام التالي:

     AppPlatformSystemLogs
     | where LogType in ("SpringCloudGatewayOperator")
     | project TimeGenerated , ServiceName , LogType, Log , _ResourceId
     | limit 100
     

     

إشعار

قد يكون هناك تأخير لبضع دقائق قبل أن تتوفر السجلات في Log Analytics.

ضبط مستويات السجل

يصف هذا القسم كيفية ضبط مستويات السجل ل VMware Spring Cloud Gateway ويقدم مسجلا واحدا كمثال.

هام

قبل البدء، تأكد من فهم تفاصيل وتأثيرات ضبط مستويات السجل عن طريق قراءة قسم تكوين مستويات السجل في تكوين VMware Spring Cloud Gateway.

استخدم الخطوات التالية لضبط مستويات السجل:

1. في مثيل Azure Spring Apps، حدد Spring Cloud Gateway في جزء التنقل ثم حدد Configuration.
2. في أقسام Properties ، املأ زوج logging.level.org.springframework.cloud.gateway=DEBUGالمفتاح/القيمة .
3. حدد حفظ لحفظ التغييرات الخاصة بك.
4. بعد نجاح التغيير، يمكنك العثور على سجلات أكثر تفصيلا لاستكشاف الأخطاء وإصلاحها، مثل معلومات حول كيفية توجيه الطلبات.

إعداد قواعد التنبيه

يمكنك إنشاء قواعد التنبيه استنادا إلى السجلات والمقاييس. لمزيد من المعلومات، راجع إنشاء قاعدة تنبيه قياسي أو تحريرها.

استخدم الخطوات التالية لإنشاء قواعد التنبيه مباشرة من مدخل Azure ل Azure Spring Apps:

1. افتح مثيل Azure Spring Apps.
2. انتقل إلى السجلات أو المقاييس.
3. اكتب استعلام السجل في جزء السجلات ، أو أضف مخطط مقاييس.
4. حدد قاعدة تنبيه جديدة. ينقلك هذا الإجراء إلى جزء إنشاء قاعدة تنبيه، ويتم ملء استعلام السجل أو المقاييس تلقائيا.

يمكنك الآن تكوين تفاصيل قاعدة التنبيه.

مراقبة البوابة مع مراقبة أداء التطبيق

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

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

بالنسبة لبعض الأخطاء، قد تساعد إعادة التشغيل في حل المشكلة. لمزيد من المعلومات، راجع قسم إعادة تشغيل Spring Cloud Gateway في تكوين بوابة VMware Spring Cloud.

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

• كيفية تكوين بوابة سحابة الربيع
• دفق سجلات المكونات المدارة في Azure Spring Apps في الوقت الفعلي