تحديد أسباب المشاكل

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

تتيح لك لوحة بيانات التحقيق إمكانية عرض جداول محورية للمقاييس والسمات لكل زيارات واجهة برمجة التطبيقات ومقارنة النشاط الارتباطي بين المقاييس للتحقيق في المشاكل وتشخيصها بشكل أسرع. يمكنك الوصول إلى بيانات آخر 30 يومًا في لوحة البيانات.

حدد تحليل > مراقبة واجهة برمجة التطبيقات > التحقيق في واجهة مستخدم Edge لفتح لوحة بيانات "Investivate" (التحقيق). تحتوي لوحة المعلومات على جزأين رئيسيين:

• يتيح لك رمز الحالة التحقق من مقاييس رمز الحالة للخوادم الوكيلة لواجهة برمجة التطبيقات والخدمات المستهدفة.
• يتيح لك وقت الاستجابة التحقيق في مشاكل وقت الاستجابة للخوادم الوكيلة لواجهة برمجة التطبيقات والخدمات المستهدفة.

يمكنك أيضًا التحقيق في المشاكل الناتجة عن تنبيه معيّن في "التحقيق في لوحة البيانات". عند حدوث تنبيه، انقر على اسم التنبيه في صفحة سجلّ التنبيه لفتح التنبيه في لوحة بيانات التحقيق.

استخدام لوحة بيانات "التحقيق في المشكلة" لتشخيص مشكلة

على سبيل المثال، ستتلقى تنبيهًا يشير إلى أن معدل خطأ 5xx يتجاوز الحد المحدد. للتحقيق في هذه المشكلة، يمكنك تنفيذ المهام التالية في لوحة بيانات التحقيق:

1. ويمكنك عرض مصفوفة رمز الخطأ مقابل الوقت لعرض نشاط رمز الخطأ على مدار الساعة الماضية.
2. بدِّل إلى مصفوفة رمز الخطأ مقابل حالة HTTP لتحديد رموز حالة HTTP معينة مرتبطة برموز الأخطاء التي تمت زيادة أعدادها على مدار الساعة الماضية، كما هو محدد في الخطوة السابقة.
3. بدِّل إلى مصفوفة رمز الخطأ مقابل الخادم الوكيل لتحديد الخوادم الوكيلة لواجهة برمجة التطبيقات التي تؤدي إلى ظهور رموز الخطأ المحدَّدة في الخطوة السابقة.
4. انقر على مربع في المصفوفة مرتبط بخادم وكيل لواجهة برمجة التطبيقات به عدد كبير من رموز الأخطاء لعرض مزيد من التفاصيل وسجلات الوصول.
5. إعداد تنبيه وإنشاء تقرير مخصّص للحصول على مساعدة إضافية في تشخيص المشكلة.

6. علاوة على ذلك troubleshoot في خادم وكيل واجهة برمجة التطبيقات باستخدام أداة التتبع والأدوات الأخرى لتحديد حل للمشكلة.

استخدام لوحة بيانات رمز الحالة

تتيح لك لوحة بيانات رمز الحالة التحقيق في مقاييس رمز الحالة للخوادم الوكيلة لواجهة برمجة التطبيقات والخدمات المستهدفة في مؤسستك. يمكنك عرض مقاييس رمز الحالة لفترة ساعة واحدة أو أربع ساعات في أي وقت خلال آخر 30 يومًا.

استكشاف لوحة بيانات رمز الحالة

لعرض لوحة بيانات رمز الحالة، اختَر تحليل > مراقبة واجهة برمجة التطبيقات > التحقيق في واجهة مستخدم Edge. يتم عرض لوحة بيانات رمز الحالة تلقائيًا:

كما هو موضح في الشكل، تتيح لك لوحة التحكم "التحقيق" ما يلي:

• إعداد كل مصفوفة عن طريق ضبط المحور س والمحور ص لمقارنة النشاط الارتباطي بين المقاييس واكتساب مزيد من الإحصاءات.
• يمكنك سريعًا تحديد المقاييس التي تشهد أكبر قدر من الأحجام النسبية استنادًا إلى تظليل لون القطعة. كلما كانت القطعة أغمق، ارتفع الحجم النسبي.
• انقر على كتلة في المصفوفة لعرض تفاصيل المقياس.
• عليك فلترة البيانات استنادًا إلى ما يلي:
  • البيئة
  • المنطقة
  • الخادم الوكيل
  • رموز الحالة (بما في ذلك جميع الزيارات أو جميع الأخطاء أو 2xx أو 4xx أو 5xx)
  • التاريخ والوقت خلال آخر 30 يومًا
  • نافذة مدتها ساعة واحدة أو 4 ساعات

