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

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

المشكلة

تعذَّر نشر مراجعات الخادم الوكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم 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 = []}

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

قد ترجع هذه المشكلة إلى عدّة أسباب مختلفة. في ما يلي بعض الأمثلة على هذه الأسباب:

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

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

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

نفدت الذاكرة

التشخيص

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

  1. قد ترى استثناءً مشابهًا للاستثناء الوارد في سجلّ "معالج الرسائل" /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. حدد مقدار الذاكرة التي يمكن من خلالها زيادة مساحة كومة JavaScript:
    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 للحصول على مزيد من المساعدة.