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

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

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

إزالة تكرار السلاسل هي ميزة من ميزات Java تساعدك على توفير الذاكرة التي تشغلها سلسلة مكررة الكائنات في تطبيقات Java. يحد من آثار الذاكرة لكائنات السلسلة في كومة الذاكرة المؤقتة في Java عن طريق جعل قيم السلسلة المكررة أو المتطابقة تشترك في صفيف الأحرف نفسه.

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

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

قبل البدء

• إذا لم تكن معتادًا على استخدام G1GC، يمكنك الاطّلاع على بدء استخدام ميزة تجميع القمامة من G1
• إذا لم تكن معتادًا على استخدام ميزة إزالة تكرار السلاسل، فاقرأ إزالة تكرار السلاسل في أداة تجميع القمامة G1
• إذا لم تكن معتادًا على تفعيل معالِجات الرسائل G1GC on Edge، يُرجى الاطّلاع على تفعيل G1GC في معالِجات بيانات الرسائل
• إذا لم تكن على دراية بكيفية إعداد خصائص Edge على Private Cloud، يُرجى قراءة كيفية الضبط Edge:

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

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

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

1. العثور على الرمز المميّز للسمة userStringDeduplieration
2. تفعيل طريقة استخدام UseStringDeduplieration في معالِج الرسائل

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

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

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 في معالِجات معالجة الرسائل