ويمكنك استخدام لوحة البيانات لتنفيذ المهام التالية بسرعة:

• سجلّات الوصول إلى لوحة تفاصيل المقياس
• يمكنك عرض السياق الحالي في الأخيرة أو المخطط الزمني أو لوحة البيانات بالنقر على > > أو >، على التوالي.
• أنشئ تقريرًا مخصّصًا وأضِف سمات أخرى بالنقر على .
• إنشاء تنبيه وإضافة شروط تنبيه إضافية وإعداد الإشعارات وإنشاء تقرير مخصّص استنادًا إلى التنبيه.

تهيئة مصفوفة رموز الحالة

عند اختيار لوحة بيانات رمز الحالة، تظهر المصفوفات التالية تلقائيًا:

• رمز الخطأ مقابل الوقت
• رمز الخطأ مقابل حالة HTTP
• مصدر الخطأ مقابل الخادم الوكيل لواجهة برمجة التطبيقات

اضبط كل مصفوفة لمقارنة أي مقياسين من المقاييس التالية عن طريق اختيار قيمة للقائمتين المنسدلة x- والمحور y:

• رمز الخطأ
• سياسة الأخطاء
• مصدر الخطأ
• رموز حالة HTTP
• الخادم الوكيل
• الوقت
• المنطقة
• الهدف (الخدمة المستهدفة أو سياسة ServiceCallout. إذا كان الهدف هو سياسة ServiceCallout، تكون القيمة المعروضة مسبوقة بـ sc://. مثلاً، sc://my.endpoint.net.)

عرض تفاصيل مقياس رمز الحالة

يمكنك عرض تفاصيل مقياس معين بالنقر على كتلته في المصفوفة.

يتم عرض التفاصيل المتعلقة بالسبب المشتبه به في الجزء الأيسر، بما في ذلك:

• البيئة
• مؤسسة
• المنطقة
• مصدر الخطأ (الخادم الوكيل أو الهدف أو البنية الأساسية لـ Apigee)

يمكن أن تشمل التفاصيل أيضًا ما يلي:

• خطأ السياسة: معلومات عن السياسة التي تسببت في حدوث خطأ وقت التشغيل، بما في ذلك نوع السياسة (الاسم الداخلي) واسم السياسة التي يحدّدها المستخدم. يمكنك تحديد الاسم عند إرفاق السياسة بمسار الخادم الوكيل لواجهة برمجة التطبيقات.
• اسم الخادم الوكيل
• رمز حالة HTTP
• رمز الخطأ

وإذا كان عدد القيم الفريدة للسمة أكبر من واحد لمقياس معيّن، قد تتضمّن لوحة التفاصيل تفاصيل توزيع الخطأ، مثل "التوزيع حسب تطبيق المطوِّر" و"التوزيع حسب سياسة الخطأ" و"التوزيع حسب رمز الخطأ" و"التوزيع حسب حالة HTTP" وما إلى ذلك. مثال:

إذا كان مصدر الخطأ مستهدفًا، ستتضمّن لوحة التفاصيل "معدل الخطأ حسب الاستهداف". مثال:

استخدام لوحة بيانات وقت الاستجابة

تعرض لوحة بيانات "وقت الاستجابة" معلومات وقت الاستجابة للخوادم الوكيلة لواجهة برمجة التطبيقات والخدمات المستهدفة في مؤسستك. يمكنك التحقق من مقاييس وقت الاستجابة لفترة تبلغ ساعة واحدة في أي وقت خلال آخر 30 يومًا.

استكشاف لوحة بيانات وقت الاستجابة

لعرض لوحة بيانات وقت الاستجابة، حدد تحليل > مراقبة واجهة برمجة التطبيقات > التحقيق في واجهة مستخدم Edge. يتم عرض لوحة بيانات رمز الحالة تلقائيًا. اختَر وقت الاستجابة في منطقة الفلتر لعرض لوحة بيانات وقت الاستجابة:

عند تحديد لوحة معلومات وقت الاستجابة، تظهر المصفوفات التالية افتراضيًا:

• الخادم الوكيل مقابل الوقت (أقصى وقت استجابة بالمللي ثانية)
• وقت الاستجابة للخادم الوكيل مقابل إجمالي وقت الاستجابة (الحد الأقصى لوقت الاستجابة بالمللي ثانية)
• وقت استجابة الخادم الوكيل في مقابل جميع الأهداف (الحد الأقصى لوقت الاستجابة بالمللي ثانية)

استخدِم المربّع المنسدل الخادم الوكيل لاختيار الاستهداف لعرض أوقات الاستجابة المستهدَفة.

بشكل افتراضي، تعرض لوحة بيانات "وقت الاستجابة" معلومات للخوادم الوكيلة العشرة ذات أعلى وقت استجابة إجمالي في P99 للساعة السابقة. ويمكنك بدلاً من ذلك استخدام المربّع المنسدل أهم 10 لاختيار خادم وكيل أو مجموعة معيَّنة.

تحتوي لوحة بيانات "وقت الاستجابة" على جميع ميزات لوحة بيانات "رمز الحالة"، مع الاختلافات التالية:

• ما عليك سوى ضبط النسبة المئوية لإجمالي وقت الاستجابة (p50 وp90 وp95 وp99).
• يمكنك اختيار فترة تبلغ ساعة واحدة فقط لمقاييس وقت الاستجابة.
• لا يمكنك اختيار أيّ في المنطقة في الفلاتر. يجب اختيار منطقة معيّنة لعرضها.

عرض تفاصيل مقياس وقت الاستجابة

يمكنك عرض تفاصيل مقياس معين بالنقر على كتلته في المصفوفة.

يتم عرض التفاصيل المتعلقة بوقت الاستجابة للخادم الوكيل (الخط الأزرق) والهدف (الخط الأرجواني) في الجزء الأيسر، بما في ذلك:

• إجمالي وقت الاستجابة (وقت استجابة الخادم الوكيل إلى جانب وقت الاستجابة المستهدف)
• وقت الاستجابة لكل هدف (وقت الاستجابة المستهدَف)
• التوزيع حسب حالة HTTP

مرِّر مؤشر الماوس فوق الرسم البياني لعرض معلومات مفصّلة:

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

الاطّلاع على السجلات من تفاصيل المقاييس

عند عرض تفاصيل المقياس لرموز الحالة أو وقت الاستجابة، انقر على عرض السجلات لعرض جميع السجلات للمقياس المُختار:

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

يمكنك أيضًا فلترة السجلات حسب:

• مصدر الزيارات
• نوع الخطأ
• الحد الأدنى لوقت الاستجابة

لا يمكنك تنزيل بيانات السجلات من مربع حوار سجلات حركة المرور. في المقابل، يمكنك إنشاء تقرير مخصّص أو تنزيل بيانات الإحصاءات إلى مستودع البيانات لديك، مثل Google Cloud Storage أو BigQuery، لإجراء تحليل البيانات بنفسك.

إنشاء تقرير مخصّص من لوحة بيانات "التحقيق"

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

للمزيد من المعلومات، يُرجى الاطّلاع على إنشاء تقارير مخصّصة.

لإنشاء تقرير مخصص:

1. انقر على كتلة في المصفوفة لعرض المزيد من التفاصيل.

   

2. في الجزء الأيسر، انقر على .

   

   يتمّ عرض صفحة التقرير المخصّص في علامة تبويب جديدة تتضمّن حقولاً ذات صلة معبّأة مسبقًا.

   ملاحظة: راجع إنشاء تقارير مخصّصة لمزيد من المعلومات عن الإعدادات التلقائية للتقارير المخصّصة.

   

3. عدِّل التقرير المخصّص، على النحو المطلوب. الاطّلاع على إدارة التقارير المخصّصة

4. انقر على حفظ لحفظ التقرير المخصّص.

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

في صفحة "التقارير"، تتمّ تسمية التقارير المخصّصة التي يتم إنشاؤها باستخدام "مراقبة واجهة برمجة التطبيقات" باستخدام التنسيق التالي: API Monitoring Investigate Generated.

التحقيق في تنبيه محدّد

للتحقيق في تنبيه معيّن، اختَر اسم التنبيه في صفحة سجلّ التنبيهات. تظهر لوحة بيانات "التحقيق". وتجدر الإشارة إلى أنّ الصفحة تتضمّن رسمًا بيانيًا في أعلى لوحة البيانات، ولا تتضمّن سوى معلومات متعلّقة بالتنبيه:

• اطّلِع على تفاصيل عدد زيارات واجهة برمجة التطبيقات في وقت ظهور التنبيه.
• عرض المعلومات السياقية حول التنبيه، بما في ذلك الوقت الذي بدأ فيه التنبيه في منتصف الرسم البياني.
• انقر على تفاصيل الشرط لعرض تفاصيل حالة التنبيه في نافذة منبثقة.

• انقر على الدليل الإرشادي (إذا كان متاحًا) لعرض الدليل الإرشادي للتنبيه:

  

• انقر على إدارة التنبيه من أجل تعديل التنبيه.

• انقر على عرض التقرير (إذا كان متاحًا) لعرض تقرير مخصّص.

• فعِّل التحديث التلقائي للصفحة أو أوقِفه حسب الحاجة.