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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

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

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

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

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

قبل البدء

تفعيل 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 على Message Processor: 

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

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

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

ما هي الخطوة التالية؟

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