ضبط حجم ذاكرة الذاكرة على "معالجات الرسائل"

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

إنّ معالج الرسائل في Apigee Edge هو مكوّن مستند إلى لغة Java ويستخدم مساحة ذاكرة تلقائية كبيرة بحجم 512 ميغابايت. مع ذلك، قد لا يكون حجم الذاكرة التلقائي لكومة الذاكرة المؤقتة كافيًا لجميع حالات الاستخدام على Apigee Edge. قد تحتاج إلى ضبط حجم الذاكرة لمعالجات الرسائل بناءً على حركة البيانات ومتطلبات المعالجة أو معالجة أي مشاكل متعلقة بالذاكرة.

يتم التحكّم في حجم ذاكرة كومة الذاكرة المؤقتة لتطبيق Java من خلال معلَمتَي سطر أوامر Java -Xms (الحد الأدنى لحجم كومة الذاكرة المؤقتة) و-Xmx (الحد الأقصى لحجم كومة الذاكرة المؤقتة). في معالِجات الرسائل من Apigee Edge، يتم التحكّم في هذه المعالجات من خلال السمتَين bin_setenv_min_mem وbin_setenv_max_mem. يمكنك الاطّلاع على المزيد من المعلومات حول هذه الخصائص ضمن تعديل إعدادات ذاكرة Java.

يشرح هذا المستند كيفية ضبط حجم الذاكرة في معالجات الرسائل في Apigee Edge.

قبل البدء

تغيير حجم الذاكرة المؤقتة في معالجات الرسائل

يوضح هذا القسم كيفية تغيير حجم كومة الذاكرة المؤقتة في معالجات الرسائل. يمكن ضبط الحد الأدنى والأقصى لذاكرة التخزين المؤقت من خلال السمتَين bin_setenv_min_mem وbin_setenv_max_mem في مكوّن "معالج الرسائل".

لتغيير حجم الذاكرة في "معالجات الرسائل"، يمكنك اتّباع الخطوات التالية:

  1. افتح الملف /opt/apigee/customer/application/message-processor.properties على جهاز "معالج الرسائل" في أحد أدوات التعديل. إذا لم يكن الملف متوفّرًا، يجب إنشاؤه. مثلاً:
    vi /opt/apigee/customer/application/message-processor.properties
    
  2. أضف الأسطر التالية إلى هذا الملف:
    bin_setenv_min_mem=minimum_heap_in_megabytes
    bin_setenv_max_mem=maximum_heap_in_megabytes
    

    على سبيل المثال، إذا أردت تغيير الحد الأدنى والأقصى لكومة الذاكرة المؤقتة في معالج الرسائل إلى 1 غيغابايت و2 غيغابايت على التوالي، أضِف الأسطر التالية إلى هذا الملف:

    bin_setenv_min_mem=1024m
    bin_setenv_max_mem=2048m
    
  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. إذا كان لديك أكثر من معالج رسائل واحد، كرِّر هذه الخطوات على كل معالجات الرسائل.

التحقق من حجم الذاكرة المؤقتة في معالجات الرسائل

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

على الرغم من أنك استخدمت الخاصيتين bin_setenv_min_mem وbin_setenv_max_mem لتغيير حجم الذاكرة المؤقتة في "معالج الرسائل"، يجب التحقق من ضبط معلَمتي سطر أوامر Java الفعلية -Xms و-Xmx باستخدام القيم الجديدة على النحو التالي:

  1. ابحث لمعرفة ما إذا تم ضبط معلَمتَي سطر الأوامر -Xms و-Xmx بالقيم الجديدة لمعالج الرسائل باستخدام الأمر التالي:
    ps -ef | grep message-processor | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
    
  2. إذا تم تغيير الحد الأدنى والحد الأقصى لذاكرة الذاكرة المؤقتة في "معالج الرسائل"، سيعرِض الأمر السابق القيمة الجديدة المدرَجة في -Xms و-Xmx.

    في ما يلي نموذج النتيجة من الأمر السابق بعد تغيير الحدّ الأدنى والحد الأقصى لكومة الذاكرة المؤقتة في "معالج الرسائل":

    Xms1024m
    Xmx2048m
    

    في مثال الإخراج، نشير إلى أنّه تم ضبط القيم الجديدة الخاصة بالحد الأدنى والحد الأقصى لكومة الذاكرة المؤقتة.

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

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