اكتشاف الأخطاء في Data Gateway وحلها

في وكيل Data Gateway، استخدم خيارات المستكشف لعرض الحالة والسجلات وصفحات الاستعلام لمراقبة حركة مرور الاتصال البعيد واستكشاف الأخطاء العامة وحلها ومشاكل الاتصال.

الموضوعات

انقر على المستكشف للوصول إلى صفحات Data Gateway.

فيما يلي وصف GUID-12258C9F-20C9-4812-AED5-9A886A025BFE-default.png
.png

تشخيص مشكلات الاتصال باستخدام صفحة الحالة

استخدم هذه الصفحة لمراجعة طلبات قاعدة البيانات التي يقوم بها وكيل Data Gateway بقاعدة البيانات البعيدة.

في وكيل Data Gateway، ننقر على المستكشف ثم الحالة لمراجعة طلبات قاعدة البيانات.

لتشخيص المشكلات، عادةً ما تبحث بحالة وظيفة أو تاريخ:
  • للبحث بتاريخ، في حقل البحث عن طلب، أدخل التاريخ والوقت كله أو جزءًا منه بالتنسيق "س س س س-ش ش-ي ي س س-د د-ث ث". على سبيل المثال، أدخل "2022-03-28" للبحث عن الإدخالات بتاريخ 28 مارس 2022.
  • للبحث عن الوظائف الفاشلة، في حقل البحث عن طلب، أدخل "REQUEST FINISHED WITH ERRORS" (الطلبات المنتهية بأخطاء).

امسح حقل طلب البحث لمراجعة كل الوظائف.
فيما يلي وصف GUID-0476B3A6-F490-44F2-B7D4-E1EDE0FD0B49-default.png
.png

انقر على وظيفة لعرض معلومات الحالة المفصلة.
فيما يلي وصف GUID-DDFD4D08-83CA-4134-A739-517DE4EBBC0B-default.png
.png

تشخيص مشكلات الاتصال باستخدام صفحة السجلات

استخدم هذه الصفحة لمراجعة الإدخالات في سجل وكيل Data Gateway بحيث تتمكن من تحليل حركة البيانات في الاتصال.

في وكيل Data Gateway، انقر على المستكشف ثم السجلات لمراجعة إدخالات السجل. قم بتمكين خيار تمكين التحقق من السجل واختر مستوى تسجيل ملائمًا. على سبيل المثال، لتشخيص مشكلات اتصال، قد يلزم تعيين نوع السجل إلى تصحيح.
فيما يلي وصف GUID-B3F74324-7D86-492D-AF32-DD13F152A57F-default.png
.png

توصي أوراكل بأنه فور إتمام استكشاف الأخطاء وإصلاحها، يلزم إما تعطيل خيار تمكين التحقق من السجل أو تعديلنوع السجل لتسجيل معلومات أقل.

تشخيص مشكلات الاتصال باستخدام صفحة الاستعلام

استخدم هذه الصفحة لاستعلام قاعدة بيانات بعيدة من وكيل Data Gateway لاختبار الاتصال وتقييم الأداء.

في وكيل Data Gateway، انقر على المستكشف ثم على الاستعلام لتنفيذ عبارة SQL مباشرة من وكيل Data Gateway إلى قاعدة البيانات (المحلية). على سبيل المثال، يمكنك نسخ سلسلة الاستعلام وسلسلة الاتصالوفئة برنامج التشغيل من وظيفة فشل تنفيذها مدرجة في صفحة الحالة. أدخل صلاحيات قاعدة البيانات وقم بتنفيذ الاستعلام لمراجعة إحصائيات الأداء والناتج (الوقت المستغرق). ملاحظة: قد تدعم قاعدة البيانات البعيدة الاتصال باستخدام سلسلة اتصال JDBC.
فيما يلي وصف GUID-D263ECAE-DE5F-4FC7-8A4E-D468B24E0A90-default.png
.png

نصائح ومشكلات الاتصال العامة

فيما يلي بعض مشكلات الاتصال التي قد تواجهها ونصائح حول كيفية حلها.

مشكلات التحليلات ولوحة المعلومات

المشكلة التي تم الإبلاغ عنها الإجراء المطلوب
رمز الخطأ 603 - لا يوجد وكلاء متصلون

تأكد من أن وكيل Data Gateway يعمل وأنه تم تمكينه في صفحة تكوين Data Gateway. في Data Gateway على Linux: قم بتشغيل الأمر $ <Data Gateway Install Directory>/domain/bin/status.sh واعرف إذا كانت "حالة Data Gateway" هي UP (يعمل) أو DOWN (معطل). في Data Gateway على Windows: تحقق من مدير المهام > علامة تبويب التفاصيل وابحث عن عملية "datagateway.exe".
[nQSError: 77031] يحدث الخطأ عند استدعاء الخدمة البعيدة DatasourceService. التفاصيل: [JDSError : 78] خطأ عنوان URL بتكوين خاطئ مراجعة مجمع الاتصالات في النموذج الدلالي وتحقق من الإعدادات في علامتي تبويب عام ومتنوع.

