حدث خطأ أثناء معالجة التحديثات.

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

المشكلة

يتعذّر نشر مراجعات لخادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو طلبات البيانات من واجهة برمجة التطبيقات لإدارة Edge مع ظهور الخطأ "Unexpected error occurred while processing the updates".

رسائل الخطأ

Error in deployment for environment sit.

The revision is deployed and traffic can flow, but flow may be impared. com.apigee.kernel.exceptions.spi.UncheckedException{ code = messaging.runtime.UpdateFailed, message = Unexpected error occurred while processing the updates, associated contexts = []}

الأسباب المحتملة

يمكن أن يكون لهذا الخطأ أسباب مختلفة. في ما يلي بعض الأسباب النموذجية:

الخطوات الشائعة التي يمكنك تجربتها أولاً

1. تحقَّق مما إذا كانت هناك أي أخطاء في عملية النشر أو تتبُّع تسلسل استدعاء الدوال البرمجية في سجلّ Message Processor /opt/apigee/var/log/apigee/edge-message-processor/logs/system.log
2. يظهر عادةً تتبُّع تسلسل استدعاء الدوال البرمجية يقدّم معلومات عن سبب حدوث خطأ في النشر. يُرجى قراءة تتبُّع تسلسل استدعاء الدوال البرمجية بدقة لفهم السبب.

نفاد الذاكرة

التشخيص

ملاحظة: لا يمكن لمستخدمي Edge Private Cloud تنفيذ الخطوات التالية. إذا كنت تستخدم Edge Public Cloud، يُرجى التواصل مع فريق دعم Apigee.

1. قد يظهر لك استثناء مشابه للاستثناء الوارد في سجلّ Message Processor /opt/apigee/var/log/apigee/edge-message-processor/logs/system.log كما هو موضّح في الشكل أدناه:

   Apigee-Main-4 ERROR BOOTSTRAP - RuntimeConfigurationServiceImpl.dispatchToListeners() : RuntimeConfigurationServiceImpl.dispatchToListeners : Error occurred while dispatching the request DeployEvent{organization=‘myorg', application='person-credentials-api', applicationRevision='275', deploymentSpec=basepath=/;env=dev;, deploymentID=null} to com.apigee.application.bootstrap.listeners.MessageProcessorBootstrapListener@5db88cb8
   com.apigee.kernel.exceptions.spi.UncheckedException: Unexpected error occurred while processing the updates
           at com.apigee.entities.AbstractConfigurator.throwUncheckedException(AbstractConfigurator.java:280) ~[config-entities-1.0.0.jar:na]
           at com.apigee.messaging.configuration.MessageProcessorServiceImpl.configure(MessageProcessorServiceImpl.java:665) ~[message-processor-1.0.0.jar:na]
           at com.apigee.application.bootstrap.listeners.MessageProcessorBootstrapListener.configureMessageProcessorService(MessageProcessorBootstrapListener.java:54) ~[application-bootstrap-1.0.0.jar:na]
           at com.apigee.application.bootstrap.listeners.MessageProcessorBootstrapListener.deploy(MessageProcessorBootstrapListener.java:29) ~[application-bootstrap-1.0.0.jar:na]
           …<snipped>
           at com.apigee.application.bootstrap.proto.RuntimeConfig_ConfigRPCService_BlockingSkeleton$1.run(RuntimeConfig_ConfigRPCService_BlockingSkeleton.java:38) [application-bootstrap-1.0.0.jar:na]
           at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:471) [na:1.7.0_75]
           at java.util.concurrent.FutureTask.run(FutureTask.java:262) [na:1.7.0_75]
           at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145) [na:1.7.0_75]
           at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615) [na:1.7.0_75]
           at java.lang.Thread.run(Thread.java:745) [na:1.7.0_75]
   Caused by: java.lang.OutOfMemoryError: Java heap space

2. تشير الرسالة Caused by: java.lang.OutofMemoryError: Java Heap space إلى أنّ "معالج الرسائل" قد نفد من مساحة الذاكرة المخصّصة لـ Java.

الدقة

ملاحظة: لا يمكن لمستخدمي Edge Private Cloud تنفيذ الخطوات التالية. إذا كنت تستخدم Edge Public Cloud، يُرجى التواصل مع فريق دعم Apigee.

زيادة الحد الأقصى لمساحة Java Heap على "معالجات الرسائل"

