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

أنت تعرض مستندات 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 = []}

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

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

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

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

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

نفدت الذاكرة

التشخيص

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

  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 Support.

قم بزيادة الحد الأقصى لمساحة 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 Support.

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

الدقة

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

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