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

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

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

‫String Deduplication هي إحدى ميزات Java التي تساعدك في حفظ الذاكرة التي تشغلها عناصر String المكرّرة في تطبيقات Java. يقلّل ذلك من استهلاك الذاكرة لعناصر السلسلة في ذاكرة كومة Java من خلال جعل قيم السلسلة المكرّرة أو المتطابقة تشترك في مصفوفة الأحرف نفسها.

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

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

قبل البدء

• إذا لم تكن على دراية بـ G1GC، يُرجى قراءة بدء استخدام أداة جمع البيانات غير المرغوب فيها G1
• إذا لم تكن على دراية بميزة "إزالة تكرار السلاسل"، يمكنك الاطّلاع على إزالة تكرار السلاسل في أداة جمع البيانات غير المرغوب فيها G1.
• إذا لم تكن على دراية بكيفية تفعيل G1GC على "معالجات الرسائل" الطرفية، يُرجى الاطّلاع على تفعيل G1GC على "معالجات الرسائل".
• إذا لم تكن على دراية بكيفية ضبط إعدادات المواقع في Edge على Private Cloud، يمكنك الاطّلاع على مقالة كيفية ضبط إعدادات Edge.

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

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

لتفعيل ميزة "إزالة التكرار في السلاسل" في "معالجات الرسائل"، اتّبِع الخطوات التالية:

1. تحديد موقع الرمز المميّز للخاصية useStringDeduplication
2. تفعيل useStringDeduplication في "معالج الرسائل"

تحديد موقع الرمز المميّز للخاصية useStringDeduplication

توضّح الخطوات التالية كيفية العثور على الرمز المميّز لاستخدامه مع useStringDeduplication:

1. ابحث عن السمة useStringDeduplication في دليل مصدر Message Processor /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 على معالِجات الرسائل