يتم التحكّم في الحد الأقصى لمساحة Java Heap من خلال خاصية JVM -Xmx. في ما يلي الخطوات اللازمة لزيادة مساحة Java Heap على معالِجات الرسائل:

1. حدِّد مقدار الذاكرة التي يمكن زيادة مساحة كومة الذاكرة المؤقتة في Java بها:
   1. تحقَّق من القيمة الحالية المضبوطة لمساحة الذاكرة القصوى المخصّصة للكومة، max_mem، في الملف /opt/apigee/edge-message-processor/bin/setenv.sh
   2. احصل على MemTotal (إجمالي مقدار ذاكرة الوصول العشوائي القابلة للاستخدام) وMemFree (مقدار ذاكرة الوصول العشوائي الفعلية غير المستخدَمة في النظام) باستخدام الأمر /proc/meminfo على النظام.
      1. يُرجى التأكّد من أنّ المعلومات المذكورة أعلاه تتضمّن الذاكرة التي تستهلكها أي عمليات أخرى، مثل Edge Router وما إلى ذلك، والموجودة على النظام نفسه.
      2. استنادًا إلى المعلومات الواردة أعلاه، حدِّد مقدار الزيادة في مساحة الذاكرة المؤقتة لـ Java التي يمكن إجراؤها في "معالج الرسائل".
      3. على سبيل المثال، إذا كان الحد الأقصى الحالي لمساحة الذاكرة المؤقتة في "معالج الرسائل" هو 1024 ميغابايت، وكان إجمالي الذاكرة (MemTotal) هو 8 غيغابايت (8192 ميغابايت)، والذاكرة الحرة (MemFree) هي 5 غيغابايت (5120 ميغابايت)، يمكنك زيادة الحد الأقصى لمساحة الذاكرة المؤقتة في Java إلى 3 غيغابايت (3072 ميغابايت).
      4. إذا كنت بحاجة إلى مساعدة في تحديد مقدار زيادة مساحة الذاكرة المخصّصة في Java، يُرجى التواصل مع فريق الدعم في Apigee.
2. أنشئ الملف التالي إذا لم يكن موجودًا من قبل:

   /opt/apigee/customer/application/message-processor.properties

3. أضِف السطر التالي في الملف، مع إعداد الذاكرة المخصّصة المتزايدة (على سبيل المثال، 3072M):

   bin_setenv_max_mem=3072m

4. احفظ الملف.
5. أعِد تشغيل "معالج الرسائل":

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

6. إذا كان لديك أكثر من "معالج رسائل" واحد، كرِّر الخطوات من 3 إلى 6 على جميع "معالجات الرسائل".

في حال استمرار المشكلة، يُرجى التواصل مع فريق الدعم في Apigee..

حدث خطأ في حزمة خادم وكيل لواجهة برمجة التطبيقات

إذا حدثت أي أخطاء في أي من السياسات المستخدَمة في خادم وكيل واجهة برمجة التطبيقات، سيتعذّر النشر مع ظهور الخطأ "Unexpected error occurred while processing the updates".

على سبيل المثال، يمكنك الاطّلاع على هذا المنشور في "المنتدى".

التشخيص

ملاحظة: لا يمكن لمستخدمي Edge Private Cloud تنفيذ الخطوات التالية. إذا كنت تستخدم Edge Public Cloud، يُرجى التواصل مع فريق دعم Apigee.

1. راجِع سجلّات "معالج الرسائل" بحثًا عن استثناءات أو أخطاء متعلّقة بنشر خادم وكيل لواجهة برمجة التطبيقات. يجب أن يقدّم لك الخطأ معلومات حول ما يجب تغييره في حزمة خادم وكيل واجهة برمجة التطبيقات لحلّ المشكلة.
2. إذا لم تظهر أي رسائل خطأ في سجلّات "معالج الرسائل"، تحقَّق من الاختلافات في سجلّ مراجعة خادم وكيل واجهة برمجة التطبيقات. إذا تم نشر المراجعات القديمة بدون أي مشكلة، راجِع التغييرات التي تم إجراؤها على الرمز.

الدقة

1. أجرِ التغييرات اللازمة في حزمة خادم وكيل واجهة برمجة التطبيقات لحلّ المشكلة.
2. عليك التراجع عن أي تغييرات في الرمز البرمجي لخادم وكيل واجهة برمجة التطبيقات التي تسبّبت في حدوث مشاكل في عملية النشر.

إذا استمرّت المشكلة، يُرجى التواصل مع فريق دعم Apigee للحصول على مزيد من المساعدة.