تفعيل 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 في دليل ملفات المصدر الخاص بـ "معالج الرسائل" (Message Processor) /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 على Message Processor، عليك التأكّد من أنّه تم ضبط السمة الفعلية 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.

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

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