تعذَّر إنشاء جلسة تتبُّع.

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

المشكلة

يتعذّر على المستخدم إنشاء جلسة تتبُّع في واجهة مستخدم Edge.

رسالة الخطأ

ستحصل على رسالة خطأ في واجهة مستخدم Edge كما هو موضح أدناه:

Error creating trace session for API proxy <api proxy name>, revision <revision number>, environment <environment name>.
Failed to create DebugSession <session number> 

في ما يلي لقطة شاشة لنموذج رسالة خطأ تمت ملاحظتها في واجهة مستخدم Edge:

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

في ما يلي بعض الأسباب المحتملة لهذا الخطأ:

خطوات التشخيص الشائعة

1. تنفيذ واجهة برمجة تطبيقات الإدارة هذه:

   curl -v <management-server-host>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/apis/<apiproxy-name>/revisions/<revision-number>/debugsessions -u <user>
   

2. إذا ظهرت لك أي أخطاء، يُرجى ذكرها. انتقِل إلى مشكلة في الاتصال بالشبكة.

3. إذا حصلت على استجابة ناجحة، يعني ذلك أنه يمكن إنشاء جلسة التتبُّع عبر Management API. ومع ذلك، قد تكون هناك مشكلة مُحتمَلة في واجهة مستخدم Edge، وبالتالي لا يمكن إنشاء جلسة تتبُّع في واجهة المستخدم. انتقِل إلى مشكلة في واجهة مستخدم Edge.

السبب: مشكلة في الاتصال بالشبكة

التشخيص

1. راجِع سجلّ "خادم الإدارة" /opt/apigee/var/log/edge-management-server/logs/system.log وتحقَّق مما إذا كانت هناك أي أخطاء أثناء إنشاء جلسة التتبُّع/تصحيح الأخطاء.

   نموذج خطأ من سجلّ خادم الإدارة

   2018-02-08 09:08:21,310 org:myorg env:uat  qtp1073741635-1074 ERROR DISTRIBUTION - DebugSessionAPI.createDebugSession() : createDebugSession : Unable to connect to the server with UUID cedeabd2-e4d1-40bb-8f18-d6afc8835e5b
   org.apache.http.conn.HttpHostConnectException: Connect to 10.84.75.92:8082 [/10.84.75.92] failed: Connection refused
       at org.apache.http.impl.conn.HttpClientConnectionOperator.connect(HttpClientConnectionOperator.java:140) ~[httpclient-4.3.5.jar:4.3.5]
       at org.apache.http.impl.conn.PoolingHttpClientConnectionManager.connect(PoolingHttpClientConnectionManager.java:318) ~[httpclient-4.3.5.jar:4.3.5]
       at org.apache.http.impl.execchain.MainClientExec.establishRoute(MainClientExec.java:363) ~[httpclient-4.3.5.jar:4.3.5]
   ...<snipped>
   Caused by: java.net.ConnectException: Connection refused
       at java.net.PlainSocketImpl.socketConnect(Native Method) ~[na:1.8.0_65]
       at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350) ~[na:1.8.0_65]
   ...<snipped>
   

2. يوضح نموذج الخطأ أعلاه أننا نتلقّى رسائل خطأ "تم رفض الاتصال" عندما يحاول خادم الإدارة الاتصال بمعالج الرسائل على المنفذ رقم 8082. وبالتالي، يتعذَّر على "خادم الإدارة" إنشاء جلسة التتبُّع.

3. إذا لم تظهر لك أي أخطاء مرتبطة بالاتصال بالشبكة أو خطأ مشابه للخطأ الموضح في المثال أعلاه، انتقِل إلى بيئة لم يتم تحميلها على "معالج الرسائل".

4. إذا لاحظت أخطاءً متعلقة بالاتصال بالشبكة أو خطأً مشابهًا للخطأ كما هو موضح في المثال أعلاه، اتّبع الخطوات التالية.

5. اختبر الاتصال من خادم الإدارة إلى معالج الرسائل على المنفذ 8082 باستخدام الخطوات التالية:

   1. إذا كانت شبكة telnet متاحة، فاستخدم telnet:

      telnet <MessageProcessor_IP> 8082
      

   2. إذا لم تكن شبكة telnet متاحة، فاستخدم netcat للتحقق من الاتصال على النحو التالي:

      nc -vz <MessageProcessor_IP> 8082
      

   3. إذا ظهر لك الردّ "تم رفض الاتصال" أو "انتهت مهلة الاتصال"، ثم انتقِل إلى الخطوة التالية.