مشكلات مجموعات البيانات أو الاتصالات

المشكلة التي تم الإبلاغ عنها الإجراء المطلوب
رمز الخطأ 603 - لا يوجد وكلاء متصلون تأكد من أن وكيل Data Gateway يعمل. في Data Gateway على Linux: قم بتشغيل الأمر $ <Data Gateway Install Directory>/domain/bin/status.sh واعرف إذا كانت "حالة Data Gateway" هي UP (يعمل) أو DOWN (معطل). بالنسبة لوكلاء Data Gateway على Windows، تحقق من علامة تبويب التفاصيل في مدير المهام بحثًا عن عمليات "datagateway.exe".
فشل حفظ الاتصال. تم تقديم بيانات اتصال غير صالحة. الرجاء إدخال التفاصيل الصالحة وإعادة المحاولة. يظهر هذا الخطأ في مربع حوار "الاتصال" عند تكوين اتصال بـ DB2 أو SQL Server.

في صفحة الحالة الخاصة بالوكيل، سوف ترى كذلك "REQUEST FINISHED WITH ERRORS", وإذا قمت بالنقر على الطلبات فسوف ترى "[JDSError : 110] JDS - Invalid connect string / URL to external source, Cause: Invalid Oracle URL specified".

الحل البديل:

  1. تحرير ملف <Data Gateway Install Directory>/oracle_common/jdk1.8.0_333/jre/lib/security/java.security.
  2. حدد موقع هذا النص (حول السطر رقم 720):

    jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, \

  3. تغييره إلى:

    jdk.tls.disabledAlgorithms=SSLv3, TLSv1, RC4, DES, MD5withRSA, \

  4. أعد تشغيل الوكيل باستخدام <Data Gateway Install Directory>/domain/bin/stopJetty.sh متبوعًا بـ <Data Gateway Install Directory>/domain/bin/startJetty.sh.
JDSError : 110  - سلسلة اتصال غير صالحة/عنوان URL لمصدر خارجي تأكد من أن وكيل Data Gateway يمكنه الاتصال بمصدر بيانات. على سبيل المثال، إذا كنت تتصل بقاعدة بيانات أوراكل فقم بالاتصال باستخدام "telnet <hostname> <port>" على الجهاز حيث تم تثبيت Data Gateway.
لا توجد أعمدة معروضة ترقية وكيل Gateway agent. تحدث هذه المشكلة عادة إذا كنت تستخدم تحديث وكيل Data Gateway لا يطابق تحديث Oracle Analytics Cloud الخاص بك.
خيار استخدام اتصال البيانات عن بُعد مفقود

تحقق من أنه تم تمكين خيار تمكين Data Gateway في صفحة اتصال البيانات عن بُعد في وحدة التحكم.

المشكلات العامة

المشكلة التي تم الإبلاغ عنها الإجراء المطلوب
فشل تغيير حالة العميل مع ظهور خطأ: لم يتم تحديد اسم العميل أو عنوان URL لـ Oracle Analytics Cloud أو لم يتم إنشاء الاقتران الرئيسي انقر على حفظ، ثم تمكين. إذا استمرت المشكلة في الظهور، فابدأ التطبيق مجددًا. إذا لزم الأمر، فتحقق من شبكتك.
فشلت المصادقة بالخطأ: يتم إرجاع 401" عند الاختبار. والأسباب الممكنة هي:

- لم يتم نسخ مفتاح وكيل Data Gateway إلى صفحة اتصال البيانات عن بُعد في وحدة تحكم Oracle Analytics Cloud. على سبيل المثال، ربما نقرت على زر الاختبار قبل لصق المفتاح في OAC > وحدة التحكم > صفحة اتصال البيانات عن بُعد.

- تمت إعادة تكوين وكيل Data Gateway، لكن لم يتم لصق المفتاح الجديد في صفحة اتصال البيانات عن بُعد في وحدة تحكم Oracle Analytics Cloud. على سبيل المثال، ربما سجلت وكيل Data Gateway في صفحة اتصال البيانات عن بُعد في وحدة التحكم لكن معرفه لا يطابق "المعرف" في الصفحة الرئيسية لوكيل Data Gateway.


فيما يلي وصف GUID-993A05E7-934B-4EFE-A233-29A85B823B8C-default.png
.png

إذا لم يتم نسخ مفتاح وكيل Data Gateway، فالصق المفتاح في وحدة التحكم لتسجيل الوكيل.

