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

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

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

"إزالة تكرار السلاسل" هي ميزة من ميزات Java تساعدك في توفير الذاكرة التي تشغلها كائنات السلسلة المكرّرة في تطبيقات Java. تقلّل هذه الميزة من مساحة الذاكرة لكائنات السلسلة في ذاكرة Java Heap من خلال جعل قيم السلسلة المكرّرة أو المتطابقة تتشارك في مصفوفة الأحرف نفسها.

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

لا يمكن استخدام ميزة "إزالة تكرار السلاسل" إلا مع أداة G1 Garbage Collector (G1GC) في تطبيقات Java. إذا أردت تفعيل هذه الميزة على "معالج الرسائل"، يجب أن يكون قد سبق تفعيل G1GC أو تفعيل كل من G1GC و"إزالة تكرار السلاسل" معًا في "معالج الرسائل".

قبل البدء

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

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

لتمكين إزالة تكرار السلاسل في معالجات الرسائل، نفذ الخطوات التالية:

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

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

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

  1. ابحث عن السمة useStringDeduplication في دليل مصدر معالج الرسائل /opt/apigee/edge-message-processor/source باستخدام الأمر التالي: 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
  2. يعرض ناتج هذا الأمر الرمز المميّز للسمة useStringDeduplication في "معالج الرسائل" على النحو التالي: 
    /opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/T}

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

    conf_system_useStringDeduplication

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

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

  1. افتح الملف /opt/apigee/customer/application/message-processor.properties على جهاز "معالج الرسائل" في أحد أدوات التعديل. إذا لم يكن الملف متوفّرًا، يجب إنشاؤه. مثلاً: 
    vi /opt/apigee/customer/application/message-processor.properties
  2. أضِف السطر التالي إلى هذا الملف: 
    conf_system_useStringDeduplication=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. إذا كان لديك أكثر من معالج رسائل واحد، كرِّر هذه الخطوات على كل معالجات الرسائل.

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

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

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

  1. ابحث عن السمة useStringDeduplication في دليل /opt/apigee/edge-message-processor/conf وتحقَّق من ضبطها باستخدام القيمة الجديدة. مثلاً: 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
  2. إذا تم تفعيل ميزة "إزالة تكرار السلسلة" في "معالج الرسائل"، سيعرِض الأمر السابق القيمة الجديدة في ملف system.properties.

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

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

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

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

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

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