6. سجِّل الدخول إلى كل معالج من معالِجات الرسائل باستخدام عنوان IP المناسب الذي أظهر الخطأ، ثمّ نفِّذ الخطوات التالية:

   1. تحقق مما إذا كان معالج الرسائل يستمع عبر المنفذ 8082:

      netstat -an | grep LISTEN | grep 8082
      

   2. إذا كان معالج الرسائل يستمع عبر المنفذ 8082، انتقِل إلى الخطوة رقم 7.

   3. إذا كان معالج الرسائل لا يستمع عبر المنفذ 8082، فأعد تشغيل معالج الرسائل باستخدام هذا الأمر:

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

   4. انتظر حتى يبدأ معالج الرسائل في استخدام هذا الأمر:

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

   5. بعد تشغيل معالج الرسائل، أعد التحقق مما إذا كان معالج الرسائل يستمع إلى المنفذ 8082.

   6. إذا كان معالج الرسائل يستمع على المنفذ 8082، انتقِل إلى الخطوة رقم 7.

7. تحقَّق مما إذا كان بإمكانك الآن بدء جلسة التتبُّع في واجهة المستخدم. إذا لم تعُد المشكلة ملحوظة، يمكنك تخطي الخطوات التالية.

8. إذا كان معالج الرسائل قيد التشغيل ويستمع عبر المنفذ 8082، ولكن لا تزال غير قادر على الاتصال من الخوادم الأخرى مثل خادم الإدارة، فمن المحتمل أن يكون هناك جدار حماية يحظر الاتصالات الخارجية.

9. استخدم الأمر المناسب للتحقق من قواعد جدار الحماية. على سبيل المثال، يمكنك تنفيذ الأمر iptables لإدراج جميع قواعد جدار الحماية المحدّدة على نظامك:

   iptables -L -n
   

10. في حال عدم ضبط قواعد جدار حماية للمنفذ 8082، انتقِل إلى مشكلة استخدام الموارد العالية.

11. في حال إعداد أي قواعد جدار حماية على المنفذ 8082، انتقِل إلى قسم "الدقة" أدناه.

الحلّ

1. يمكنك التعاون مع مشرف الشبكة للسماح بحركة مرور البيانات الواردة والصادرة على المنفذ 8082 من الخوادم الخارجية.

في حال استمرار المشكلة، انتقِل إلى ضرورة جمع معلومات التشخيص.

السبب: لم يتم تحميل البيئة في معالج الرسائل

التشخيص

1. تحقَّق من سجلّات "خادم الإدارة" /opt/apigee/var/log/edge-management-server/logs/system.log وتحقَّق مما إذا كانت هناك أي أخطاء أثناء إنشاء جلسة التتبُّع/تصحيح الأخطاء.

2. قد تظهر رسالة الخطأ "ما مِن ردود صالحة من مشرفي المواقع". أثناء إنشاء جلسة التتبع/تصحيح الأخطاء كما هو موضح أدناه:

   2018-01-30 08:28:09,721 org:mynonprod env:uat  qtp2007599722-712162 ERROR DISTRIBUTION - DebugSessionAPI.createDebugSession() : no valid responses from MP(s), throwing error
   2018-01-30 08:28:09,723 org:mynonprod env:uat  qtp2007599722-712162 ERROR REST - CustomJAXRSInvoker.performInvocation() : CustomJAXRSInvoker.performInvocation : Method com.apigee.distribution.DebugSessionAPI.createDebugSession threw an exception.
   2018-01-30 08:28:09,724 org:mynonprod env:uat  qtp2007599722-712162 ERROR REST - ExceptionMapper.toResponse() : Error occurred : Failed to create DebugSession 1517297564678
   2018-01-30 08:28:09,724 org:mynonprod env:uat  qtp2007599722-712162 ERROR REST - ExceptionMapper.toResponse() : Returning error response : ErrorResponse{errorCode = distribution.CreateDebugSessionFailed, errorMessage = Failed to create DebugSession 1517297564678}
   

   يشير هذا الخطأ إلى أن معالج(معالجات) الرسائل لا يستجيب مرة أخرى لخادم الإدارة لسبب ما.

3. إذا لم يظهر لك خطأ مشابه للخطأ المعروض في المثال أعلاه، انتقِل إلى إدخالات معالج الرسائل القديمة.