إذا تمت إعادة تكوين مفتاح وكيل Data Gateway، فاحذف وكيل Data Gateway في وحدة التحكم، ثم الصق المفتاح في وحدة التحكم لإعادة تسجيل الوكيل.
فشلت المصادقة بالخطأ: تم إرجاع 404" عند الحفظ.

عادة ما يحدث هذا عند تحديث مثيل Oracle Analytics.

اطلع على:

- إرشادات استخدام Data Gateway عن بُعد في البيئات التي تم تحديثها من Oracle Analytics Cloud 105.2 وأقل (معرف المستند 2574387.1)

- Oracle Analytics Cloud - الكلاسيكي: كيفية تمكين Data Gateway عن بُعد في مثيل Oracle Analytics Cloud-الكلاسيكي المدار من قبل العملاء وتم تحديثه من الإصدار 105.2 أو أقل (معرف المستند 2632064.1).
عنوان URL لـ OAC غير صالح /استثناء مضيف غير معروف أو لم يتم إرجاع أي خطأ/رسالة عند الاختبار.

والأسباب الممكنة هي:

- تم تحديد URL غير صالح في الصفحة الرئيسية لوكيل Data Gateway. على سبيل المثال، قد تكون أدخلت عنوان URL مثل https://oacinst-tenancy.analytics.ocp.oraclecloud.com/dv/ui أو https://oacinst-tenancy.analytics.ocp.oraclecloud.com/analytics

- لا يوجد طريق شبكة مناسب من وكيل Data Gateway إلى مثيل Oracle Analytics Cloud. على سبيل المثال، قد يكون لديك خادم وكيل للوصول إلى الإنترنت وجدار حماية يمنعان الوصول من وكيل Data Gateway إلى Oracle Analytics Cloud. إذا لم يكن خادم الوكيل مطلوبًا، فقم بتأكيد الاتصال من الجهاز حيث يعمل Data Gateway مع Oracle Analytics Cloud.

تم تحديد عنوان URL في الصفحة الرئيسية لوكيل Data Gateway، قم بتحديث عنوان URL في حقل URL. على سبيل المثال، إذا كان عنوان URL لـ Oracle Analytics Cloud https://<instance details>.oraclecloud.com/dv/ui، فحدد عنوان URL: https://<instance details>.oraclecloud.com.

لا يوجد مسار شبكة مناسب من وكيل Data Gateway إلى مثيل Oracle Analytics Cloud:

- في نظام Linux، أصدر الأمر $ sudo traceroute -T -p 443 https://<instance details>.oraclecloud.com

- في Windows، أصدر الأمر C:\> telnet https://<instance details>.oraclecloud.com 443.

إذا كان خادم وكيل مطلوبًا، فتحقق من تفاصيل الوكيل لأجل Data Gateway. يرجى الاطلاع على عنوان URL لـ Oracle Analytics Cloud غير صالح (يتعذر اتصال Data Gateway بـ Oracle Analytics Cloud).

عنوان URL لـ Oracle Analytics Cloud غير صالح (يتعذر اتصال Data Gateway بـ Oracle Analytics Cloud)
  • تحقق من تمكين Data Gateway وتكوينها في وحدة تحكم Oracle Analytics Cloud.
  • تأكد من أنك قادر على الوصول إلى عنوان URL لـ Oracle Analytics Cloud من البيئة التي يتم فيها تشغيل Data Gateway. على سبيل المثال، يمكنك في نظام التشغيل Linux استخدام أمر traceroute، مثل sudo traceroute -T -p 443 <اسم مجال مؤهل تمامًا لطبعة Oracle Analytics Cloud>.
  • تأكد من عدم وجود شيء آخر يمنع الاتصال من خلال جدار الحماية.
  • إذا كنت تستخدم بروكسي، فانتقل إلى الصفحة الرئيسية في وكيل Data Gateway، وتحقق من إعدادات البروكسي من أجل المضيف و المنفذ والمستخدم وكلمة السر.
الأداء بطيء راجع صفحة السجلات وابحث عن:
  • تاريخ
  • وظائف فاشلة
  • معرف وظيفة
  • 'REMOTE'

بمجرد العثور على إدخالات السجل، انقر على وظيفة واطلع على مربع حوار حالة الطلب للاطلاع على الوقت المستغرق بالمللي ثانية.

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

إذا فشل الاختبار، فقد لا تتم مصادقة وكيل Data Gateway لعدة أسباب تتضمن:

  • لم يتم نسخ مفتاح وكيل Data Gateway إلى صفحة اتصالية البيانات البعيدة في وحدة تحكم Oracle Analytics Cloud.
  • تمت إعادة تكوين وكيل Data Gateway، لكن لم يتم لصق المفتاح الجديد في صفحة اتصال البيانات عن بُعد في وحدة تحكم Oracle Analytics Cloud.
  • لا يوجد مسار شبكة مناسب من وكيل Data Gateway إلى Oracle Analytics Cloud.