تفعيل G1GC على معالجات الرسائل

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

يوضّح هذا المستند كيفية تفعيل Garbage First Garbage Collector (G1GC) في معالِجات الرسائل في Apigee Edge.

يعمل معالج الرسائل في Apigee Edge على جهاز Java الافتراضي (JVM)، ويستخدم أداة تجميع القمامة التلقائية، سواء كانت متوازية أو متوازية بناءً على إعدادات الأجهزة ونظام التشغيل. في حالات معيّنة واستنادًا إلى احتياجاتك، قد تحتاج إلى تغيير نوع "أداة تجميع البيانات المهملة" المستخدَم في "معالج الرسائل".

G1GC هو جهاز تجميع البيانات المهملة الجيلي على نمط الخادم والإيقاف المؤقت لجهاز Java HotSpot VM، ما يحسّن الأداء العام لمعالج الرسائل. ويتم عادةً تصميم هذه التقنية للتطبيقات التي تحتوي على مجموعات بيانات متوسطة الحجم أو كبيرة الحجم، والتي يكون فيها وقت الاستجابة أكثر أهمية من إجمالي سرعة معالجة البيانات. على سبيل المثال: يمكنك استخدام G1GC إذا كان حجم كومة الذاكرة المؤقتة كبيرًا (أكبر من 3 غيغابايت).

ونقترح عادةً ضبط مَعلمة JVM أخرى UseStringDeduplicationمع G1GC. تحسِّن هذه المَعلمة استخدام ذاكرة Java لكومة الذاكرة المؤقتة من خلال جعل قيم السلسلة المكرّرة أو المتطابقة تتشارك في مصفوفة الأحرف نفسها.

قبل البدء

• إذا لم تكن معتادًا على مجموعة القمامة والأنواع المختلفة من مجمّعات القمامة في Java، يمكنك الاطّلاع على أساسيات جمع القمامة في Java.
• إذا لم تكن معتادًا على استخدام G1GC، اطّلِع على بدء استخدام أداة تجميع قمامة G1.
• إذا لم تكن على دراية بكيفية ضبط خصائص Edge على السحابة الإلكترونية الخاصة، يُرجى الاطّلاع على المقالة كيفية إعداد Edge.

تفعيل خدمة G1GC في معالِجات الرسائل

يوضِّح هذا القسم كيفية تفعيل G1GC على معالج رسائل Edge. يمكن تفعيل G1GC من خلال السمة useG1GC في مكوّن "معالج الرسائل". ويتم ضبط هذه السمة تلقائيًا على false في معالجات الرسائل. لضبط أي خاصية على معالج الرسائل، استخدِم الرمز المميّز وفقًا للبنية الموضحة في كيفية إعداد Edge.

لتفعيل G1GC في معالِجات الرسائل، نفِّذ الخطوات التالية:

1. تحديد مكان الرمز المميّز لسمة useG1GC
2. تفعيل G1GC في معالج الرسائل

تحديد الرمز المميّز للسمة useG1GC

توضّح الخطوات التالية كيفية تحديد موقع الرمز المميّز لسمة useG1GC:

1. ابحث عن السمة useG1GC في دليل مصدر معالج الرسائل /opt/apigee/edge-message-processor/source باستخدام الأمر التالي:

   grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
   

2. يعرض ناتج هذا الأمر الرمز المميّز لخاصية "معالج الرسائل" useG1GC على النحو التالي:

   /opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}
   

   تكون السلسلة بين علامات {T}{/T} هي اسم الرمز المميّز الذي يمكنك ضبطه في ملف .properties الخاص بمعالج الرسائل. وبالتالي، يكون الرمز المميّز للسمة useG1GC على النحو التالي:

   conf_system_useG1GC
   

تفعيل G1GC في معالِجات الرسائل

توضح الخطوات التالية كيفية تفعيل G1GC على معالِجات الرسائل من Apigee:

1. افتح الملف /opt/apigee/customer/application/message-processor.properties على جهاز "معالج الرسائل" في أحد أدوات التعديل. إذا لم يكن الملف موجودًا من قبل، أنشئه. مثلاً:

   vi /opt/apigee/customer/application/message-processor.properties
   

2. إضافة السطر التالي إلى هذا الملف:

   conf_system_useG1GC=true
   

3. احفظ التغييرات.
4. تأكَّد من أنّ ملف السمات هذا يملكه مستخدم apigee. مثلاً:

   chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
   

5. أعِد تشغيل معالج الرسائل باستخدام الأمر التالي:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
   

6. إذا كان لديك أكثر من معالج رسائل واحد، كرِّر هذه الخطوات على كل معالجات الرسائل.

التأكّد من إعدادات G1GC في معالجات الرسائل

يشرح هذا القسم كيفية التحقق من تعديل إعدادات G1GC بنجاح في معالجات الرسائل.

على الرغم من استخدام الرمز المميّز conf_system_useG1GC لتفعيل خدمة G1GC في معالج الرسائل، يجب التأكد من أنّه قد تم ضبط السمة useG1GC باستخدام القيمة الجديدة على النحو التالي:

1. ابحث عن السمة useG1GC في دليل /opt/apigee/edge-message-processor/conf وتأكَّد من أنّه قد تم ضبطها باستخدام القيمة الجديدة. مثلاً:

   grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
   

2. إذا تم تفعيل G1GC بنجاح في "معالج الرسائل"، سيعرِض الأمر السابق القيمة الجديدة في ملف system.properties.

   في ما يلي نموذج النتيجة من الأمر السابق بعد تفعيل G1GC في "معالج الرسائل":

   /opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
   

   في مثال الإخراج، تجدر الإشارة إلى أنّه قد تم ضبط السمة useG1GC على القيمة الجديدة true في system.properties. ويشير هذا إلى أنه تم تفعيل G1GC بنجاح في معالج الرسائل.

3. إذا كانت القيمة القديمة للسمة useG1GC لا تزال ظاهرة، تأكَّد من اتّباع جميع الخطوات الموضّحة في تفعيل G1GC في معالِجات الرسائل بشكلٍ صحيح. إذا فاتتك أي خطوة، كرِّر جميع الخطوات مرّة أخرى بشكل صحيح.
4. إذا كنت لا تزال غير قادر على تفعيل G1GC، يُرجى التواصل مع فريق دعم Apigee Edge.

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

تفعيل إزالة تكرار السلاسل في معالِجات الرسائل