4. إذا لاحظت خطأً مشابهًا للخطأ الموضح في المثال أعلاه، يُرجى اتّباع الخطوات التالية.

5. أحد الأسباب الأكثر احتمالاً لهذا الخطأ هو أنّه لم يتم تحميل البيئة التي تحاول إنشاء جلسة التتبُّع فيها على "معالجات الرسائل".

6. سجّل الدخول إلى كل معالج من معالجات الرسائل وتحقق مما إذا تم تحميل البيئة المحددة التي تحاول إنشاء جلسة التتبع فيها على معالج الرسائل باستخدام الأمر أدناه:

   curl -s http://localhost:8082/v1/runtime/organizations/<org-name>/environments
   

   مثال على الناتج:

   ستظهر لك قائمة بالبيئات التي تنتمي إلى المؤسسة المحددة والتي تم تحميلها على "معالج الرسائل" في إخراج الأمر أعلاه. على سبيل المثال، إذا تم تحميل البيئتين preprod وtest على معالج الرسائل، فسترى الناتج على النحو التالي:

   [ "preprod", "test" ]

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

8. إذا كانت البيئة المحدّدة، مثل "dev"، غير مدرَجة كجزء من الأمر أعلاه، تحقَّق من /opt/apigee/var/log/edge-message-processor/logs/system.log و/opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log في "معالجات الرسائل" بحثًا عن أي أخطاء أثناء تحميل البيئات.

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

الدقة

قد لا يتم تحميل البيئة على معالج الرسائل لأسباب عديدة. يوضح هذا القسم سببين محتملين قد يؤديان إلى هذه المشكلة، كما يشرح كيفية حل هذه المشكلة.

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

   الخطأ رقم 1: java.security.KeyStoreException: لا يمكن استبدال الشهادة الخاصة

   2018-01-30 12:04:38,248 pool-47-thread-4 ERROR MESSAGING.RUNTIME - AbstractConfigurator.propagateEvent() : Error while handling the update for the Configurator 
   com.apigee.kernel.exceptions.spi.UncheckedException: Failed to add certificate : mycert in key store : mytruststore in environment : test
   at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:156) ~[config-entities-1.0.0.jar:na] 
   at com.apigee.entities.configurators.KeyStore.handleUpdate(KeyStore.java:101) ~[config-entities-1.0.0.jar:na] 
   at com.apigee.entities.AbstractConfigurator.propagateEvent(AbstractConfigurator.java:85) ~[config-entities-1.0.0.jar:na] 
   at com.apigee.messaging.runtime.Environment.handleUpdate(Environment.java:238) [message-processor-1.0.0.jar:na] 
   … 
   Caused by: java.security.KeyStoreException: Cannot overwrite own certificate 
   at com.sun.crypto.provider.JceKeyStore.engineSetCertificateEntry(JceKeyStore.java:355) ~[sunjce_provider.jar:1.8.0_151] 
   at java.security.KeyStore.setCertificateEntry(KeyStore.java:1201) ~[na:1.8.0_151] 
   at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:153) ~[config-entities-1.0.0.jar:na]
   ... 20 common frames omitted
   2018-01-30 12:04:38,250 pool-47-thread-4 ERROR MESSAGING.RUNTIME - AbstractConfigurator.rollbackTransaction() : Error in processing the changes : Unknown resource type cert
   

   الخطأ رقم 2: java.security.KeyStoreException: لا يمكن استبدال المفتاح السري

   2017-11-01 03:28:47,560 pool-21-thread-7 ERROR MESSAGING.RUNTIME - AbstractConfigurator.propagateEvent() : Error while handling the update for the Configurator 
   com.apigee.kernel.exceptions.spi.UncheckedException: Failed to add certificate : mstore in key store : myTruststore in environment : dev 
   at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:156) ~[config-entities-1.0.0.jar:na] 
   at com.apigee.entities.configurators.KeyStore.handleUpdate(KeyStore.java:101) ~[config-entities-1.0.0.jar:na] 
   ... 
   Caused by: java.security.KeyStoreException: Cannot overwrite secret key 
   at com.sun.crypto.provider.JceKeyStore.engineSetCertificateEntry(JceKeyStore.java:354) ~[sunjce_provider.jar:1.8.0_144] 
   at java.security.KeyStore.setCertificateEntry(KeyStore.java:1201) ~[na:1.8.0_144] 
   at com.apigee.entities.configurators.KeyStore.setCertificateEntry(KeyStore.java:153) ~[config-entities-1.0.0.jar:na] 
   ... 20 common frames omitted 
   
   2017-11-01 03:28:47,562 pool-21-thread-7 ERROR MESSAGING.RUNTIME - AbstractConfigurator.rollbackTransaction() : Error in processing the changes : Unknown resource type cert 
   

