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

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

المشكلة

يتعذّر على المستخدم إنشاء جلسة تتبُّع في واجهة مستخدم 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:

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

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

السبب الوصف تعليمات تحديد المشاكل وحلّها التي تنطبق على
مشكلة في الاتصال بالشبكة تعذُّر الاتصال بين "خادم الإدارة" و"معالج الرسائل" بسبب مشاكل في الاتصال بالشبكة أو قواعد جدار الحماية مستخدمو Edge Private Cloud
لم يتم تحميل البيئة على "معالج الرسائل" لم يتم تحميل بيئة معيّنة (تحاول تفعيل التتبُّع فيها) على "معالِجات الرسائل" بسبب حدوث خطأ.
إدخالات معالج الرسائل القديمة يحتوي خادم الإدارة على مراجع إلى معالِجات رسائل غير موجودة (قديمة).
لا يمكن الوصول إلى معالج الرسائل تم إيقاف "معالج الرسائل" أو أصبح يتعذّر الوصول إليه.
مشكلة الاستخدام العالي للموارد تواجه "معالجات الرسائل" استخدامًا عاليًا للموارد (وحدة المعالجة المركزية أو الذاكرة أو الحمل).
لم يتم نشر خادم وكيل لواجهة برمجة التطبيقات على معالج رسائل واحد أو أكثر قد لا يتم نشر خادم وكيل لواجهة برمجة التطبيقات على معالج رسائل واحد أو أكثر بسبب عدم توفّر إشعار برصد حدث أثناء عملية النشر.
مشكلة في واجهة مستخدم Edge يتعذّر على واجهة مستخدم 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. قد تظهر لك رسالة خطأ مثل no valid responses from MP(s) أثناء إنشاء جلسة تتبُّع/تصحيح الأخطاء كما هو موضّح أدناه:

    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. لا يحتوي مستودع الشهادات الموثوقة عادةً على مفتاح. وفي هذه الحالة، من الأفضل أن يكون لديك شهادة واحدة ومفتاح واحد.

  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. تستهلك "معالجات الرسائل" مساحة كبيرة من الذاكرة أو وحدة المعالجة المركزية
  2. تحقَّق من سجلّات خادم الإدارة /opt/apigee/var/log/edge-management-server/logs/system.log لمعرفة ما إذا كانت هناك أي أخطاء أثناء إنشاء جلسة التتبُّع/تصحيح الأخطاء.
  3. قد تظهر لك رسالة خطأ مثل "الخادم <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
    
    

أعِد التحقّق مما إذا كان بإمكانك إنشاء جلسة التتبُّع. إذا استمرت المشكلة، انتقِل إلى Must Gather Diagnostic Information.

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

التشخيص

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

    top
    
  2. إذا لم تكن "معالجات الرسائل" تشهد استخدامًا عاليًا للموارد، انتقِل إلى معلومات التشخيص التي يجب جمعها.

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

    1. إذا كان أي من "معالجات الرسائل" يعاني من ارتفاع في استخدام وحدة المعالجة المركزية، يمكنك إنشاء ثلاث عمليات تفريغ للذاكرة كل 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. أعِد تشغيل "معالج الرسائل" باستخدام الأمر أدناه. من المفترض أن يؤدي ذلك إلى تقليل استخدام وحدة المعالجة المركزية والذاكرة:

    /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)) لمساعدته في التحقيق في سبب ارتفاع استخدام وحدة المعالجة المركزية/الذاكرة.

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

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

التشخيص

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

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

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

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

    [ "12" ]

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

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

  4. إذا تم نشر المراجعة المحدّدة لخادم وكيل واجهة برمجة التطبيقات على جميع "معالجات الرسائل"، لن يكون ذلك سببًا لهذه المشكلة. انتقِل إلى Must Gather Diagnostic Information.

الدقة

  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 ومشاركة هذه الملفات لإجراء المزيد من التحقيق.

Must Gather Diagnostic Information

إذا استمرت المشكلة حتى بعد اتّباع التعليمات أعلاه، يُرجى جمع معلومات التشخيص التالية. يُرجى التواصل مع فريق دعم Apigee 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. سجلّ خادم الإدارة

    /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. تفاصيل حول الأقسام التي تمّت تجربتها في "دليل التشغيل" هذا وأي إحصاءات أخرى ستساعدنا في تسريع حلّ هذه المشكلة