2. يمكنك الحصول على تفاصيل ملف تخزين المفاتيح/المستودع الموثوق به المحدّد في رسالة الخطأ المعروضة في الخطوة السابقة باستخدام طلب البيانات التالي من واجهة برمجة التطبيقات للإدارة:

   curl -v "http://<management-IPaddress>:8080/v1/organizations/<org-name>/environments/<env-name>/keystores/myTruststore" -u <user>
   

   مثال على الناتج:

   { 
   "certs": [ 
   "mycert", 
   "mycert-new" 
   ], 
   "keys": [ 
   "mycert" 
   ], 
   "name": "myTruststore" 
   }
   

3. يوضِّح مثال الناتج أنّ هناك شهادتَين ومفتاح في Truststore myTruststore. لا تحتوي Truststore بشكل عام على مفتاح. إذا كان الأمر كذلك، فمن الأفضل أن يكون لديك شهادة واحدة ومفتاح واحد.

4. يمكنك الحصول على تفاصيل حول الشهادتَين باستخدام واجهة برمجة التطبيقات التالية:

   curl -s http://<management-IPaddress>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/keystores/<keystore-name>/certs/<cert-name>
   

5. تحقَّق من تاريخ انتهاء صلاحية كل شهادة من الشهادات وحدِّد الشهادة منتهية الصلاحية/القديمة.

6. احذف الشهادة المنتهية الصلاحية أو غير المرغوب فيها من Truststore "myTruststore".

في حال استمرار المشكلة أو ظهور أي خطأ غير الأخطاء المذكورة في الخطوة 1 أعلاه، انتقِل إلى المقالة يجب جمع معلومات التشخيص.

السبب: إدخالات قديمة في معالج الرسائل أو تعذّر الوصول إلى معالِجات الرسائل

التشخيص

1. إذا استغرقت واجهة مستخدم Edge وقتًا طويلاً وفشلت في إنشاء جلسة التتبع، إليك بعض الأسباب المحتملة:
   1. ربما يشير خادم الإدارة إلى معالجات رسائل غير موجودة (قديمة)
   2. تم إيقاف معالج(معالجي) الرسائل أو تعذر الوصول إليه
   3. ازداد استخدام معالِجات الرسائل للذاكرة/وحدة المعالجة المركزية (CPU)
2. تحقَّق من سجلّات "خادم الإدارة" /opt/apigee/var/log/edge-management-server/logs/system.log وتحقَّق مما إذا كانت هناك أي أخطاء أثناء إنشاء جلسة التتبُّع/تصحيح الأخطاء.

3. قد تظهر لك رسالة خطأ مثل "server <UUID> إما يتعذّر الوصول إليها أو لا يمكن الوصول إليها" أثناء إنشاء جلسة التتبع/تصحيح الأخطاء كما هو موضّح أدناه:

   2017-12-27 07:42:38,975 org:cocacola env:prod qtp2007599722-222063 INFO DISTRIBUTION - DebugSessionAPI.createDebugSession() : server 458b5910-2646-441c-a6e2-428b6d84e021 is either not up or reachable, skipping the server
   

   قد يأتي ذلك بعد رسالة خطأ أخرى "انتهت مهلة الاتصال". بعد فترة وجيزة كما هو موضح أدناه:

   2017-12-27 07:44:46.000 UTC org:cocacola env:prod qtp2007599722-222063 ERROR DISTRIBUTION - DebugSessionAPI.createDebugSession() : createDebugSession : Unable to connect to the server with UUID {}, skipping it458b5910-2646-441c-a6e2-428b6d84e021 org.apache.http.conn.HttpHostConnectException: Connect to 192.168.101.7:8080 [/192.168.101.7] failed: Connection timed out (Connection timed out) at org.apache.http.impl.conn.HttpClientConnectionOperator.connect(HttpClientConnectionOperator.java:140) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.conn.PoolingHttpClientConnectionManager.connect(PoolingHttpClientConnectionManager.java:318) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.execchain.MainClientExec.establishRoute(MainClientExec.java:363) ~[httpclient-4.3.5.jar:4.3.5] at org.apache.http.impl.execchain.MainClientExec.execute(MainClientExec.java:219) ~[httpclient-4.3.5.jar:4.3.5] 
   …<snipped>
   Caused by: java.net.ConnectException: Connection timed out (Connection timed out) at java.net.PlainSocketImpl.socketConnect(Native Method) ~[na:1.8.0_144] at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350) ~[na:1.8.0_144]
   …<snipped>
   

4. يمكن أن يحدث هذان الخطأان إما بسبب معالج(معالجات) رسائل معينين:

   1. قديمة (لم تعد موجودة)
   2. الانهيار/عدم القدرة على الوصول إليه لسبب ما

5. يُرجى اتباع الحل المناسب وفقًا للسيناريو الذي واجهك.

الدقة

السيناريو 1 : معالِجات الرسائل قديمة (غير متوفرة)

1. احصل على قائمة بمعالجي الرسائل باستخدام واجهة برمجة تطبيقات الإدارة أدناه:

   curl -u <sysadmin> "http://<management-server-host>:8080/v1/servers?pod=<podName>&regions=<regionName>"
   

2. دوِّن عنوان IP أو اسم المضيف الذي يتوافق مع أرقام التعريف الفريدة العالمية (UUID) لمعالجات الرسائل المذكورة في رسالة الخطأ في سجلات "خادم الإدارة" (الخطوة رقم 3 في التشخيص أعلاه). تحقَّق مما إذا كانت هذه الجهات صالحة لمعالجة الرسائل باستخدام إحدى الطرق التالية:

   1. أحدث مخطّط بياني لإعداد طوبولوجيا السحابة الإلكترونية الخاصة
   2. أحدث عنوان IP لخادم Edge - جدول ربط اسم المضيف

   إذا وجدت أنها معالِجات رسائل صالحة، انتقل إلى السيناريو 2 : لا يمكن الوصول إلى معالِجات الرسائل.

3. احذف معالِجات الرسائل القديمة (غير الموجودة) باستخدام واجهات برمجة التطبيقات للإدارة أدناه:

   1. إلغاء تسجيل معالج الرسائل من بيئات المؤسسة:

      curl -X POST http://<management-server-host>:8080/v1/o/<orgName>/e/<envName>/servers -d "uuid={uuid}&region=<regionName>&pod=<podName}&action=remove" 
      

   2. إلغاء تسجيل نوع الخادم:

      curl http://<management-server-host>:8080/v1/servers -X POST -d "type={message-processor}&region=<regionName>&pod=<podName>&uuid=<uuid>&action=remove"
      

   3. احذف الخادم:

      curl http://<management-ip>:8080/v1/servers/<uuid> -X DELETE
      

4. كرِّر الخطوة رقم 3 إذا كانت لديك المشكلة نفسها في أي بيئات أخرى في مؤسستك.

السيناريو 2: تعذر الوصول إلى معالجات الرسائل

1. سجِّل الدخول إلى كل معالج من معالجي الرسائل من خلال تحديد عناوين IP/أسماء المضيف استنادًا إلى أرقام التعريف الفريدة العالمية(UUID) التي تمت ملاحظتها في رسالة الخطأ في سجلات "خادم الإدارة".

2. إعادة تشغيل معالج الرسائل:

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

أعِد التحقّق مما إذا كنت قادرًا على إنشاء جلسة التتبُّع. في حال استمرار المشكلة، انتقِل إلى المقالة يجب جمع معلومات التشخيص.

السبب: مشكلة في استخدام الموارد الكبيرة

التشخيص

1. سجِّل الدخول إلى كل معالج من معالجات الرسائل وتحقق مما إذا كان هناك استخدام كبير لأي موارد، مثل وحدة المعالجة المركزية(CPU) أو الذاكرة أو التحميل. يمكنك استخدام الأمر top على أنظمة التشغيل التي تعمل بنظام التشغيل Unix للحصول على معلومات استخدام الموارد في عملية معالج الرسائل:

   top
   

2. إذا لم يكن معالِجات الرسائل يستخدمون موارد كثيرة، انتقِل إلى ضرورة جمع معلومات التشخيص.

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

   1. إذا كان أي من معالجي الرسائل يواجه استخدامًا مرتفعًا لوحدة المعالجة المركزية (CPU)، أنشئ ثلاث عمليات تفريغ سلاسل محادثات كل 30 ثانية باستخدام الأمر التالي:

      sudo <JAVA_HOME>/bin/jstack -l <pid> > <filename>
      

   2. إذا تم استهلاك الذاكرة بشكل كبير مع أي من معالجي الرسائل، يمكنك إنشاء نَسْخ ذاكرة باستخدام الأمر التالي:

      sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=<filename> <pid>
      
      

   3. الانتقال إلى درجة الدقة.

الدقة

1. أعِد تشغيل معالج الرسائل باستخدام الأمر أدناه. من المفترض أن يؤدي هذا إلى خفض سرعة استخدام وحدة المعالجة المركزية (CPU) واستخدام الذاكرة:

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

2. راقِب طلبات بيانات من واجهة برمجة التطبيقات وتأكَّد من أنّ المشكلة لا تزال قائمة.

3. يمكنك التواصل مع فريق دعم Apigee Edge وتقديم بيانات عن حالات تفريغ سلاسل المحادثات ولقطات لأجزاء من الذاكرة وسجلّات معالج الرسائل (/opt/apigee/var/log/edge-message-processor/logs/system.log) للمساعدة في التحقيق في سبب ارتفاع معدّل استخدام وحدة المعالجة المركزية (CPU)/الذاكرة.

السبب: لم يتم نشر الخادم الوكيل لواجهة برمجة التطبيقات على معالِج بيانات واحد أو أكثر

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

التشخيص

1. سجِّل الدخول إلى كل معالج من معالِجات الرسائل وتحقَّق مما إذا تم نشر النسخة المحدَّدة من خادم وكيل واجهة برمجة التطبيقات باستخدام الأمر التالي:

   curl -v localhost:8082/v1/runtime/organizations/<orgname>/environments/<envname>/apis/<apiname>/revisions
   

   مثال على الناتج:

   ستظهر لك قائمة المراجعات كمخرج للأمر أعلاه. على سبيل المثال، إذا تم نشر المراجعة 12، فسترى الناتج على النحو التالي:

   [ "12" ]

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

3. كرر الخطوات من 1 إلى 2 لجميع معالِجات الرسائل.

4. إذا تم نشر المراجعة المحددة لخادم وكيل واجهة برمجة التطبيقات على كل معالِجات الرسائل، فليس هذا هو سبب هذه المشكلة. انتقِل إلى يجب جمع معلومات التشخيص.

الدقة

1. أعِد تشغيل معالِجات الرسائل المحدَّدة التي لم يتم نشر النسخة المحدَّدة من خادم وكيل واجهة برمجة التطبيقات عليها:

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

السبب: مشكلة في واجهة مستخدم Edge

التشخيص

1. تحقَّق من سجلّات واجهة مستخدم Edge /opt/apigee/var/log/edge-ui/application.log و/opt/apigee/var/log/edge-ui/edge-ui.log لمعرفة ما إذا كانت هناك أي أخطاء.
2. يُرجى التواصل مع فريق دعم Apigee Edge ومشاركة هذه الملفات لإجراء مزيد من التحقيق.

يجب جمع معلومات التشخيص

في حال استمرار المشكلة حتى بعد اتباع التعليمات أعلاه، يُرجى جمع معلومات التشخيص التالية. يمكنك التواصل معه ومشاركته مع Apigee Edge Support:

1. ناتج الأمر:

   curl -v <management-server-host>:8080/v1/runtime/organizations/<org-name>/environments/<env-name>/apis/<apiproxy-name>/revisions/<revision-number>/debugsessions -u <user>
   

2. سجل خادم الإدارة

   /opt/apigee/var/log/edge-management-server/logs/system.log.
   

3. سجلات معالج الرسائل

   /opt/apigee/var/log/edge-message-processor/logs/system.log.
   

4. ناتج أوامر telnet/nc من خادم الإدارة إلى معالج الرسائل:

   telnet <MessageProcessor_IP> 8082
   nc -vz <MessageProcessor_IP> 8082
   

5. ناتج الأمر netstat أدناه في معالج(معالجات) الرسائل:

   netstat -an > netstat.txt
   

6. إذا تبيّن أن هناك مشكلة في واجهة مستخدم Edge، يجب تقديم سجلّي واجهة مستخدم Edge /opt/apigee/var/log/edge-ui/application.log و/opt/apigee/var/log/edge-ui/edge-ui.log..

7. تفاصيل حول الأقسام التي تمت تجربتها في هذا الدليل وأيّ معلومات أخرى ستساعدنا في إيجاد حل سريع لهذه المشكلة